在 Cloud SQL Studio 中管理上下文集

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

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

准备工作

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

启用必需服务

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

准备 Cloud SQL 实例

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

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

所需的角色和权限

  • 向实例添加 IAM 用户或服务帐号。如需了解详情，请参阅使用 IAM 数据库身份验证管理 Cloud SQL 用户。
  • 在项目级层向 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：您的 Google Cloud 项目的 ID。
  • INSTANCE_ID：Cloud SQL 实例的 ID。
如需执行本教程中的步骤，请登录Google Cloud，然后使用 IAM 身份验证向数据库进行身份验证。

创建上下文集

如需创建上下文集，请执行以下步骤：

  1. 在 Google Cloud 控制台中，前往 Cloud SQL 页面。

    转到 Cloud SQL

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

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

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

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

  6. 点击创建上下文集 。

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

  8. 可选。在上下文集说明中，为上下文集添加说明。

  9. 点击创建 。

构建上下文集

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

修改上下文集

如需修改上下文集，请执行以下步骤：

  1. 在 Google Cloud 控制台中，前往 Cloud SQL 页面。

    转到 Cloud SQL

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

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

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

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

  6. 点击修改上下文集 。

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

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

  9. 点击保存 。

删除上下文集

如需删除上下文集，请执行以下步骤：

  1. 在 Google Cloud 控制台中，前往 Cloud SQL 页面。

    转到 Cloud SQL

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

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

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

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

  6. 点击删除上下文集 。

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

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

后续步骤