マネージド ID を使用してAzure SQLへのインデクサー接続を設定する

Note

Azure AI 検索は、Azure ポータル、REST API、およびAzure SDKから使用できます。また、Foundry IQ は、エンタープライズコンテンツを、Microsoft Foundry ポータルのエージェントの再利用可能なアクセス許可に対応したナレッジベースに変換するマネージドナレッジレイヤーです。

この記事では、接続文字列で資格情報を指定するのではなく、マネージド ID を使用してAzure SQL Databaseへのインデクサー接続を設定する方法について説明します。

システム割り当てマネージド ID またはユーザー割り当てマネージド ID を使用できます。マネージド ID はログインMicrosoft Entraであり、Azure SQLのデータにアクセスするにはAzureロールの割り当てが必要です。

前提条件

検索サービスのマネージド ID を作成します。
Azure管理者ロールをSQLで割り当てる。インデクサー接続で使用される ID には、読み取りアクセス許可が必要です。データベースに対する読み取りアクセス許可を付与するには、SQL Database にサーバーを持つMicrosoft Entra管理者であるか、SQL Managed Instanceである必要があります。
インデクサーの概念と構成について理解している必要があります。

1 - データベースを読み取るアクセス許可を割り当てる

次の手順に従って、データベースを読み取る検索サービスまたはユーザー割り当てマネージド ID のアクセス許可を割り当てます。

Visual Studioに接続します。
Microsoft Entra アカウントで認証します。

次のコマンドを実行します。

検索サービス名またはユーザー割り当てマネージド ID 名の周りに角かっこを含めます。

CREATE USER [insert your search service name here or user-assigned managed identity name] FROM EXTERNAL PROVIDER;
EXEC sp_addrolemember 'db_datareader', [insert your search service name here or user-assigned managed identity name];

アクセス許可の割り当て後に検索サービス ID またはユーザー割り当て ID を後で変更する場合は、ロールメンバーシップを削除し、SQL データベース内のユーザーを削除してから、アクセス許可の割り当てを繰り返す必要があります。ロールのメンバーシップとユーザーを削除するには、次のコマンドを実行します。

sp_droprolemember 'db_datareader', [insert your search service name or user-assigned managed identity name];

DROP USER IF EXISTS [insert your search service name or user-assigned managed identity name];

2 - ロールの割り当てを追加する

このセクションでは、SQL Serverからデータを読み取るアクセス許可を Azure AI 検索サービスに付与します。詳細な手順については、Azure ポータルを使用して Azure ロールを割り当てるを参照してください。

Azure ポータルで、Azure SQL Server ページに移動します。
[アクセス制御 (IAM)] を選択します。
[追加] > [ロールの割り当ての追加] の順に選択します。
[ ロール ] タブで、適切な 閲覧者 ロールを選択します。
[ メンバー ] タブで、[ マネージド ID] を選択し、[ メンバーの選択] を選択します。
Azure サブスクリプションを選択します。
システム割り当てマネージド ID を使用している場合は、[ システム割り当てマネージド ID] を選択し、検索サービスを検索して選択します。
それ以外の場合は、ユーザー割り当てマネージド ID を使用している場合は、[ ユーザー割り当てマネージド ID] を選択し、ユーザー割り当てマネージド ID の名前を検索して選択します。
[ 確認と割り当て ] タブで、[ 確認と割り当て ] を選択してロールを割り当てます。

3 - データソースを作成する

データソースを作成し、システム割り当てマネージド ID またはユーザー割り当てマネージド ID を指定します。

システムによって割り当てられたマネージド ID

REST API、Azure ポータル、およびAzure SDKはシステム割り当てマネージド ID をサポートします。

システム割り当てマネージド ID を使用して接続する場合、データソース定義の変更は "credentials" プロパティの形式のみです。初期カタログまたはデータベース名と、アカウントキーまたはパスワードを持たない ResourceId を指定します。 ResourceId には、Azure SQL Databaseのサブスクリプション ID、SQL Database のリソースグループ、および SQL データベースの名前を含める必要があります。

