Conéctate a AlloyDB para PostgreSQL

En este documento, se describe cómo crear un almacén de datos que se conecte a los datos de AlloyDB para PostgreSQL. Puedes vincular este almacén de datos a una app de Gemini Enterprise para permitir que los agentes analicen tus datos.

Para conectarte a los datos de AlloyDB para PostgreSQL con un almacén de datos de Gemini Enterprise, puedes usar uno de los siguientes modos:

• Consulta federada (recomendada) [Versión preliminar]: Conéctate a los datos de AlloyDB para PostgreSQL sin incurrir en costos de salida por copiar y mover los datos. La consulta federada envía tu consulta directamente a AlloyDB para PostgreSQL en todos los clústeres, las bases de datos y las tablas a las que tu identidad tiene permiso de Identity and Access Management (IAM) para acceder, lo que es más eficiente para las consultas analíticas. Cuando usas el modo de consulta federada, Knowledge Catalog se habilita automáticamente en la pestaña Asistente de tu app de Gemini Enterprise para darle al agente herramientas que le permitan buscar datos a los que el usuario tiene acceso y buscar contexto.

  Precaución: Consultas de bases de datos de alta precisión: El modo de consulta federada proporciona un acceso amplio a todos los clústeres y bases de datos a los que puede acceder el usuario, pero la precisión de la consulta puede variar en esquemas transaccionales complejos. Para las cargas de trabajo que requieren precisión alta, determinación del alcance de la tabla y consultas verificadas (SQL de referencia), crea un agente de datos con alcance en AlloyDB para PostgreSQL y publícalo en Gemini Enterprise.

• Ingesta de datos: Copia datos de una tabla específica de AlloyDB para PostgreSQL en el almacén de datos de Gemini Enterprise. Los datos se deben actualizar de forma manual para reflejar los cambios en la tabla de AlloyDB para PostgreSQL. Este modo genera costos de salida por mover datos a una ubicación nueva, y los permisos de IAM existentes no se replican en el almacén de datos.

Antes de comenzar

Para crear un almacén de datos de AlloyDB para PostgreSQL en Gemini Enterprise, debes tener el rol de administrador de Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) o administrador de Discovery Engine (roles/discoveryengine.admin). Para obtener más información, consulta Otorga permisos a los administradores.

Si tu proyecto está protegido por un perímetro de Controles del servicio de VPC o tiene habilitada la aplicación de la política de la organización, asegúrate de que la política de la organización permita el conector:

• Agrega alloydb al parámetro allowedDataSources en la restricción administrada discoveryengine.managed.allowedDataSources (Restringe las fuentes de datos permitidas para los conectores de datos). Para obtener más información, consulta Descripción general de las restricciones de políticas administradas y Configura fuentes de datos permitidas.

Además, configura los permisos de IAM de AlloyDB para PostgreSQL necesarios para el modo de conector que planeas usar:

Consulta federada

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para conectarte a AlloyDB para PostgreSQL con el modo de consulta federada, otorga los siguientes roles de IAM en el proyecto de Google Cloud que contiene tu clúster de AlloyDB para PostgreSQL a los usuarios que consultan o realizan acciones a través del conector:

• Acceso a clústeres y bases de datos:
  • Visualizador de Cloud AlloyDB (roles/alloydb.viewer) y Cliente de Cloud AlloyDB (roles/alloydb.client) (o Usuario de base de datos de Cloud AlloyDB (roles/alloydb.databaseUser) con autenticación de base de datos de IAM) para consultas y herramientas de solo lectura.
  • Administrador de Cloud AlloyDB (roles/alloydb.admin) si las acciones de escritura o administración de clústeres (como crear clústeres, instancias o copias de seguridad, o ejecutar escrituras de SQL) están habilitadas.
• Acceso a las herramientas de MCP:
  • Permiso de usuario de la herramienta de MCP (roles/mcp.toolUser) en el proyecto de Google Cloud en el que reside el clúster de AlloyDB para PostgreSQL para invocar herramientas de MCP.

Ingesta de datos

Para transferir datos de un proyecto de Google Cloud de origen que sea diferente del proyecto de Google Cloud que contiene el almacén de datos de Gemini Enterprise que estás creando, otorga el rol de administrador de AlloyDB de Cloud (roles/alloydb.admin) en el proyecto de AlloyDB para PostgreSQL de origen a la cuenta de servicio de [e-mail] (en la que PROJECT_NUMBER es el número del proyecto deGoogle Cloud que contiene el almacén de datos de Gemini Enterprise).

