クイックスタート: 検索サービスに接続する

2025-10-01

このクイックスタートでは、ロールベースのアクセス制御 (RBAC) と Microsoft Entra ID を使用して、Azure AI Search サービスへのキーレス接続を確立します。その後、Visual Studio Code で Python を使用してサービスを操作します。

キーレス接続では、詳細なアクセス許可と ID ベースの認証によってセキュリティが強化されます。ハードコーディングされた API キーはお勧めしませんが、必要に応じて、キーを使用した Azure AI Search への接続に関するページを参照してください。

前提条件

アクティブなサブスクリプションを持つ Azure アカウント。無料でアカウントを作成できます。
任意のリージョンまたはレベルの Azure AI Search サービス。
Microsoft Entra ID を使用したキーレス認証用の Azure CLI 。
Python 拡張機能と Jupyter パッケージを含む Visual Studio Code。

ロールベースのアクセスを構成する

このセクションでは、Azure AI Search サービスで RBAC を有効にし、検索オブジェクトの作成、読み込み、クエリに必要なロールを割り当てます。これらの手順の詳細については、「ロールを使用して Azure AI Search に接続する」を参照してください。

アクセスを構成するには:

Azure portal にサインインし、検索サービスを選択します。
左側のウィンドウで、[ 設定] > キーを選択します。
クライアントを RBAC に移行する時間が必要な場合は、[ ロールベースのアクセス制御 ] または [両方 ] を選択します。
左側のウィンドウで、[ アクセス制御 (IAM)] を選択します。
[追加>][ロール割り当ての追加] の順に選択します。
Search Service 共同作成者ロールをユーザーアカウントまたはマネージド ID に割り当てます。
検索インデックスデータ共同作成者のロールの割り当てを繰り返します。

サービス情報を取得する

このセクションでは、Azure AI Search サービスのサブスクリプション ID とエンドポイントを取得します。サブスクリプションが 1 つしかない場合は、サブスクリプション ID をスキップし、エンドポイントのみを取得します。これらの値は、このクイックスタートの残りのセクションで使用します。

サービス情報を取得するには:

Azure portal にサインインし、検索サービスを選択します。
左側のウィンドウで、[ 概要] を選択します。
サブスクリプション ID とエンドポイントを書き留めます。

Azure AI Search サービスに接続する前に、Azure CLI を使用して、サービスを含むサブスクリプションにサインインします。この手順では、次のセクションで要求を認証するために DefaultAzureCredential が使用する Microsoft Entra ID を確立します。

サインインするには、次の手順を行います。

ローカルシステムで、コマンドラインツールを開きます。
ローカル環境でアクティブなテナントとサブスクリプションを確認します。
```
az account show
```
アクティブなサブスクリプションとテナントが検索サービスに対して有効でない場合は、変数を変更します。サブスクリプション ID は、Azure portal の検索サービスの概要ページで確認できます。サブスクリプションをクリックしてテナント ID を確認できます。 Azure portal では、テナント ID は 親管理グループと呼ばれます。検索サービスに有効な値をメモし、次のコマンドを実行してローカル環境を更新します。
```
 az account set --subscription <your-subscription-id>

 az login --tenant <your-tenant-id>
```

Azure AI Search に接続する

注

このセクションでは、キーレス接続の基本的な Python パターンを示します。包括的なガイダンスについては、「クイックスタート: Azure AI 検索でエージェント取得を使用する」などの特定のクイックスタートまたはチュートリアルを参照してください。

Visual Studio Code で Python ノートブックを使用して、Azure AI Search サービスに要求を送信できます。要求認証の場合は、Azure ID ライブラリの DefaultAzureCredential クラスを使用します。

Python を使用して接続するには:

ローカルシステムで、Visual Studio Code を開きます。
.ipynb ファイルを作成します。
azure-identityライブラリとazure-search-documents ライブラリをインストールするコードセルを作成します。
```
pip install azure-identity azure-search-documents
```

認証して検索サービスに接続する別のコードセルを作成します。

from azure.identity import DefaultAzureCredential
from azure.search.documents.indexes import SearchIndexClient

service_endpoint = "PUT-YOUR-SEARCH-SERVICE-ENDPOINT-HERE"
credential = DefaultAzureCredential()
client = SearchIndexClient(endpoint=service_endpoint, credential=credential)

# List existing indexes
indexes = client.list_indexes()

for index in indexes:
   index_dict = index.as_dict()
   print(json.dumps(index_dict, indent=2))

service_endpointに、サービス情報の取得で取得した値を設定します。
[ すべて実行] を選択して、両方のコードセルを実行します。

出力には、検索サービス上の既存のインデックス (存在する場合) が一覧表示され、接続が成功したことが示されます。

401 エラーをトラブルシューティングする

401 エラーが発生した場合は、次のトラブルシューティング手順に従います。

「ロールベースのアクセスを構成する」を再検討します。検索サービスでは 、ロールベースのアクセス制御 または両方が有効になっている必要があります。サブスクリプションまたはリソースグループレベルのポリシーによって、ロールの割り当てがオーバーライドされる場合もあります。
Azureにサインインを再訪問する。検索サービスを含むサブスクリプションにサインインする必要があります。
エンドポイント変数に囲まれた引用符があることを確認します。
他のすべてが失敗した場合は、デバイスを再起動してキャッシュされたトークンを削除し、このクイックスタートの手順を繰り返します。その後、 Azure へのサインインから始めます。

