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

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

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

始める前に

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

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

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

Spanner インスタンスを準備する


このチュートリアルでは、Spanner インスタンスにデータベースが必要です。詳細については、データベースを作成するをご覧ください。

必要なロールと権限

  • IAM ユーザーまたはサービス アカウントをクラスタに追加します。詳細については、IAM ロールを適用するをご覧ください。
  • プロジェクト レベルで IAM ユーザーに spanner.databaseReader ロールと geminidataanalytics.queryDataUser ロールを付与します。詳細については、プロジェクトの IAM ポリシー バインディングを追加するをご覧ください。
  • コンテキスト セットを作成、アップロード、管理するには、プロジェクト レベルで IAM ユーザーに Dataplex Catalog 編集者(roles/dataplex.catalogEditor)または Dataplex Catalog 管理者(roles/dataplex.catalogAdmin)のロールを付与します。詳細については、コンテキストで権限を設定するをご覧ください。
  • 必要なデータベースに対して、プロジェクト レベルで IAM ユーザーにロールと権限を付与します。

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

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

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

    Spanner に移動

  2. リストからインスタンスを選択し、データベースを選択します。

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

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

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

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

  7. 省略可。[コンテキスト セットの説明] に、コンテキスト セットの説明を追加します。

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

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

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

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

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

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

    Spanner に移動

  2. リストからインスタンスを選択し、データベースを選択します。

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

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

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

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

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

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

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

コンテキスト セットを削除するには、次の操作を行います。

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

    Spanner に移動

  2. リストからインスタンスを選択し、データベースを選択します。

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

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

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

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

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

次のステップ