Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

AlloyDB Studio でコンテキストセットを管理する

コンテキストエンジニアリングエージェントを使用すると、CLI からコンテキストセットを自動的に作成してアップロードできます。このドキュメントでは、 Google Cloud コンソールでコンテキストセットファイルを管理するためのビジュアルインターフェースが必要な場合に、AlloyDB for PostgreSQL Studio でコンテキストセットを作成、編集、削除する方法について説明します。AlloyDB Studio でコンテキストセットを作成すると、AlloyDB Studio は、選択したリージョンのプロジェクトの default コンテキストセットグループに保存し、現在のデータベースにリンクします。コンテキストセット名（および派生したコンテキストセット ID）は、特定のリージョンのプロジェクトの default コンテキストセットグループ内で、すべてのデータベースとインスタンスにわたって一意である必要があります。AlloyDB Studio で、派生 ID がすでに存在する名前のコンテキストセットを作成すると、検証に失敗します。データベースの関連付けを維持しながらコンテンツを上書きするには、既存のコンテキストセットを編集します。コンテキストエンジニアリングエージェントまたは Dataplex API を使用して、既存のコンテキストセット ID で直接アップロードすると、そのコンテンツと、指定されている場合はデータベースの関連付けが置き換えられます。

AlloyDB Studio の [コンテキストセット] リストには、現在のデータベースにリンクされている、サポートされているすべてのリージョンの default コンテキストセットグループ内のコンテキストセットのみが表示されます。別のデータベース用に作成されたコンテキストセット、または databases（またはカスタムコンテキストセットグループ）でデータベースリソースをリンクせずに API を介して作成されたコンテキストセットは、AlloyDB Studio のリストに表示されません。

コンテキストセットの詳細については、コンテキストセットの概要をご覧ください。

始める前に

コンテキストセットを作成またはアップロードする前に、次の前提条件を満たす必要があります。

コンテキストセットは、us-central1、us-east1、europe-west4、asia-southeast1 の各リージョンで作成できます。

必要なサービスを有効にする

プロジェクトで次のサービスを有効にします。

AlloyDB for PostgreSQL のクラスタ、インスタンス、データベースを準備する

既存の AlloyDB クラスタとインスタンスにアクセスできることを確認するか、新しいクラスタとインスタンスを作成します。
このチュートリアルでは、AlloyDB インスタンスにデータベースが必要です。詳細については、データベースを作成するをご覧ください。

必要なロールと権限

alloydb.iam_authentication データベースフラグを on（alloydb.iam_authentication=on）に設定して、インスタンスで Identity and Access Management（IAM）データベース認証を有効にします。詳細については、IAM 認証を有効または無効にするをご覧ください。
データベースレベルでクラスタに IAM ユーザーまたはサービスアカウントを追加します。詳細については、IAM 認証を管理するをご覧ください。
プロジェクトレベルで IAM ユーザーに roles/alloydb.databaseUser、roles/serviceusage.serviceUsageConsumer、roles/geminidataanalytics.queryDataUser ロールを付与します。詳細については、プロジェクトの IAM ポリシーバインディングを追加するをご覧ください。
コンテキストセットを作成、アップロード、管理するには、プロジェクトレベルで IAM ユーザーに Dataplex Catalog 編集者（roles/dataplex.catalogEditor）または Dataplex Catalog 管理者（roles/dataplex.catalogAdmin）ロールを付与します。詳細については、コンテキストセットの権限をご覧ください。
また、IAM ユーザーまたはサービスアカウントに読み取り専用のデータベース権限を付与する必要があります。

GRANT SELECT ON ALL TABLES IN SCHEMA public TO "USER_NAME";

USER_NAME は、ユーザーのメールアドレス、または . サフィックスのないサービスアカウントアドレス（my-sa@my-project.iam など）に置き換えます。識別子には特殊文字（@ と .）が含まれているため、識別子を引用符で囲む必要があります。

詳細については、IAM ユーザーに適切なデータベース権限を付与するをご覧ください。

AlloyDB for PostgreSQL インスタンスに `executesql` 権限を付与する

AlloyDB for PostgreSQL インスタンスに executesql 権限を付与し、dataApiAccess インスタンスフィールドを ENABLED に設定するには（デフォルトでは AlloyDB Studio などの一部の内部 Google Cloud サービスが許可されていますが、QueryData には必要です）、次の curl コマンドを使用します。

   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     -H "x-goog-user-project: PROJECT_ID" \
     https://alloydb.googleapis.com/v1beta/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
     -d '{
       "dataApiAccess": "ENABLED"
     }'

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

