连接到 Cloud SQL

本文档介绍了如何创建连接到 Cloud SQL 数据的数据存储区。您可以将此数据存储区关联到 Gemini Enterprise 应用，以便智能体分析您的数据。

如需使用 Gemini Enterprise 数据存储区连接到 Cloud SQL 数据，您可以使用以下模式之一：

• 联合查询（推荐）[预览版]：就地连接到 Cloud SQL 数据，而不会因复制和移动数据而产生出站流量费用。联合查询会将您的查询直接发送到 Cloud SQL，涵盖您的身份拥有 Identity and Access Management (IAM) 访问权限的所有实例、数据库和表，这对于分析查询更高效。使用联合查询模式时，系统会自动在 Gemini Enterprise 应用的助理标签页中启用 Knowledge Catalog，以便为智能体提供工具，用于搜索用户有权访问的数据并查找上下文。

  注意 ：高精确度数据库查询：联合查询模式可提供对用户可访问的所有实例和数据库的广泛访问权限，但查询精确度可能会因复杂的事务架构而异。对于需要高精确度、确定性表范围和经过验证的查询（黄金 SQL）的工作负载，请在 Cloud SQL for MySQL 或 Cloud SQL for PostgreSQL 中创建限定范围的数据智能体，并将其发布到 Gemini Enterprise。

• 数据注入：将数据从特定 Cloud SQL 表复制到 Gemini Enterprise 数据存储区。必须手动刷新数据，才能反映 Cloud SQL 表中的更改。此模式会产生将数据移至新位置的出站流量费用，并且现有 IAM 权限不会复制到数据存储区。

准备工作

如需在 Gemini Enterprise 中创建 Cloud SQL 数据存储区，您必须拥有 Gemini Enterprise Admin (roles/discoveryengine.agentspaceAdmin) 或 Discovery Engine Admin (roles/discoveryengine.admin) 角色。如需了解详情，请参阅向管理员授予权限。

如果您的项目受 VPC Service Controls 边界保护或已启用组织政策强制执行，请确保您的组织政策允许连接器：

• 将 cloudsql 添加到 discoveryengine.managed.allowedDataSources 托管式限制（限制数据连接器允许的数据源）中的 allowedDataSources 参数。如需了解详情，请参阅代管式政策限制条件概览和配置允许的数据源。

此外，请完成前提条件，并为您计划使用的连接器模式配置所需的 Cloud SQL IAM 权限：

联合查询

预览

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

如需使用联合查询模式连接到 Cloud SQL，请在包含 Cloud SQL 实例的 Google Cloud 项目中完成以下前提条件：

1. 在 Cloud SQL 实例上启用 Data API：

   gcloud sql instances patch <var>INSTANCE_NAME</var> \
       --project=<var>PROJECT_ID</var> \
       --data-api-access=ALLOW_DATA_API
   

2. 授予 IAM 权限：在包含 Cloud SQL 实例的 Google Cloud 项目中，向通过连接器执行查询或操作的用户授予以下 IAM 角色：

   • 实例和数据库访问权限：
     • Cloud SQL Viewer (roles/cloudsql.viewer) 和 Cloud SQL Client (roles/cloudsql.client)（或 Cloud SQL Instance User (roles/cloudsql.instanceUser)，具有 IAM 数据库身份验证），用于只读查询和工具。
     • 如果启用了写入或管理操作，则为 Cloud SQL Editor (roles/cloudsql.editor) 或 Cloud SQL Admin (roles/cloudsql.admin)。
   • MCP 工具访问权限：
     • MCP Tool User (roles/mcp.toolUser) 权限，以便调用 MCP 工具。

数据注入

如需从 Cloud SQL 注入数据，请配置以下 IAM 权限：

• 暂存存储桶访问权限：从 Cloud SQL 注入数据时，数据会先暂存到 Cloud Storage 存储桶。向 Cloud SQL 实例的服务账号（例如 p9876-abcd33f@gcp-sa-cloud-sql.）授予中间 Cloud Storage 存储桶的 Storage Admin (roles/storage.admin) 角色。
• 跨项目 Cloud SQL 访问：如果您要从来源 Google Cloud 项目（与包含您要创建的 Gemini Enterprise 数据存储区的 Google Cloud 项目不同）导入数据，请向service-PROJECT_NUMBER@gcp-sa-discoveryengine.服务账号（其中 PROJECT_NUMBER 是包含 Gemini Enterprise 数据存储区的Google Cloud 项目的项目编号）授予来源 Cloud SQL 项目的 Cloud SQL Viewer (roles/cloudsql.viewer) 角色。

