メインコンテンツへスキップ

前提条件

AzureServicePrincipal および AzureServicePrincipalCert 認証方式には、Microsoft Entra ID(旧 Azure AD)に登録されたカスタム OAuth アプリケーションが必要です。AzureAD 方式で接続する場合は、本セクションをスキップできます。 Entra ID でカスタム OAuth アプリケーションを作成・登録するには、以下の手順に従います:
1
Azure ポータルにサインインし、Microsoft Entra ID > App registrations に移動して New registration をクリックします。
2
アプリケーションの Name を入力します。
3
サポートされるアカウントタイプで Any Microsoft Entra ID tenant - Multitenant を選択し、Register をクリックします。
4
アプリケーションの概要ページで、Application (client) IDDirectory (tenant) ID を記録します。以下のセットアップ手順で、これらの値を OAuth Client IdAzure Tenant として入力します。
5
Certificates & Secrets を開き、選択した方式に応じて認証情報を追加します:
  • AzureServicePrincipal 方式の場合、New client secret を選択し、有効期間を指定して Add をクリックします。シークレット値を記録します(1 回しか表示されません)。OAuth Client Secret としてこの値を入力します。
  • AzureServicePrincipalCert 方式の場合、Upload certificate を選択してクライアント証明書をアップロードします。
6
Authentication タブを開き、Access tokens オプションを有効にします。
7
API permissions を開き、Azure Data Catalog > Delegated permissions > user_impersonation を追加します。変更を保存し、組織で必要な場合は管理者の同意を付与します。

セットアップガイド

以下の手順で、Azure Data Catalog を Connect AI アカウントに接続します:
1
Connect AI のナビゲーションメニューから Sources ページを開きます。
2
右上の + Add Connection をクリックします。
3
検索フィールドに Azure Data Catalog と入力し、データソース名をクリックします。
4
新しいコネクションの Basic Settings タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。
5
(オプション)接続するカタログの Catalog Name を入力します。デフォルトは defaultcatalog です。
6
Auth Scheme を選択し、以下の該当する手順に従います。

認証方法

1
データへのアクセスに使用する Azure Data Catalog テナントである Azure Tenant を入力します。テナントのドメイン名(例:contoso.onmicrosoft.com)またはディレクトリ(テナント)ID を受け付けます。
2
OAuth でセキュアに接続するには、Sign in をクリックします。これにより、Azure Data Catalog のサインインページが新しいタブで開かれます。
3
Azure Data Catalog アカウントにサインインし、リクエストされた権限を設定します(該当する場合)。
4
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
  • 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatusAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
  • 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
  • 失敗したコネクションは下書きとして保存され、StatusNot Authenticated になります。後でコネクションに戻って認証することができます。

詳細について

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