Vertex AI との統合

このページでは、AlloyDB for PostgreSQL と Vertex AI の統合を設定して、クラウドに保存されている大規模言語モデル(LLM)にクエリを適用する方法について説明します。

以下の手順は、AlloyDB Omni ではなく AlloyDB の使用に固有です。代わりに Vertex AI を使用して AlloyDB Omni のローカル インストールを統合するには、AlloyDB AI で AlloyDB Omni をインストールするをご覧ください。

AlloyDB で ML モデルを使用する方法については、AlloyDB AI を使用した生成 AI アプリケーションの構築をご覧ください。

Vertex AI の詳細については、Vertex AI の概要をご覧ください。

始める前に

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

  5. Install the Google Cloud CLI.
  6. To initialize the gcloud CLI, run the following command:

    gcloud init
  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  8. Make sure that billing is enabled for your Google Cloud project.

  9. Enable the Vertex AI API.

    Enable the API

  10. Install the Google Cloud CLI.
  11. To initialize the gcloud CLI, run the following command:

    gcloud init

Vertex AI ユーザーに AlloyDB サービス エージェントへの権限を付与する

Vertex AI とデータベースのインテグレーションを有効にするには、次の手順で AlloyDB サービス エージェントに Vertex AI へのアクセス権のIdentity and Access Management(IAM)権限を付与します。

AlloyDB データベースのクラスタが配置されているプロジェクトの AlloyDB サービス エージェントに Vertex AI 権限を追加します。

Console

  1. Google Cloud コンソールの [ようこそ] ページに移動し、AlloyDB クラスタまたはインスタンスがあるプロジェクトのプロジェクト番号をコピーします。このプロジェクト番号は、次の手順で使用します。

    [ようこそ] に移動

  2. Google Cloud コンソールの [IAM] ページに移動します。

    [IAM] に移動

  3. Vertex AI エンドポイントがあるプロジェクトを選択します。

  4. [Google 提供のロール付与を含みます] を有効にします。

  5. [アクセス権を付与] をクリックします。

  6. [新しいプリンシパル] フィールドに、次の値を入力します。

        service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com
        

    PROJECT_NUMBER は、プロジェクト番号に置き換えます。

  7. [ロール] フィールドに「Vertex AI ユーザー」と入力します。

  8. [保存] をクリックします。

gcloud

gcloud CLI を使用するには、Google Cloud CLI をインストールして初期化するか、Cloud Shell を使用します。

        gcloud projects add-iam-policy-binding <var>PROJECT_ID</var> \
        --member="serviceAccount:service-<var>PROJECT_NUMBER</var>@gcp-sa-alloydb.iam.gserviceaccount.com" \
        --role="roles/aiplatform.user"

次のように置き換えます。

  • PROJECT_ID: Vertex AI エンドポイントを持つプロジェクトの ID。
  • PROJECT_NUMBER: AlloyDB クラスタまたはインスタンスがあるプロジェクトのプロジェクト番号。

インストールされている拡張機能を確認する

予測を実行するデータを含むデータベースに google_ml_integration がインストールされていることを確認します。

  1. psql クライアントをインスタンスに接続するの説明に従って、psql クライアントをクラスタのプライマリ インスタンスに接続します。

  2. psql コマンド プロンプトで、データベースに接続します。

    \c DB_NAME

    DB_NAME は、拡張機能をインストールするデータベースの名前に置き換えます。

  3. google_ml_integration 拡張機能のバージョン 1.4.2 以降がインストールされていることを確認します。

    SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

  4. 省略可。最新バージョンの拡張機能を手動でインストールします。

    CREATE EXTENSION google_ml_integration VERSION '1.4.2';

  5. 省略可。1.4.2 より前の拡張機能を使用している場合は、拡張機能を最新バージョンに更新します。

    ALTER EXTENSION google_ml_integration UPDATE TO '1.4.2'

次のステップ