本文档介绍了如何在 Cloud SQL for PostgreSQL Studio 中使用上下文集文件创建上下文集。上下文集名称在数据库中必须是唯一的。
如需了解上下文集,请参阅上下文集概览。准备工作
在创建代理之前,请完成以下前提条件。
启用必需服务
为您的项目启用以下服务:准备 Cloud SQL 实例
确保您有权访问现有 Cloud SQL 实例或创建新实例。 如需了解详情,请参阅为 Cloud SQL 创建实例。本教程要求您在 Cloud SQL 实例中拥有一个数据库。如需了解详情,请参阅在 Cloud SQL 实例上创建数据库。
所需的角色和权限
- 向实例添加 IAM 用户或服务账号。如需了解详情,请参阅使用 Cloud SQL 的 IAM 数据库身份验证管理用户。
- 在项目级层向 IAM 用户授予
cloudsql.studioUser、cloudsql.instanceUser和geminidataanalytics.queryDataUser角色。如需了解详情,请参阅为项目添加 IAM 政策绑定。 - 您还必须以具有超级用户权限(例如
postgres用户)的用户身份登录,向 IAM 用户或服务账号授予只读数据库权限。GRANT SELECT ON ALL TABLES IN SCHEMA public TO USER_NAME;
将 USER_NAME 替换为用户的电子邮件地址。您必须使用英文引号将电子邮件地址括起来,因为它包含特殊字符(@ 和 .)。
如需了解详情,请参阅向单个 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:您的 Cloud de Confiance by S3NS 项目的 ID。INSTANCE_ID:Cloud SQL 实例的 ID。
创建上下文集
如需创建上下文集,请执行以下步骤:
在 Cloud de Confiance by S3NS 控制台中,前往 Cloud SQL 页面。
从列表中选择一个实例。
在导航菜单中,点击 Cloud SQL Studio。
使用 IAM 身份验证登录Studio。
在探索器窗格中,点击上下文集旁边的查看操作。
点击创建上下文集。
在上下文集名称中,提供唯一的上下文集名称。上下文集名称区分大小写,并且可以包含字母、数字、连字符和下划线。
可选。在情境集说明中,为情境集添加说明。
点击创建。
构建上下文集
创建上下文集后,请按照使用 Gemini CLI 构建上下文中的步骤创建上下文集文件。然后,您可以修改上下文集,上传上下文集文件。
修改上下文集
如需修改上下文集,请执行以下步骤:
在 Cloud de Confiance 控制台中,前往 Cloud SQL 页面。
从列表中选择一个实例。
在导航菜单中,点击 Cloud SQL Studio。
使用 Identity and Access Management 身份验证登录Studio。
在探索器窗格中,点击上下文集旁边的查看操作。
点击修改情境集。
可选:修改上下文集说明。
在上传上下文集文件部分中,点击浏览,然后选择上下文集文件。
点击保存。
删除上下文集
如需删除上下文集,请执行以下步骤:
在 Cloud de Confiance 控制台中,前往 Cloud SQL 页面。
从列表中选择一个实例。
在导航菜单中,点击 Cloud SQL Studio。
使用 Identity and Access Management 身份验证登录Studio。
在探索器窗格中,点击上下文集旁边的查看操作。
点击删除上下文集。
在删除上下文集确认对话框中,输入上下文集的名称。
点击确认以删除上下文集。
后续步骤
- 详细了解上下文集。
- 了解如何测试上下文集。
- 了解如何使用 Gemini CLI 构建上下文。