このドキュメントでは、コンテキスト セット ファイルを使用して Cloud SQL for MySQL Studio でコンテキスト セットを作成する方法について説明します。コンテキスト セット名は、データベース内で一意である必要があります。
コンテキスト セットの詳細については、コンテキスト セットの概要をご覧ください。始める前に
エージェントを作成する前に、次の前提条件を満たす必要があります。
必要なサービスを有効にする
プロジェクトで次のサービスを有効にします。Cloud SQL インスタンスを準備する
- 既存の Cloud SQL インスタンスにアクセスできることを確認するか、新しいインスタンスを作成します。詳細については、Cloud SQL のインスタンスを作成する をご覧ください。
- テーブルを作成するインスタンスにデータベースを作成します。詳細については、Cloud SQL インスタンスでデータベースを作成する をご覧ください。
必要なロールと権限
- インスタンス レベルで IAM ユーザーまたはサービス アカウントを追加します。詳細については、ユーザー、サービス アカウント、またはグループに IAM ポリシー バインディングを追加するをご覧ください。
- プロジェクト レベルで IAM ユーザーまたはサービス アカウントに
cloudsql.studioUser、cloudsql.instanceUser、geminidataanalytics.queryDataUserのロールを付与します。詳細については、プロジェクトの IAM ポリシー バインディングを追加するをご覧ください。 - 特権ユーザーが IAM ユーザーまたはサービス アカウントにデータベース権限を付与する必要があります。
GRANT SELECT PRIVILEGES ON * TO "IAM_USERNAME";.
詳細については、個々の 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。
コンテキスト セットを作成する
コンテキスト セットを作成する手順は次のとおりです。
コンソールで、[Cloud SQL] ページに移動します。 Google Cloud
リストからインスタンスを選択します。
ナビゲーション メニューで [Cloud SQL Studio] をクリックします。
IAM 認証を使用して Studio にログインします。
[エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。
[コンテキスト セットを作成] をクリックします。
[**コンテキスト セット名**] に、一意のコンテキスト セット名を入力します。コンテキスト セット名では大文字と小文字が区別され、英字、数字、ハイフン、アンダースコアを使用できます。
省略可。In [Context set description], add a description for your context set.
[作成] をクリックします。
コンテキスト セットを構築する
コンテキスト セットを作成したら、Gemini CLI を使用してコンテキストを構築するの手順に沿って、コンテキスト セットファイルを作成します。その後、コンテキスト セットを編集してコンテキスト セット ファイルをアップロードできます。
コンテキスト セットを編集する
コンテキスト セットを編集する手順は次のとおりです。
コンソールで、[Cloud SQL] ページに移動します。 Google Cloud
リストからインスタンスを選択します。
ナビゲーション メニューで [Cloud SQL Studio] をクリックします。
Identity and Access Management 認証を使用して Studio にログインします。
[エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。
[コンテキスト セットを編集] をクリックします。
省略可: [コンテキスト セットの説明] を編集します。
[コンテキスト セット ファイルのアップロード] セクションで [参照] をクリックし、コンテキスト セット ファイルを選択します。
[保存] をクリックします。
コンテキスト セットを削除する
コンテキスト セットを削除する手順は次のとおりです。
コンソールで、[Cloud SQL] ページに移動します。 Google Cloud
リストからインスタンスを選択します。
ナビゲーション メニューで [Cloud SQL Studio] をクリックします。
Identity and Access Management 認証を使用して Studio にログインします。
[エクスプローラ] ペインで、[コンテキスト セット] の横にある [アクションを表示] をクリックします。
[コンテキスト セットを削除] をクリックします。
[コンテキスト セットを削除しますか?] 確認ダイアログで、コンテキスト セットの名前を入力します。
[確認] をクリックして、コンテキスト セットを削除します。
次のステップ
- コンテキスト セットの詳細を確認する。
- コンテキスト セットをテストする方法を確認する。
- Gemini CLI を使用してコンテキストを構築する方法を確認する。