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

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

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

始める前に

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

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

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

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

必要なロールと権限

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

プロパティ グラフ スキーマの例を作成し、Spanner データベースにサンプル グラフデータを挿入するには、Spanner Graph を設定してクエリを実行するをご覧ください。

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

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

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

    Spanner に移動

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

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

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

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

  6. [コンテキスト セット名] フィールドに、一意のコンテキスト セット名(例: fingraph-assistant)を入力します。コンテキスト セット名では大文字と小文字が区別され、英字、数字、ハイフン、アンダースコアを使用できます。

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

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

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

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

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

コンテキスト セットを編集してコンテキスト セット ファイルをアップロードする手順は次のとおりです。

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

    Spanner に移動

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

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

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

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

  6. 省略可: [コンテキスト セットの説明] フィールドを編集します。

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

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

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

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

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

    Spanner に移動

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

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

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

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

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

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

次のステップ