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

MySQL   |  PostgreSQL   |  SQL Server

预览版

此功能受服务专用条款中“通用服务条款”部分所载“非正式版产品条款”及生成式 AI 预览版产品附加条款的约束。非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅 发布阶段说明。

如需了解如何访问此版本，请参阅 访问 申请页面。

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

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

准备工作

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

启用必需服务

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

• Data Analytics API with Gemini
• Gemini for Google Cloud API
• Dataplex Universal Catalog API

准备 Cloud SQL 实例

• 确保您有权访问现有 Cloud SQL 实例或创建新实例。 如需了解详情，请参阅为 Cloud SQL创建实例。
• 确保在实例中创建数据库，您将在其中创建表。如需了解详情，请参阅在 Cloud SQL 实例上创建数据库。

所需的角色和权限

• 在实例级添加 IAM 用户或服务帐号。如需了解详情，请参阅向用户、服务帐号或群组添加 IAM 政策绑定。
• 在项目级向 IAM 用户或服务帐号授予 cloudsql.studioUser、cloudsql.instanceUser 和 geminidataanalytics.queryDataUser 角色。如需了解详情，请参阅添加 项目的 IAM 政策绑定。
• 您必须让具有特权的用户向 IAM 用户或服务账号授予数据库权限。
  
  GRANT SELECT PRIVILEGES ON * TO "IAM_USERNAME";。
  
  如需了解 详情，请参阅向 单个 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. 使用 Identity and Access Management 身份验证登录 Studio 。

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

6. 点击修改上下文集 。

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

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

9. 点击保存 。

删除上下文集

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

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

   转到 Cloud SQL

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

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

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

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

6. 点击删除上下文集 。

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

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

注意： 在删除数据库之前，您必须删除与该数据库关联的所有上下文集。

后续步骤

• 详细了解上下文集。
• 了解如何测试上下文集。
• 了解如何使用 Gemini CLI 构建上下文。