AlloyDB for PostgreSQL に接続する

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

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

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

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

始める前に

Gemini Enterprise で AlloyDB for PostgreSQL データストアを作成するには、Gemini Enterprise 管理者（roles/discoveryengine.agentspaceAdmin）または Discovery Engine 管理者（roles/discoveryengine.admin）のロールが必要です。詳細については、管理者に権限を付与するをご覧ください。

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

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

連携クエリ

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

データの取り込み

作成する Gemini Enterprise データストアを含む Google Cloud プロジェクトとは異なるソース Google Cloud プロジェクトからデータを取り込むには、ソース AlloyDB for PostgreSQL プロジェクトの Cloud AlloyDB 管理者（roles/alloydb.admin）ロールを service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com サービス アカウントに付与します（ここで、PROJECT_NUMBER は Gemini Enterprise データストアを含むGoogle Cloud プロジェクトのプロジェクト番号です）。

AlloyDB for PostgreSQL データストアを作成する

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

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

    Gemini Enterprise

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

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

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

  5. [データ] ページで、データへの接続方法のコネクタモードを選択します。選択したモードに応じて、次のタブから詳細な手順を選択します。

    連携クエリ

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

    データの取り込み

    1. [データの取り込み] を選択します。
    2. インポートするデータの詳細を指定します。[AlloyDB for PostgreSQL テーブルからデータをインポートする] で、次の情報を指定します。
      • プロジェクト ID: AlloyDB for PostgreSQL テーブルを含む Google Cloud プロジェクト。これは必須項目です。
      • 地域 ID: インポートするデータを含む AlloyDB for PostgreSQL の地域 ID。これは必須項目です。
      • クラスタ ID: インポートするデータを含む AlloyDB for PostgreSQL クラスタ ID。これは必須項目です。
      • データベース ID: インポートするデータを含む AlloyDB for PostgreSQL データベース ID。これは必須項目です。
      • テーブル ID: インポートするデータを含む AlloyDB for PostgreSQL テーブル ID。これは必須項目です。
    3. [続行] をクリックします。

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

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

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

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

次のステップ