> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cosmos DB

export const title_2 = "Cosmos DB";

export const title_1 = "Cosmos DB";

export const title_0 = "Cosmos DB";

## セットアップガイド

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

<Steps>
  <Step>
    Connect AI のナビゲーションメニューから**Sources** ページを開きます。
  </Step>

  <Step>
    右上の **+ Add Connection** をクリックします。
  </Step>

  <Step>
    検索フィールドに *Cosmos DB* と入力し、データソース名をクリックします。
  </Step>

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

  <Step>
    Cosmos DB アカウントの URL **Account Endpoint** を入力します。この URL は Cosmos DB アカウントの **Keys** ブレードで確認できます。
  </Step>

  <Step>
    認証方式を選択し、該当するセクションに進んで手順に従います。
  </Step>
</Steps>

## 認証方式

<Tabs>
  <Tab title="AccountKey">
    <Steps>
      <Step>
        **Account Key** フィールドに、Cosmos DB REST API への接続に使用するマスターキートークンまたはリソーストークンを入力します。
      </Step>

      <Step>
        **Token Type** フィールドを使用して、**Account Key** フィールドに入力したトークンが **master** トークンか **resource** トークンかを指定します。
      </Step>

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

      <Step>
        Connect AI **Add {title_0} Connection** ページ上部の、**Save & Test** をクリックします。

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

  <Tab title="AzureAD">
    <Steps>
      <Step>
        Cosmos DB アカウントを OAuth に登録したときに割り当てられた **OAuth Client Id** を入力します。
      </Step>

      <Step>
        Cosmos DB アカウントの OAuth 用 **OAuth Client Secret** を入力します。
      </Step>

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

      <Step>
        Connect AI **Add {title_1} Connection** ページ上部の、**Save & Test** をクリックします。

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

  <Tab title="AzureServicePrincipal">
    <Steps>
      <Step>
        接続する **Azure Tenant** ID を入力します。
      </Step>

      <Step>
        アプリケーション設定にある **OAuth Client Id** を入力します。
      </Step>

      <Step>
        **OAuth Client Secret** を入力します。
      </Step>

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

      <Step>
        Connect AI **Add {title_2} Connection** ページ上部の、**Save & Test** をクリックします。

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

## 詳細について

Connect AI とCosmos DB の連携の詳細動作については、[こちらのページ](https://cdn.cdata.com/help/EHM/jp/cloud/default.htm#default)を参照してください。