连接到 AlloyDB for PostgreSQL

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

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

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

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

准备工作

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

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

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

此外，请为您计划使用的连接器模式配置所需的 AlloyDB for PostgreSQL IAM 权限：

创建 AlloyDB for PostgreSQL 数据存储区

如需创建将 AlloyDB for PostgreSQL 中的数据连接到 Gemini Enterprise 的数据存储区，请按照以下步骤操作：

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

   Gemini Enterprise

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

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

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

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

   联合查询

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

   数据注入

   1. 选择数据注入。
   2. 指定要导入的数据的详细信息。在从 AlloyDB for PostgreSQL 表导入数据下，指定以下信息：
      • 项目 ID：包含 AlloyDB for PostgreSQL 表的 Google Cloud 项目。此字段是必填字段。
      • 位置 ID：包含要导入的数据的 AlloyDB for PostgreSQL 位置 ID。此字段是必填字段。
      • 集群 ID：包含要导入的数据的 AlloyDB for PostgreSQL 集群 ID。此字段是必填字段。
      • 数据库 ID：包含要导入的数据的 AlloyDB for PostgreSQL 数据库 ID。此字段是必填字段。
      • 表 ID：包含要导入的数据的 AlloyDB for PostgreSQL 表 ID。此字段是必填字段。
   3. 点击继续。

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

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

7. 点击创建。

现在，您可以将数据存储区关联到 Gemini Enterprise 应用了。在联合查询模式下，当用户通过关联的应用运行查询时，查询会产生 AlloyDB for PostgreSQL 使用费用；在数据注入模式下，即使在数据存储区关联到应用之前，导入数据也会产生 AlloyDB for PostgreSQL 和 Gemini Enterprise 索引费用。如需详细了解这些费用，请参阅 Gemini Enterprise 价格。

后续步骤

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

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

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