PROJECT_ID: 実際の Google Cloud プロジェクト ID。
LOCATION: AlloyDB クラスタが配置されているリージョン。
CLUSTER_ID: AlloyDB クラスタの ID。
INSTANCE_ID: AlloyDB インスタンスの ID。

このチュートリアルの手順を行うには、Google Cloud にログインし、IAM 認証を使用してデータベースに対して認証を行います。

コンテキストセットを作成する

コンテキストセットを作成する手順は次のとおりです。

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

AlloyDB に移動する
リストからクラスタを選択します。
ナビゲーションメニューで [AlloyDB Studio] をクリックします。
IAM 認証を使用して AlloyDB Studio にログインします。
[エクスプローラ] ペインで、[コンテキストセット] の横にある [アクションを表示] をクリックします。
[コンテキストセットを作成] をクリックします。
[コンテキストセット名] に、一意のコンテキストセット名を入力します。AlloyDB Studio では、名前は 4 ～ 30 文字で、先頭に空白文字を使用することはできません。Studio は、名前を小文字に変換し、英数字以外の文字をハイフン（-）に置き換えることで、コンテキストセット ID を導出します。導出されたコンテキストセット ID は、選択したリージョンのプロジェクトの default コンテキストセットグループ内で一意である必要があります。たとえば、コンテキストセット名 querydata_e2e_test のコンテキストセット ID は querydata-e2e-test です。コンテキストエンジニアリングエージェントまたは Dataplex API を使用してコンテキストセットを直接アップロードする場合、コンテキストセット ID は大文字と小文字が区別され、スラッシュ（/）を含めることはできません。また、4 ～ 30 文字、英数字、ハイフン、アンダースコアに制限されません。
省略可。[コンテキストセットの説明] に、コンテキストセットの説明を追加します。
省略可。コンテキストセットファイルをアップロードするには、[コンテキストセットファイルのアップロード] セクションで [参照] をクリックし、コンテキストセットファイルを選択します。
省略可。コンテキストセットのリージョンを選択するには、[詳細オプションを表示] をクリックし、[ロケーションを選択] でリージョンを選択します（作成ごとにデフォルトで us-east1 に設定されます）。us-east1 以外のリージョンを選択する場合は、コンテキストセット名を入力する前にリージョンを選択して、AlloyDB Studio がそのリージョンで名前の一意性を検証するようにします。
[作成] をクリックします。

コンテキストセットを構築する

Studio で空のコンテキストセットを作成した場合や、既存のコンテキストセットを更新する場合は、コンテキストエンジニアリングエージェントを使用してコンテキストセットを構築して最適化するの手順に沿って、コンテキストセットファイルを生成して最適化します。コンテキストエンジニアリングエージェントは、CLI からコンテキストセットを直接作成してアップロードできます。また、Studio でコンテキストセットを編集して、コンテキストセットファイルを手動でアップロードすることもできます。

コンテキストセットを編集する

コンテキストセットを編集する手順は次のとおりです。

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

AlloyDB に移動する
リストからクラスタを選択します。
ナビゲーションメニューで [AlloyDB Studio] をクリックします。
IAM 認証を使用して AlloyDB Studio にログインします。
編集するコンテキストセットの横にある [アクションを表示] をクリックします。
[コンテキストセットを編集] をクリックします。
省略可。[コンテキストセットの説明] を編集します。
[コンテキストセットファイルのアップロード] セクションで [参照] をクリックし、コンテキストセットファイルを選択します。
[保存] をクリックします。

コンテキストセットを削除する

コンテキストセットを削除する手順は次のとおりです。

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

AlloyDB に移動する
リストからクラスタを選択します。
ナビゲーションメニューで [AlloyDB Studio] をクリックします。
IAM 認証を使用して AlloyDB Studio にログインします。
削除するコンテキストセットの横にある [アクションを表示] をクリックします。
[コンテキストセットを削除] をクリックします。
[コンテキストセットを削除しますか？] 確認ダイアログで、コンテキストセットの ID を入力します。
[確認] をクリックして、コンテキストセットを削除します。

次のステップ

コンテキストセットの詳細を確認する。
AlloyDB Studio で QueryData をテストする方法を確認する。
コンテキストエンジニアリングエージェントを使用してコンテキストセットを構築して最適化する方法を学習する。
QueryData をアプリケーションと統合する方法を学習する。

AlloyDB Studio でコンテキスト セットを管理する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

必要なサービスを有効にする

AlloyDB for PostgreSQL のクラスタ、インスタンス、データベースを準備する

必要なロールと権限

AlloyDB for PostgreSQL インスタンスに executesql 権限を付与する

コンテキスト セットを作成する

コンテキスト セットを構築する

コンテキスト セットを編集する

コンテキスト セットを削除する