Create Data Source REST API とマネージド ID 接続文字列を使用して、ストレージアカウントからデータのインデックスを作成するデータソースを作成する方法の例を次に示します。マネージド ID 接続文字列形式は、REST API、.NET SDK、および Azure ポータルで同じです。

POST https://[service name].search.windows.net/datasources?api-version=2026-04-01
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sql-datasource",
    "type" : "azuresql",
    "credentials" : { 
        "connectionString" : "Database=[SQL database name];ResourceId=/subscriptions/[subscription ID]/resourceGroups/[resource group name]/providers/Microsoft.Sql/servers/[SQL Server name];Connection Timeout=30;"
    },
    "container" : { 
        "name" : "my-table" 
    }
}

ユーザー割り当てマネージド ID

REST API バージョン 2026-04-01 以降では、ユーザー割り当てマネージド ID に基づく接続がサポートされています。ユーザー割り当てマネージド ID を使用して接続する場合、データソース定義には次の 2 つの変更があります。

まず、"credentials" プロパティの形式は、初期カタログ名またはデータベース名と、アカウントキーまたはパスワードを持たない ResourceId です。 ResourceId には、Azure SQL Databaseのサブスクリプション ID、SQL Database のリソースグループ、および SQL データベースの名前を含める必要があります。これは、システム割り当てマネージド ID と同じ形式です。
次に、ユーザー割り当てマネージド ID のコレクションを含む "identity" プロパティを追加します。データソースの作成時に指定する必要があるユーザー割り当てマネージド ID は 1 つだけです。 "userAssignedIdentities" と入力するように設定します。

データソース - 作成または更新を使用してインデクサーデータソースオブジェクトを作成する方法の例を次に示します。

POST https://[service name].search.windows.net/datasources?api-version=2026-04-01
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sql-datasource",
    "type" : "azuresql",
    "credentials" : { 
        "connectionString" : "Database=[SQL database name];ResourceId=/subscriptions/[subscription ID]/resourceGroups/[resource group name]/providers/Microsoft.Sql/servers/[SQL Server name];Connection Timeout=30;"
    },
    "container" : { 
        "name" : "my-table" 
    },
    "identity" : { 
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity" : "/subscriptions/[subscription ID]/resourcegroups/[resource group name]/providers/Microsoft.ManagedIdentity/userAssignedIdentities/[managed identity name]"
    }
}

4 - インデックスを作成する

インデックスは、検索エクスペリエンスを形成するドキュメント、属性、およびその他のコンストラクト内のフィールドを指定します。

検索可能なフィールドを使用した booktitle REST API 呼び出しを次に示します。

POST https://[service name].search.windows.net/indexes?api-version=2026-04-01
Content-Type: application/json
api-key: [admin key]

{
    "name" : "my-target-index",
    "fields": [
        { "name": "id", "type": "Edm.String", "key": true, "searchable": false },
        { "name": "booktitle", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false }
    ]
}

5 - インデクサーを作成する

インデクサーは、データソースをターゲット検索インデックスに接続し、データ更新を自動化するスケジュールを提供します。インデックスとデータソースが作成されたら、インデクサーを作成する準備ができました。インデクサーが成功した場合、接続構文とロールの割り当ては有効です。

Azure SQL インデクサー定義を使用した Create Indexer REST API 呼び出しを次に示します。インデクサーは、要求を送信するときに実行されます。

POST https://[service name].search.windows.net/indexers?api-version=2026-04-01
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sql-indexer",
    "dataSourceName" : "sql-datasource",
    "targetIndexName" : "my-target-index"
}

インデクサーが、クライアントがサーバーへのアクセスを許可されていないことを示すデータソースに接続しようとしたときにエラーが発生する場合は、一般的なインデクサーエラーを確認してください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-05-12