Precaución: Si eliges transferir datos de AlloyDB para PostgreSQL a un almacén de datos de Gemini Enterprise, los permisos de AlloyDB para PostgreSQL no se importan con los datos. Después de la importación, cualquier usuario con permisos suficientes de Gemini Enterprise puede ver los datos, incluso si no tiene permiso para verlos en AlloyDB para PostgreSQL.

Crea un almacén de datos de AlloyDB para PostgreSQL

Para crear un almacén de datos que conecte los datos de AlloyDB para PostgreSQL con Gemini Enterprise, sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Gemini Enterprise.

   Gemini Enterprise

2. Ve a la página Almacenes de datos.

3. Haz clic en Crear almacén de datos.

4. En la página Fuente, elige una fuente de datos para tu almacén de datos. Busca "AlloyDB para PostgreSQL" en el campo de búsqueda Selecciona una fuente de datos o busca AlloyDB para PostgreSQL en la lista de fuentes de datos propias. Selecciona Agregar fuente de datos.

5. En la página Datos, selecciona el modo de conector para conectarte a tus datos. Selecciona una de las siguientes pestañas para obtener más instrucciones según el modo que hayas elegido.

   Consulta federada

   Vista previa

   Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

   1. Selecciona Consulta federada (recomendada). Haga clic en Continuar.
   2. En la página Acciones, selecciona las acciones de AlloyDB para PostgreSQL que deseas habilitar para tu almacén de datos. Puedes editar estos parámetros de configuración más adelante. Haz clic en Continuar.

   Ingesta de datos

   1. Selecciona Ingesta de datos.
   2. Especifica los detalles de los datos que quieres importar. En Importa datos de tu tabla de AlloyDB para PostgreSQL, especifica la siguiente información:
      • ID del proyecto: Es el proyecto de Google Cloud que contiene la tabla de AlloyDB para PostgreSQL. Este es un campo obligatorio.
      • ID de ubicación: Es el ID de ubicación de AlloyDB para PostgreSQL que contiene los datos que quieres importar. Este es un campo obligatorio.
      • ID del clúster: Es el ID del clúster de AlloyDB para PostgreSQL que contiene los datos que deseas importar. Este es un campo obligatorio.
      • ID de la base de datos: Es el ID de la base de datos de AlloyDB para PostgreSQL que contiene los datos que deseas importar. Este es un campo obligatorio.
      • ID de la tabla: Es el ID de la tabla de AlloyDB para PostgreSQL que contiene los datos que deseas importar. Este es un campo obligatorio.
   3. Haz clic en Continuar.

6. En la página Configuración, establece los parámetros de configuración de tu almacén de datos.

   • Ubicación de tu conector de datos: Elige una región para almacenar los metadatos de tu almacén de datos. No puedes cambiar la ubicación después de crear el almacén de datos. Para obtener información importante sobre las multirregiones, consulta Ubicaciones de Gemini Enterprise.
   • Nombre de tu conector de datos: En el campo Nombre del conector de datos, ingresa un nombre para tu conector de datos. No puedes cambiar el nombre después de crear el conector de datos. Cuando ingresas un nombre, se genera un ID único para tu conector de datos. De forma opcional, en el campo Etiqueta (opcional), ingresa una etiqueta para tu conector de datos, que sirve como un identificador estable para el conector en todas las versiones.
   • Política de Sensitive Data Protection: Selecciona una política de Sensitive Data Protection para tu almacén de datos. El formato debe ser el siguiente: projects/{project}/locations/{location}/contentPolicies/{policy}. Puedes editar este parámetro de configuración más adelante.

7. Haz clic en Crear.

Ya puedes adjuntar tu almacén de datos a una app de Gemini Enterprise. En el modo de consulta federada, las consultas generan costos de uso de AlloyDB para PostgreSQL cuando los usuarios ejecutan consultas a través de la app adjunta. En el modo de ingesta de datos, la importación de datos genera costos de indexación de AlloyDB para PostgreSQL y Gemini Enterprise incluso antes de que el almacén de datos se adjunte a una app. Para obtener más información sobre estos cargos, consulta los precios de Gemini Enterprise.

Próximos pasos

• Para adjuntar tu almacén de datos a una app, crea una app y selecciona tu almacén de datos siguiendo los pasos que se indican en Crea una app de Gemini Enterprise.

• Obtén más información sobre cómo funciona Knowledge Catalog con los conectores de Data Cloud (se habilitan automáticamente cuando usas el modo de consulta federada) para ayudar al agente a buscar datos a los que el usuario tiene acceso y consultar el contexto organizacional.

• Para compilar un agente de alta precisión y alcance con consultas verificadas, consulta Publica un agente de datos de AlloyDB para PostgreSQL en Gemini Enterprise.