在 Cloud SQL for PostgreSQL Studio 中管理上下文集

本文档介绍了如何在 Cloud SQL for PostgreSQL Studio 中使用上下文集文件创建上下文集。上下文集名称在数据库中必须是唯一的。

如需了解上下文集,请参阅上下文集概览

准备工作

在创建代理之前,请完成以下前提条件。

启用必需服务

为您的项目启用以下服务:

准备 Cloud SQL 实例

确保您有权访问现有 Cloud SQL 实例或创建新实例。 如需了解详情,请参阅为 Cloud SQL 创建实例

本教程要求您在 Cloud SQL 实例中拥有一个数据库。如需了解详情,请参阅在 Cloud SQL 实例上创建数据库

所需的角色和权限

  • 向实例添加 IAM 用户或服务账号。如需了解详情,请参阅使用 Cloud SQL 的 IAM 数据库身份验证管理用户
  • 在项目级层向 IAM 用户授予 cloudsql.studioUsercloudsql.instanceUsergeminidataanalytics.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,然后使用 IAM 身份验证对数据库进行身份验证。

创建上下文集

如需创建上下文集,请执行以下步骤:

  1. 在 Cloud de Confiance by S3NS 控制台中,前往 Cloud SQL 页面。

    前往 Cloud SQL

  2. 从列表中选择一个实例。

  3. 在导航菜单中,点击 Cloud SQL Studio

  4. 使用 IAM 身份验证登录Studio

  5. 探索器窗格中,点击上下文集旁边的查看操作

  6. 点击创建上下文集

  7. 上下文集名称中,提供唯一的上下文集名称。上下文集名称区分大小写,并且可以包含字母、数字、连字符和下划线。

  8. 可选。在情境集说明中,为情境集添加说明。

  9. 点击创建

构建上下文集

创建上下文集后,请按照使用 Gemini CLI 构建上下文中的步骤创建上下文集文件。然后,您可以修改上下文集,上传上下文集文件。

修改上下文集

如需修改上下文集,请执行以下步骤:

  1. 在 Cloud de Confiance 控制台中,前往 Cloud SQL 页面。

    前往 Cloud SQL

  2. 从列表中选择一个实例。

  3. 在导航菜单中,点击 Cloud SQL Studio

  4. 使用 Identity and Access Management 身份验证登录Studio

  5. 探索器窗格中,点击上下文集旁边的查看操作

  6. 点击修改情境集

  7. 可选:修改上下文集说明

  8. 上传上下文集文件部分中,点击浏览,然后选择上下文集文件。

  9. 点击保存

删除上下文集

如需删除上下文集,请执行以下步骤:

  1. 在 Cloud de Confiance 控制台中,前往 Cloud SQL 页面。

    前往 Cloud SQL

  2. 从列表中选择一个实例。

  3. 在导航菜单中,点击 Cloud SQL Studio

  4. 使用 Identity and Access Management 身份验证登录Studio

  5. 探索器窗格中,点击上下文集旁边的查看操作

  6. 点击删除上下文集

  7. 删除上下文集确认对话框中,输入上下文集的名称。

  8. 点击确认以删除上下文集。

后续步骤