在 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 Editor (roles/dataplex.catalogEditor) 或 Dataplex Catalog Admin (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. 点击确认以删除上下文集。

后续步骤