このページでは、 Google Cloud コンソールまたは Discovery Engine REST API を使用して、Gemini Enterprise データストアとその基盤となるエンティティのリソースの詳細を取得する方法について説明します。
API を使用してデータストアを操作する場合(リソースレベルの IAM アクセス制御の構成、検索エンドポイントのクエリ、取り込みパイプラインの自動化など)、ターゲット データストアとその基盤となるエンティティの一意のリソース ID が必要です。
データストアのコンセプト
Discovery Engine API でデータストア リソースがどのように構造化されているかを理解するには、次のコンセプトを考慮してください。
| コンセプト | 説明 |
|---|---|
| データストア |
Google またはサードパーティのデータソースから取り込まれたデータのコンテナ。スタンドアロン データストアは、デフォルトのコレクション(default_collection)に属します。詳細については、Gemini Enterprise のコンセプトとアプリとデータストアについてをご覧ください。 |
| データの収集 |
Google Cloud プロジェクトとロケーション(projects/{project}/locations/{location}/collections/{collection})内の論理グループ リソース。マルチエンティティのサードパーティ データストア(Jira、Salesforce、SharePoint Online など)は、データストア インスタンスを表す専用のコレクションを作成します。 |
| データストア エンティティ |
複数のエンティティ タイプ(Jira の課題、Jira プロジェクト、SharePoint ファイルなど)を含むサードパーティのデータソースを接続すると、Gemini Enterprise はエンティティ タイプごとに個別の子データストアを自動的に作成します。 これらのエンティティ データストアは、 詳細については、サードパーティ データストア用の構造化データとコネクタとデータストアの概要をご覧ください。 |
データストアとエンティティの詳細を取得する
次のオプションのいずれかを選択します。
コンソール
Google Cloud コンソールでデータストアとエンティティの詳細を取得する手順は次のとおりです。
Google Cloud コンソールで、[Gemini Enterprise] > [データストア] ページに移動します。
ターゲット データストアの名前をクリックします。
データストアの詳細ページで、ヘッダーに表示されているデータストア ID を確認します。
データストアにエンティティが含まれている場合は、[エンティティ] タブをクリックして、構成済みのエンティティ、表示名、対応するエンティティ データストア ID(
DataConnector3_entityA、DataConnector3_entityBなど)のリストを表示します。
REST
REST API を使用してデータストア ID とエンティティ ID を取得するには、次の操作を行います。
データストア コレクション ID を一覧表示する(マルチエンティティ データストアの場合):
複数のエンティティ(Jira や Salesforce など)を持つサードパーティのデータストアの場合、Gemini Enterprise はコネクタ インスタンスを表す専用のコレクションを作成します。
collectionsリスト エンドポイントを呼び出して、プロジェクトのコレクション ID を取得します。curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections"次のように置き換えます。
PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。ENDPOINT_LOCATION: API リクエストのマルチリージョン。次のいずれかの値を指定します。- 米国のマルチリージョンの場合は
us - EU のマルチリージョンの場合は
eu - グローバル ロケーションの場合は
global
- 米国のマルチリージョンの場合は
LOCATION: データストアのマルチリージョン(global、us、eu)。
レスポンスには、コレクションのリストが含まれます。
{ "collections": [ { "name": "projects/123456789/locations/global/collections/DataConnector3", "displayName": "Jira Production Data Store" } ] }この例では、コレクション ID は
DataConnector3です。この ID は、コネクタ インスタンスのコレクション レベルのアクセス制御を構成するときに使用します。default_collectionのエンティティとスタンドアロン データストア ID を一覧表示します。Gemini Enterprise では、スタンドアロン データストアやマルチエンティティ コネクタの子エンティティなど、すべてのデータストア リソースが
default_collectionにあります。マルチエンティティ データストアには専用のコレクション ID(DataConnector3など)がありますが、その子エンティティ データストアはdefault_collectionに登録され、コネクタ ID が接頭辞として付加されます。default_collectionのdataStoresリスト エンドポイントを呼び出して、データストア ID とエンティティ ID を確認します。curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/dataStores"次のように置き換えます。
PROJECT_ID: 実際のGoogle Cloud プロジェクト ID。ENDPOINT_LOCATION: API リクエストのマルチリージョン。次のいずれかの値を指定します。- 米国のマルチリージョンの場合は
us - EU のマルチリージョンの場合は
eu - グローバル ロケーションの場合は
global
- 米国のマルチリージョンの場合は
LOCATION: データストアのマルチリージョン(global、us、eu)。
レスポンスには、データストアのリストが含まれます。
{ "dataStores": [ { "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityA", "displayName": "Jira Issues Entity" }, { "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityB", "displayName": "Jira Projects Entity" } ] }この例では、エンティティ データストア ID は
DataConnector3_entityAとDataConnector3_entityBです。REST API を使用してマルチエンティティ データストアのすべての基盤となるエンティティ データストアのアクセス制御を構成する場合は、これらの ID を使用します。