本文档介绍了如何在 Spanner Studio 中使用上下文集文件为 Spanner Graph 创建、修改和删除上下文集。上下文集名称在数据库中必须是唯一的。
如需了解 Spanner Graph 的上下文集,请参阅上下文集概览。
准备工作
在创建上下文集之前,请先完成以下前提条件:
启用必需服务
为您的项目启用以下服务:准备 Spanner 实例
- 确保有可用的 Spanner 实例。如需了解详情,请参阅创建实例。
- 确保在实例中创建数据库,以便在其中创建表。如需了解详情,请参阅在 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。
创建上下文集
如需创建上下文集,请执行以下步骤:
在 Google Cloud 控制台中,前往 Spanner 页面。
从列表中选择一个实例,然后选择您的 Spanner 数据库。
在导航菜单中,点击 Spanner Studio。
在探索器窗格中,点击上下文集旁边的查看操作。
点击创建情境集。
在上下文集名称字段中,输入唯一的上下文集名称(例如
fingraph-assistant)。上下文集名称区分大小写,可以包含字母、数字、连字符和下划线。可选:在上下文集说明字段中,为上下文集添加说明。
点击创建。
构建上下文集
创建上下文集后,请按照使用上下文工程智能体构建上下文集中的步骤,为属性图创建上下文集文件。然后,您可以修改上下文集,以上传上下文集文件。
修改上下文集
如需修改上下文集并上传上下文集文件,请执行以下步骤:
在 Google Cloud 控制台中,前往 Spanner 页面。
从列表中选择一个实例,然后选择一个数据库。
在导航菜单中,点击 Spanner Studio。
在探索器窗格中,点击上下文集旁边的查看操作。
点击修改上下文集。
可选:修改上下文集说明字段。
点击上传上下文集文件部分中的浏览,然后选择上下文集 JSON 文件。
点击保存。
删除上下文集
如需删除上下文集,请执行以下步骤:
在 Google Cloud 控制台中,前往 Spanner 页面。
从列表中选择一个实例,然后选择一个数据库。
在导航菜单中,点击 Spanner Studio。
在探索器窗格中,点击上下文集旁边的查看操作。
点击删除上下文集。
在删除上下文集确认对话框中,输入上下文集的名称。
点击确认以删除上下文集。
后续步骤
- 详细了解情境集。
- 了解如何测试 Spanner Graph 的 QueryData。
- 了解如何使用上下文工程智能体构建上下文集。