注意： 如果您选择将 Cloud SQL 中的数据注入到 Gemini Enterprise 数据存储区，则 Cloud SQL 权限不会随数据一起导入。导入后，任何拥有足够 Gemini Enterprise 权限的用户都可以查看这些数据，即使他们无权在 Cloud SQL 中查看这些数据。

创建 Cloud SQL 数据存储区

如需创建将 Cloud SQL 中的数据关联到 Gemini Enterprise 的数据存储区，请按以下步骤操作：

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

   Gemini Enterprise

2. 前往数据存储区页面。

3. 点击创建数据存储区。

4. 在来源页面上，为数据存储区选择数据源。在选择数据源搜索字段中搜索“Cloud SQL”，或在第一方数据源列表中找到 Cloud SQL。选择添加数据源。

5. 在数据页面上，选择连接器模式，以确定如何连接到数据。根据您选择的模式，从以下标签页中选择一个，查看进一步的说明。

   联合查询

   预览

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

   1. 选择联合查询（推荐）。点击继续。
   2. 在操作页面上，选择要为数据存储区启用的 Cloud SQL 操作。您稍后可以修改这些设置。点击继续。

   数据注入

   1. 选择数据注入。
   2. 指定要导入的数据的详细信息。在从 Cloud SQL 表导入数据下，指定以下信息：
      • 项目 ID：包含 Cloud SQL 表的 Google Cloud 项目。此字段是必填字段。
      • 实例 ID：包含要导入的数据的 Cloud SQL 实例 ID。此字段是必填字段。
      • 数据库 ID：包含要导入的数据的 Cloud SQL 数据库 ID。此字段是必填字段。
      • 表 ID：包含要导入的数据的 Cloud SQL 表 ID。此字段是必填字段。
      • 输入数据的 Google Cloud Storage 存储桶位置。此字段是必填字段。 （可选）选择启用无服务器导出以使用 Cloud SQL 无服务器导出。启用无服务器导出功能会产生额外费用。请参阅 Cloud SQL 无服务器导出价格。
   3. 点击继续。

6. 在配置页面上，配置数据存储区设置。

   • 数据连接器的位置：选择一个区域来存储数据存储区的元数据。创建数据存储区后，您将无法更改位置。如需了解有关多区域位置的重要信息，请参阅 Gemini Enterprise 位置。
   • 数据连接器名称：在数据连接器名称字段中，为数据连接器输入名称。数据连接器创建后，您便无法更改其名称。输入名称后，系统会为您的数据连接器生成一个唯一 ID。（可选）在标记（可选）字段中，为数据连接器输入一个标记，该标记可作为连接器在所有版本中的稳定标识符。
   • Sensitive Data Protection 政策：为数据存储区选择 Sensitive Data Protection 政策。应遵循以下格式：projects/{project}/locations/{location}/contentPolicies/{policy}。您稍后可以修改此设置。

7. 点击创建。

现在，您可以将数据存储区附加到 Gemini Enterprise 应用。在联合查询模式下，用户通过附加的应用运行查询时，查询会产生 Cloud SQL 使用费用；在数据注入模式下，导入数据会产生 Cloud SQL、Cloud Storage 和 Gemini Enterprise 索引费用，即使数据存储区尚未附加到应用也是如此。如需详细了解这些费用，请参阅 Gemini Enterprise 价格。

后续步骤

• 如需将数据存储区关联到应用，请按照创建 Gemini Enterprise 应用中的步骤创建应用并选择数据存储区。

• 了解Knowledge Catalog 如何与 Data Cloud 连接器搭配使用（在使用联合查询模式时自动启用），以帮助智能体搜索用户有权访问的数据并查找组织上下文。

• 如需构建具有经过验证的查询的高准确率、限定范围的智能体，请参阅将 Cloud SQL for MySQL 数据智能体或 Cloud SQL for PostgreSQL 数据智能体发布到 Gemini Enterprise。