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

このドキュメントでは、コンテキスト セット ファイルを使用して AlloyDB for PostgreSQL Studio でコンテキスト セットを作成する方法について説明します。コンテキスト セット名はデータベース内で一意である必要があります。

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

始める前に

エージェントを作成する前に、次の前提条件を満たす必要があります。

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

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

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

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

必要なロールと権限

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

AlloyDB for PostgreSQL インスタンスに executesql 権限を付与し、data_api_access インスタンス設定を値 ALLOW_DATA_API に設定するには、次の curl コマンドを使用します。 
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     https://alloydb.googleapis.com/v1alpha/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 認証を使用してデータベースを認証します。

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

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

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

    AlloyDB に移動

  2. リストからクラスタを選択します。

  3. ナビゲーション メニューで [AlloyDB Studio] をクリックします。

  4. IAM 認証を使用して Studio にログインします。

  5. [エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。

  6. [コンテキスト セットを作成] をクリックします。

  7. [**コンテキスト セット名**] に、一意のコンテキスト セット名を入力します。コンテキスト セット名では大文字と小文字が区別され、英字、数字、ハイフン、アンダースコアを使用できます。

  8. 省略可。In [Context set description], add a description for your context set.

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

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

コンテキスト セットを作成したら、Gemini CLI を使用してコンテキストを構築するの手順に沿って、コンテキスト セットファイルを作成します。その後、コンテキスト セットを編集してコンテキスト セット ファイルをアップロードできます。

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

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

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

    AlloyDB に移動

  2. リストからクラスタを選択します。

  3. ナビゲーション メニューで [AlloyDB Studio] をクリックします。

  4. Identity and Access Management 認証を使用して Studio にログインします。

  5. [エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。

  6. [コンテキスト セットを編集] をクリックします。

  7. 省略可: [コンテキスト セットの説明] を編集します。

  8. [コンテキスト セット ファイルのアップロード] セクションで [参照] をクリックし、コンテキスト セット ファイルを選択します。

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

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

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

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

    AlloyDB に移動

  2. リストからクラスタを選択します。

  3. ナビゲーション メニューで [AlloyDB Studio] をクリックします。

  4. Identity and Access Management 認証を使用して Studio にログインします。

  5. [エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。

  6. [コンテキスト セットを削除] をクリックします。

  7. [コンテキスト セットを削除] 確認ダイアログで、コンテキスト セットの名前を入力します。

  8. [確認] をクリックして、コンテキスト セットを削除します。

次のステップ