Spanner に接続する

このドキュメントでは、Spanner データに接続するデータストアを作成する方法について説明します。このデータストアを Gemini Enterprise app にリンクして、エージェントがデータを分析できるようにします。

Gemini Enterprise データストアを使用して Spanner データに接続するには、次のいずれかのモードを使用します。

  • 連携クエリ（推奨） [プレビュー]: データのコピーと移動の費用を発生させることなく、Spanner データにインプレースで接続します。連携クエリは、ID に Identity and Access Management（IAM）のアクセス権限があるすべてのデータベースとテーブルに対してクエリを Spanner に直接送信します。これは分析クエリでより効率的です。連携クエリモードを使用すると、Gemini Enterprise アプリの [アシスタント] タブで Knowledge Catalog が自動的に有効になり、ユーザーがアクセスできるデータを検索してコンテキストを検索するエージェント ツールが提供されます。

  • データの取り込み: 特定の Spanner テーブルから Gemini Enterprise データストアにデータをコピーします。Spanner テーブルの変更を反映するには、データを手動で更新する必要があります。このモードでは、データを新しいロケーションに移動するための下り（外向き）料金が発生し、既存の IAM 権限はデータストアに複製されません。

始める前に

Gemini Enterprise で Spanner データストアを作成するには、Gemini Enterprise 管理者（roles/discoveryengine.agentspaceAdmin）ロールまたは ディスカバリー エンジン管理者（roles/discoveryengine.admin）ロールが必要です。詳細については、管理者に権限を付与するをご覧ください。

プロジェクトが VPC Service Controls 境界で保護されている場合、または組織のポリシーの適用が有効になっている場合は、組織のポリシーでコネクタが許可されていることを確認します。

また、使用する予定のコネクタモードに必要な Spanner IAM 権限を構成します。

連携クエリ

連携クエリ モードを使用して Spanner に接続するには、Spanner データベースを含むGoogle Cloud プロジェクト内のコネクタを介してクエリを実行するか、アクションを実行するユーザーに、次の IAM ロールを付与します。

データの取り込み

作成する Gemini Enterprise データストアを含む Google Cloud プロジェクトとは異なるソース Google Cloud プロジェクトからデータを取り込むには、ソース Spanner プロジェクトに対する次のいずれかの IAM ロールを service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com サービス アカウントに付与します（ここで、PROJECT_NUMBER は Gemini Enterprise データストアを含むGoogle Cloud プロジェクトのプロジェクト番号です）。

Spanner データストアを作成する

Spanner から Gemini Enterprise にデータを接続するデータストアを作成する手順は次のとおりです。

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

    Gemini Enterprise

  2. [データストア] ページに移動します。

  3. [データストアを作成] をクリックします。

  4. [ソース] ページで、データストアのデータソースを選択します。[データソースを選択] 検索フィールドで「Spanner」を検索するか、[ファーストパーティ データソース] のリストで Spanner を見つけます。[データソースを追加] を選択します。

  5. [データ] ページで、データへの接続方法のコネクタモードを選択します。選択したモードに基づいて、次のいずれかのタブを選択して手順を確認してください。

    連携クエリ

    1. [連携クエリ（推奨）] を選択します。[続行] をクリックします。
    2. [アクション] ページで、データストアで有効にする Spanner アクションを選択します。これらの設定は後で編集できます。[続行] をクリックします。

    データの取り込み

    1. [データの取り込み] を選択します。

    2. インポートするデータに関する詳細を指定します。[Spanner テーブルからデータをインポートする] で、次の情報を指定します。

      • プロジェクト ID: Spanner テーブルを含む Google Cloud プロジェクト。これは必須項目です。
      • インスタンス ID: インポートするデータを含む Spanner インスタンス ID。これは必須項目です。
      • データベース ID: インポートするデータを含む Spanner データベース ID。これは必須項目です。
      • テーブル ID: インポートするデータを含む Spanner テーブル ID。これは必須項目です。

      必要に応じて、[Data Boost を有効にする] を選択して、Spanner Data Boost を使用してクエリを高速化します。Data Boost を有効にすると、追加費用が発生します。Spanner Data Boost の課金と割り当てをご覧ください。

    3. [続行] をクリックします。

  6. [構成] ページで、データストアの設定を構成します。

    • データコネクタのロケーション: データストアのメタデータを保存するリージョンを選択します。データストアの作成後にロケーションを変更することはできません。マルチリージョンに関する重要な情報については、Gemini Enterprise のロケーションをご覧ください。
    • データコネクタ名: [データコネクタ名] フィールドに、データコネクタの名前を入力します。データコネクタの作成後に名前を変更することはできません。名前を入力すると、データコネクタの一意の ID が生成されます。必要に応じて、[タグ（省略可）] フィールドにデータコネクタのタグを入力します。これは、すべてのバージョンでコネクタの安定した識別子として機能します。
    • Sensitive Data Protection ポリシー: データストアの機密データの保護ポリシーを選択します。形式は projects/{project}/locations/{location}/contentPolicies/{policy} に従う必要があります。この設定は後で編集できます。

  7. [作成] をクリックします。

これで、データストアを Gemini Enterprise アプリに接続する準備が整いました。フェデレーション クエリモードでは、ユーザーが接続されたアプリを介してクエリを実行すると、クエリで Spanner の使用料金が発生します。データ取り込みモードでは、データストアがアプリに接続される前でも、データのインポートで Spanner と Gemini Enterprise のインデックス作成料金が発生します。これらの料金の詳細については、Gemini Enterprise の料金をご覧ください。

次のステップ