データストアとエンティティの詳細を取得する

このページでは、 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 はエンティティ タイプごとに個別の子データストアを自動的に作成します。

これらのエンティティ データストアは、collections/default_collection/dataStores/{DATA_STORE_ENTITY_ID} の子リソースとして存在します。

詳細については、サードパーティ データストア用の構造化データとコネクタとデータストアの概要をご覧ください。

データストアとエンティティの詳細を取得する

次のオプションのいずれかを選択します。

コンソール

Google Cloud コンソールでデータストアとエンティティの詳細を取得する手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] > [データストア] ページに移動します。

    [データストア] ページに移動

  2. ターゲット データストアの名前をクリックします。

  3. データストアの詳細ページで、ヘッダーに表示されているデータストア ID を確認します。

  4. データストアにエンティティが含まれている場合は、[エンティティ] タブをクリックして、構成済みのエンティティ、表示名、対応するエンティティ データストア ID(DataConnector3_entityA、DataConnector3_entityB など)のリストを表示します。

REST

REST API を使用してデータストア ID とエンティティ ID を取得するには、次の操作を行います。

  1. データストア コレクション 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 は、コネクタ インスタンスのコレクション レベルのアクセス制御を構成するときに使用します。

  2. 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 を使用します。

次のステップ