このクイックスタートでは、ロールベースのアクセス制御 (RBAC) と Microsoft Entra ID を使用して、Azure AI Search サービスへのキーレス接続を確立します。その後、Visual Studio Code で REST を使用してサービスを操作します。

前提条件

アクティブなサブスクリプションを持つ Azure アカウント。無料でアカウントを作成できます。
任意のリージョンまたはレベルの Azure AI Search サービス。
Microsoft Entra ID を使用したキーレス認証用の Azure CLI 。
Visual Studio Code と REST クライアント拡張機能。

ロールベースのアクセスを構成する

アクセスを構成するには:

Azure portal にサインインし、検索サービスを選択します。
左側のウィンドウで、[ 設定] > キーを選択します。
クライアントを RBAC に移行する時間が必要な場合は、[ ロールベースのアクセス制御 ] または [両方 ] を選択します。
左側のウィンドウで、[ アクセス制御 (IAM)] を選択します。
[追加>][ロール割り当ての追加] の順に選択します。
Search Service 共同作成者ロールをユーザーアカウントまたはマネージド ID に割り当てます。
検索インデックスデータ共同作成者のロールの割り当てを繰り返します。

サービス情報を取得する

サービス情報を取得するには:

Azure portal にサインインし、検索サービスを選択します。
左側のウィンドウで、[ 概要] を選択します。
サブスクリプション ID とエンドポイントを書き留めます。

Azure AI Search サービスに接続する前に、Azure CLI を使用して、サービスを含むサブスクリプションにサインインします。

ローカル環境でアクティブなテナントとサブスクリプションを確認します。
```
az account show
```
アクティブなサブスクリプションとテナントが検索サービスに対して有効でない場合は、変数を変更します。サブスクリプション ID は、Azure portal の検索サービスの概要ページで確認できます。サブスクリプションをクリックしてテナント ID を確認できます。 Azure portal では、テナント ID は 親管理グループと呼ばれます。検索サービスに有効な値をメモし、次のコマンドを実行してローカル環境を更新します。
```
 az account set --subscription <your-subscription-id>

 az login --tenant <your-tenant-id>
```

トークンを取得する

REST API 呼び出しには、Microsoft Entra ID トークンを含める必要があります。このトークンを使用して、次のセクションで要求を認証します。

トークンを取得するには:

ローカルシステムで、コマンドラインツールを開きます。

アクセストークンを生成します。

az account get-access-token --scope https://search.azure.com/.default --query accessToken --output tsv

トークン出力をコピーします。

Azure AI Search に接続する

注

このセクションでは、キーレス接続の基本的な REST パターンを示します。包括的なガイダンスについては、「クイックスタート: Azure AI 検索でエージェント取得を使用する」などの特定のクイックスタートまたはチュートリアルを参照してください。

Visual Studio Code の REST クライアント拡張機能を使用して、Azure AI Search サービスに要求を送信できます。要求認証の場合は、前に生成した Microsoft Entra ID トークンを含む Authorization ヘッダーを含めます。

REST を使用して接続するには:

ローカルシステムで、Visual Studio Code を開きます。
.restまたは.http ファイルを作成します。

次のプレースホルダーと要求をファイルに貼り付けます。

@baseUrl = PUT-YOUR-SEARCH-SERVICE-ENDPOINT-HERE
@token = PUT-YOUR-PERSONAL-IDENTITY-TOKEN-HERE

### List existing indexes
GET {{baseUrl}}/indexes?api-version=2025-09-01  HTTP/1.1
   Content-Type: application/json
   Authorization: Bearer {{token}}

@baseUrlを、「サービス情報の取得」で取得した値に置き換えます。
@tokenを Get トークンで取得した値に置き換えます。
[ ### List existing indexesで、[ 要求の送信] を選択します。

検索サービスへの接続が成功したことを示す HTTP/1.1 200 OK 応答を受け取る必要があります。

401 エラーをトラブルシューティングする

401 エラーが発生した場合は、次のトラブルシューティング手順に従います。

「ロールベースのアクセスを構成する」を再検討します。検索サービスでは 、ロールベースのアクセス制御 または両方が有効になっている必要があります。サブスクリプションまたはリソースグループレベルのポリシーによって、ロールの割り当てがオーバーライドされる場合もあります。
トークンを再取得します。検索サービスを含むサブスクリプションにサインインする必要があります。
エンドポイント変数とトークン変数に周囲の引用符や余分なスペースがないことを確認します。
トークンに要求ヘッダーに @ 記号が含まれていないことを確認します。たとえば、変数が @tokenされている場合、要求内の参照は {{token}}する必要があります。
それ以外のすべてが失敗した場合は、デバイスを再起動してキャッシュされたトークンを削除し、このクイックスタートの手順を繰り返します(トークンの取得から始めます)。

フィードバック

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

次の方法で共有

クイック スタート: 検索サービスに接続する

前提条件

ロールベースのアクセスを構成する

サービス情報を取得する

Azure にサインインする

Azure AI Search に接続する

401 エラーをトラブルシューティングする

前提条件

ロールベースのアクセスを構成する

サービス情報を取得する

Azure にサインインする

トークンを取得する

Azure AI Search に接続する

401 エラーをトラブルシューティングする

関連コンテンツ

フィードバック

その他のリソース

クイックスタート: 検索サービスに接続する