> ## 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.

# Azure Data Catalog

export const title_2 = "Azure Data Catalog";

export const title_1 = "Azure Data Catalog";

export const title_0 = "Azure Data Catalog";

## 前提条件

**AzureServicePrincipal** および **AzureServicePrincipalCert** 認証方式には、Microsoft Entra ID（旧 Azure AD）に登録されたカスタム OAuth アプリケーションが必要です。**AzureAD** 方式で接続する場合は、本セクションをスキップできます。

Entra ID でカスタム OAuth アプリケーションを作成・登録するには、以下の手順に従います：

<Steps>
  <Step>
    Azure ポータルにサインインし、**Microsoft Entra ID > App registrations** に移動して **New registration** をクリックします。
  </Step>

  <Step>
    アプリケーションの **Name** を入力します。
  </Step>

  <Step>
    サポートされるアカウントタイプで **Any Microsoft Entra ID tenant - Multitenant** を選択し、**Register** をクリックします。
  </Step>

  <Step>
    アプリケーションの概要ページで、**Application (client) ID** と **Directory (tenant) ID** を記録します。以下のセットアップ手順で、これらの値を **OAuth Client Id** と **Azure Tenant** として入力します。
  </Step>

  <Step>
    **Certificates & Secrets** を開き、選択した方式に応じて認証情報を追加します：

    * **AzureServicePrincipal** 方式の場合、**New client secret** を選択し、有効期間を指定して **Add** をクリックします。シークレット値を記録します（1 回しか表示されません）。**OAuth Client Secret** としてこの値を入力します。
    * **AzureServicePrincipalCert** 方式の場合、**Upload certificate** を選択してクライアント証明書をアップロードします。
  </Step>

  <Step>
    **Authentication** タブを開き、**Access tokens** オプションを有効にします。
  </Step>

  <Step>
    **API permissions** を開き、**Azure Data Catalog > Delegated permissions > user\_impersonation** を追加します。変更を保存し、組織で必要な場合は管理者の同意を付与します。
  </Step>
</Steps>

## セットアップガイド

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

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

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

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

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

  <Step>
    （オプション）接続するカタログの **Catalog Name** を入力します。デフォルトは *defaultcatalog* です。
  </Step>

  <Step>
    **Auth Scheme** を選択し、以下の該当する手順に従います。
  </Step>
</Steps>

## 認証方法

<Tabs>
  <Tab title="AzureAD">
    <Steps>
      <Step>
        データへのアクセスに使用する Azure Data Catalog テナントである **Azure Tenant** を入力します。テナントのドメイン名（例：contoso.onmicrosoft.com）またはディレクトリ（テナント）ID を受け付けます。
      </Step>

      <Step>
        OAuth でセキュアに接続するには、**Sign in** をクリックします。これにより、Azure Data Catalog のサインインページが新しいタブで開かれます。
      </Step>

      <Step>
        Azure Data Catalog アカウントにサインインし、リクエストされた権限を設定します（該当する場合）。
      </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="AzureServicePrincipal">
    <Steps>
      <Step>
        データへのアクセスに使用する Azure Data Catalog テナントである **Azure Tenant** を入力します。テナントのドメイン名（例：contoso.onmicrosoft.com）またはディレクトリ（テナント）ID を受け付けます。
      </Step>

      <Step>
        **Callback URL**（リダイレクト URL）は、OAuth アプリのセットアップ時に必要な URL（`https://oauth.cdata.com/oauth/`）です。この URL をコピーして OAuth アプリに貼り付けます。
      </Step>

      <Step>
        カスタム OAuth アプリケーションを登録した際に割り当てられた **OAuth Client Id**（コンシューマーキーとも呼ばれます）を入力します。
      </Step>

      <Step>
        カスタム OAuth アプリケーションを登録した際に割り当てられた **OAuth Client Secret** を入力します。
      </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="AzureServicePrincipalCert">
    <Steps>
      <Step>
        クライアント証明書の JWT 証明書ストアの名前である **OAuth JWT Cert** を入力します。これは、表示されている形式の複数行にわたるキーです。
      </Step>

      <Step>
        JWT 証明書を含むキーストアの種類である **OAuth JWT Cert Type** を選択します。デフォルトは *PEMKEY\_BLOB* です。
      </Step>

      <Step>
        （オプション）証明書ストアにパスワードが必要な場合は、**OAuth JWT Cert Password** を入力します。
      </Step>

      <Step>
        （オプション）**OAuth JWT Cert Subject** を入力します。これは OAuth JWT 証明書のサブジェクトです。部分一致と、最初の証明書を選択するワイルドカード '\*' をサポートします。省略した場合、証明書ストアの最初の証明書が使用されます。
      </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 と Azure Data Catalog の連携の詳細動作については、[こちらのページ](https://cdn.cdata.com/help/GNM/jp/cloud/default.htm#default)を参照してください。