このページでは、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 の概要をご覧ください。
始める前に
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verify that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
-
Install the Google Cloud CLI.
-
外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。
-
gcloud CLI を初期化するには、次のコマンドを実行します。
gcloud init -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verify that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
-
Install the Google Cloud CLI.
-
外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。
-
gcloud CLI を初期化するには、次のコマンドを実行します。
gcloud init Google Cloud コンソールの [ようこそ] ページに移動し、AlloyDB クラスタまたはインスタンスがあるプロジェクトのプロジェクト番号をコピーします。このプロジェクト番号は、次の手順で使用します。
Google Cloud コンソールで、[IAM] ページに移動します。
Vertex AI エンドポイントがあるプロジェクトを選択します。
[Google 提供のロール付与を含める] を有効にします。
[アクセス権を付与] をクリックします。
[新しいプリンシパル] フィールドに、次の値を入力します。
service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.comPROJECT_NUMBER は、プロジェクト番号に置き換えます。
[ロール] フィールドに「Vertex AI ユーザー」と入力します。
[保存] をクリックします。
- PROJECT_ID: Vertex AI エンドポイントを持つプロジェクトの ID。
- PROJECT_NUMBER: AlloyDB クラスタまたはインスタンスがあるプロジェクトのプロジェクト番号。
Google Cloud コンソールで、[クラスタ] ページに移動します。
クラスタの [概要] ページを表示するには、[リソース名] 列で AlloyDB クラスタの名前をクリックします。
ナビゲーション メニューで [AlloyDB Studio] をクリックします。
[AlloyDB Studio にログインする] ページで、データベースの名前、ユーザー名、パスワードを使用して認証します。
[エディタ 1] タブで、次の操作を行います。
google_ml_integration拡張機能のバージョン 1.4.2 以降がインストールされていることを確認します。SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';
[実行] をクリックします。[結果] ペインに拡張機能のバージョンが表示されるまで待ちます。
psqlクライアントをインスタンスに接続するの説明に沿って、psqlクライアントをクラスタのプライマリ インスタンスに接続します。psqlコマンド プロンプトで、データベースに接続します。\c DB_NAME
DB_NAMEは、拡張機能をインストールするデータベースの名前に置き換えます。google_ml_integration拡張機能のバージョン 1.4.2 以降がインストールされていることを確認します。SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';
Vertex AI ユーザーに AlloyDB サービス エージェントへの権限を付与する
Vertex AI とデータベースの統合を有効にするには、次の手順で AlloyDB サービス エージェントに Vertex AI へのアクセス権の Identity and Access Management（IAM）権限を付与します。
AlloyDB データベースのクラスタが配置されているプロジェクトの AlloyDB サービス エージェントに Vertex AI 権限を追加します。
コンソール
gcloud
gcloud CLI を使用するには、Google Cloud CLI をインストールして初期化するか、Cloud Shell を使用します。
gcloud projects add-iam-policy-binding PROJECT_ID
--member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com"
--role="roles/aiplatform.user"
次のように置き換えます。
インストールされている拡張機能を確認する
予測を実行するデータを含むデータベースに google_ml_integration がインストールされていることを確認します。