前提条件
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) ID とDirectory (tenant) ID を記録します。以下のセットアップ手順で、これらの値をOAuth Client Id とAzure 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 を選択し、以下の該当する手順に従います。
認証方法
- AzureAD
- AzureServicePrincipal
- AzureServicePrincipalCert
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 Azure Data Catalog Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。