このドキュメントでは、コンテキスト セット ファイルを使用して Cloud SQL for PostgreSQL Studio でコンテキスト セットを作成する方法について説明します。コンテキスト セット名は、データベース内で一意である必要があります。
コンテキスト セットの詳細については、コンテキスト セットの概要をご覧ください。始める前に
エージェントを作成する前に、次の前提条件を満たす必要があります。
必要なサービスを有効にする
プロジェクトで次のサービスを有効にします。Cloud SQL インスタンスを準備する
既存の Cloud SQL インスタンスにアクセスできることを確認するか、新しいインスタンスを作成します。詳細については、Cloud SQL のインスタンスを作成するをご覧ください。このチュートリアルでは、Cloud SQL インスタンスにデータベースが必要です。詳細については、Cloud SQL インスタンスでデータベースを作成するをご覧ください。
必要なロールと権限
- IAM ユーザーまたはサービス アカウントをインスタンスに追加します。詳細については、Cloud SQL の IAM データベース認証でユーザーを管理するをご覧ください。
- プロジェクト レベルで IAM ユーザーに
cloudsql.studioUser、cloudsql.instanceUser、geminidataanalytics.queryDataUserのロールを付与します。詳細については、プロジェクトの IAM ポリシー バインディングを追加するをご覧ください。 - また、
postgresユーザーなどのスーパーユーザー権限を持つユーザーとしてログインして、IAM ユーザーまたはサービス アカウントに読み取り専用のデータベース権限を付与する必要があります。GRANT SELECT ON ALL TABLES IN SCHEMA public TO USER_NAME;
USER_NAME は、ユーザーのメールアドレスに置き換えます。メールアドレスには特殊文字(@ と .)が含まれているため、引用符で囲む必要があります。
詳細については、個々の IAM ユーザーまたはサービス アカウントにデータベース権限を付与するをご覧ください。
Cloud SQL インスタンスに executesql 権限を付与する
Cloud SQL インスタンスに executesql 権限を付与し、Cloud SQL Data API を有効にするには、次のコマンドを実行します。
gcloud config set project PROJECT_ID gcloud components update gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API
PROJECT_ID: 実際の Google Cloud プロジェクト ID。INSTANCE_ID: Cloud SQL インスタンスの ID。
コンテキスト セットを作成する
コンテキスト セットを作成する手順は次のとおりです。
Google Cloud コンソールで、[Cloud SQL] ページに移動します。
リストからインスタンスを選択します。
ナビゲーション メニューで [Cloud SQL Studio] をクリックします。
IAM 認証を使用して Studio にログインします。
[エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。
[コンテキスト セットを作成] をクリックします。
[コンテキスト セット名] に、一意のコンテキスト セット名を入力します。コンテキスト セット名では大文字と小文字が区別され、英字、数字、ハイフン、アンダースコアを使用できます。
省略可。[コンテキスト セットの説明] に、コンテキスト セットの説明を追加します。
[作成] をクリックします。
コンテキスト セットを構築する
コンテキスト セットを作成したら、Gemini CLI を使用してコンテキストを構築するの手順に沿って、コンテキスト セット ファイルを作成します。その後、コンテキスト セットを編集してコンテキスト セット ファイルをアップロードできます。
コンテキスト セットを編集する
コンテキスト セットを編集する手順は次のとおりです。
Google Cloud コンソールで、[Cloud SQL] ページに移動します。
リストからインスタンスを選択します。
ナビゲーション メニューで [Cloud SQL Studio] をクリックします。
Identity and Access Management 認証を使用して Studio にログインします。
[エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。
[コンテキスト セットを編集] をクリックします。
省略可: [コンテキスト セットの説明] を編集します。
[コンテキスト セット ファイルのアップロード] セクションで [参照] をクリックし、コンテキスト セット ファイルを選択します。
[保存] をクリックします。
コンテキスト セットを削除する
コンテキスト セットを削除するには、次の操作を行います。
Google Cloud コンソールで、[Cloud SQL] ページに移動します。
リストからインスタンスを選択します。
ナビゲーション メニューで [Cloud SQL Studio] をクリックします。
Identity and Access Management 認証を使用して Studio にログインします。
[エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。
[コンテキスト セットを削除] をクリックします。
[コンテキスト セットを削除しますか?] 確認ダイアログで、コンテキスト セットの名前を入力します。
[確認] をクリックして、コンテキスト セットを削除します。
次のステップ
- 詳しくは、コンテキスト セットをご覧ください。
- 詳しくは、コンテキスト セットをテストする方法をご覧ください。
- Gemini CLI を使用してコンテキストを構築する方法を確認する。