Cosmos DB

​

セットアップガイド

以下の手順で、Cosmos DB をConnect AI アカウントに接続します。

1. Connect AI のダッシュボードからConnections ページを開きます。

2. 右上の + Add Connection をクリックします。

3. 検索フィールドに Cosmos DB と入力し、データソース名をクリックします。

4. 新しいコネクションのBasic Settings タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。

5. Enter your Cosmos DB account URL Account Endpoint. You can find this URL under the Keys blade of the Cosmos DB account.

6. Select the Authentication method, then proceed to the relevant section and follow those instructions.

​

Authentication Methods

AccountKey

1. Enter the master key token or resource token for connecting to the Cosmos DB REST API in the Account Key field.

2. Use the Token Type field to specify whether the token you entered in the Account Key field is a master or resource token.

3. Cosmos DB で、Connect AI 静的IP アドレスを接続のホワイトリストに追加します。

4. Connect AI Connection ページ上部の、Save & Test をクリックします。

   • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
   • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
   • 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。

AzureAD

1. Enter the OAuth Client Id assigned when you registered your Cosmos DB account for OAuth.

2. Enter the OAuth Client Secret for your Cosmos DB account for OAuth.

3. Cosmos DB で、Connect AI 静的IP アドレスを接続のホワイトリストに追加します。

4. Connect AI Connection ページ上部の、Save & Test をクリックします。

   • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
   • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
   • 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。

AzureServicePrincipal

1. Enter the Azure Tenant Id to connect to.

2. Enter the OAuth Client Id found in your application settings.

3. Enter your OAuth Client Secret.

4. Cosmos DB で、Connect AI 静的IP アドレスを接続のホワイトリストに追加します。

5. Connect AI Connection ページ上部の、Save & Test をクリックします。

   • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
   • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
   • 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。

​

詳細について

Connect AI とCosmos DB の連携の詳細動作については、こちらのページを参照してください。