Conectar a Cloud SQL

En este documento, se describe cómo crear un almacén de datos que se conecta a datos de Cloud SQL. 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 Cloud SQL con un almacén de datos de Gemini Enterprise, puedes usar uno de los siguientes modos:

• Consulta federada (recomendada) [Vista previa]: Conéctate a los datos de Cloud SQL en su lugar sin incurrir en costos de salida por copiar y mover los datos. La consulta federada envía tu consulta directamente a Cloud SQL en todas las instancias, bases de datos y 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 proporcionar al agente herramientas para 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 todas las instancias y bases de datos a las 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 alta precisión, alcance determinista de la tabla y consultas verificadas (SQL dorado), crea un agente de datos con alcance en Cloud SQL para MySQL o Cloud SQL para PostgreSQL y publícalo en Gemini Enterprise.

• Transferencia de datos: Copia datos de una tabla específica de Cloud SQL al almacén de datos de Gemini Enterprise. Los datos deben actualizarse de forma manual para reflejar los cambios en la tabla de Cloud SQL. 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 Cloud SQL en Gemini Enterprise, debes tener el rol deadministrador de Gemini Enterprise(roles/discoveryengine.agentspaceAdmin) oadministrador 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 tu organización permita el conector:

• Agrega cloudsql al parámetro allowedDataSources en la discoveryengine.managed.allowedDataSources restricción administrada (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 las fuentes de datos permitidas.

Además, completa los requisitos previos y configura los permisos de IAM de Cloud SQL necesarios para el modo de conector que planeas usar:

Consulta federada

Vista previa

Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales 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 Cloud SQL con el modo de consulta federada, completa los siguientes requisitos previos en el Google Cloud proyecto que contiene tu instancia de Cloud SQL:

1. Habilita la API de Data en tu instancia de Cloud SQL:

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

2. Otorga permisos de IAM: Otorga los siguientes roles de IAM en el Google Cloud proyecto que contiene tu instancia de Cloud SQL a los usuarios que consultan o realizan acciones a través del conector:

   • Acceso a la instancia y a la base de datos:
     • Visualizador de Cloud SQL (roles/cloudsql.viewer) y Cliente de Cloud SQL (roles/cloudsql.client) (o Usuario de instancia de Cloud SQL (roles/cloudsql.instanceUser) con autenticación de base de datos de IAM) para consultas y herramientas de solo lectura
     • Editor de Cloud SQL (roles/cloudsql.editor) o Administrador de Cloud SQL (roles/cloudsql.admin) si se habilitan las acciones de escritura o administrativas
   • Acceso a la herramienta MCP:
     • Permiso de usuario de la herramienta MCP (roles/mcp.toolUser) en el proyecto en el que reside la instancia de Cloud SQL para invocar herramientas de MCP

Transferencia de datos

Para transferir datos desde Cloud SQL, configura los siguientes permisos de IAM:

• Acceso al bucket de etapa de pruebas: Cuando se transfieren datos desde Cloud SQL, primero se almacenan en un bucket de Cloud Storage. Otorga el rol de administrador de almacenamiento (roles/storage.admin) en el bucket intermedio de Cloud Storage a la cuenta de servicio de tu instancia de Cloud SQL (por ejemplo, [e-mail]).
• Acceso a Cloud SQL entre proyectos: Si importas datos desde un proyecto Google Cloud de origen que es diferente del Google Cloud proyecto que contiene el almacén de datos de Gemini Enterprise que estás creando, otorga el rol de visualizador de Cloud SQL (roles/cloudsql.viewer) en el proyecto de Cloud SQL de origen a la cuenta de servicio [e-mail] (donde PROJECT_NUMBER es el número del Google Cloud proyecto que contiene el almacén de datos de Gemini Enterprise).

Precaución: Si eliges transferir datos de Cloud SQL a un almacén de datos de Gemini Enterprise, los permisos de Cloud SQL 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 Cloud SQL.

Crea un almacén de datos de Cloud SQL

Para crear un almacén de datos que conecte datos de Cloud SQL a Gemini Enterprise, sigue estos pasos:

1. En la Google Cloud consola de, 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 "Cloud SQL" en el campo de búsqueda Selecciona una fuente de datos o encuentra Cloud SQL 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 elegiste.

   Consulta federada

   Vista previa

   Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales 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). Haz clic en Continuar.
   2. En la página Acciones, selecciona las acciones de Cloud SQL que deseas habilitar para tu almacén de datos. Puedes editar estos parámetros de configuración más adelante. Haz clic en Continuar.

   Transferencia de datos

   1. Selecciona Transferencia de datos.
   2. Especifica los detalles sobre los datos que deseas importar. En Importar datos desde tu tabla de Cloud SQL, especifica la siguiente información:
      • ID del proyecto: Es el Google Cloud proyecto que contiene la tabla de Cloud SQL. Este es un campo obligatorio.
      • ID de instancia: Es el ID de la instancia de Cloud SQL que contiene los datos que deseas importar. Este es un campo obligatorio.
      • ID de base de datos: Es el ID de la base de datos de Cloud SQL que contiene los datos que deseas importar. Este es un campo obligatorio.
      • ID de tabla: Es el ID de la tabla de Cloud SQL que contiene los datos que deseas importar. Este es un campo obligatorio.
      • Ingresa la ubicación del bucket de Google Cloud Storage para los datos. Este campo es obligatorio. De manera opcional, selecciona Habilitar la exportación sin servidores para usar la exportación sin servidores de Cloud SQL. Si habilitas la exportación sin servidores, se generará un costo adicional. Consulta los precios de la exportación sin servidores de Cloud SQL.
   3. Haz clic en Continuar.

6. En la página Configuración, configura 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. Si ingresas un nombre, se generará un ID único para tu conector de datos. De manera 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 seguir el siguiente patrón: projects/{project}/locations/{location}/contentPolicies/{policy}. Puedes cambiar este parámetro de configuración más tarde.

7. Haz clic en Crear.

Ahora 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 Cloud SQL cuando los usuarios ejecutan consultas a través de la app adjunta. En el modo de transferencia de datos, la importación de datos genera costos de indexación de Cloud SQL, Cloud Storage 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 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 información sobre cómo Knowledge Catalog funciona con los conectores de Data Cloud (habilitados automáticamente cuando usas el modo de consulta federada) para ayudar al agente a buscar datos a los que el usuario tiene acceso y buscar contexto organizacional.

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