Conectarse a BigQuery

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

Para conectarte a datos de BigQuery 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 BigQuery en su lugar sin incurrir en costos de salida por copiar y mover los datos. La consulta federada envía tu consulta directamente a BigQuery en todos los conjuntos de datos y las tablas a los que tu identidad tiene permiso de Identity and Access Management (IAM) para acceder, lo que es más eficiente para las consultas analíticas. Debido a que las consultas se ejecutan con tus credenciales, los permisos de IAM de BigQuery, incluida la seguridad a nivel de la fila, permanecen intactos. 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.
• Transferencia de datos: Copia datos de una tabla de BigQuery específica al almacén de datos de Gemini Enterprise. Los datos deben actualizarse para reflejar los cambios en la tabla de BigQuery. 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 BigQuery en Gemini Enterprise, debes tener el rol de administrador de Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) o el rol de 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 políticas de la organización, asegúrate de que tu política de la organización permita el conector:

• Agrega bigquery_mcp 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 las fuentes de datos permitidas.

Además, configura los permisos de IAM de BigQuery 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.

El modo de consulta federada usa el servidor de MCP de BigQuery. Debido a que diferentes herramientas de MCP (acciones) requieren permisos diferentes, los permisos de IAM necesarios dependen de las herramientas que uses. Para obtener más información, consulta Roles requeridos en la documentación de MCP de BigQuery.

Los siguientes son los roles de IAM que se aplican con mayor frecuencia a los usuarios que consultan o realizan acciones a través del conector:

• Usuario de trabajo de BigQuery (roles/bigquery.jobUser) en el proyecto de BigQuery Google Cloud en el que se ejecuta la consulta (proyecto de procesamiento o facturación) para permitir que los usuarios ejecuten trabajos de consulta
• Visualizador de datos de BigQuery (roles/bigquery.dataViewer) en el proyecto de BigQuery Google Cloud en el que se almacenan los datos (proyecto de almacenamiento) para permitir que los usuarios accedan a los datos en una consulta o a través de herramientas de metadatos de BigQuery, como get_table_info. (si las acciones de escritura están habilitadas, otorga Editor de datos de BigQuery (roles/bigquery.dataEditor) en su lugar)
• Usuario de la herramienta MCP (roles/mcp.toolUser) en el proyecto de almacenamiento y en el proyecto de procesamiento de BigQuery Google Cloud Google Cloud

Transferencia de datos

Para transferir datos desde un proyecto de origen que es diferente del proyecto que contiene el almacén de datos de Gemini Enterprise que estás creando, otorga los siguientes roles de IAM en el proyecto de BigQuery de origen a la cuenta de servicio [e-mail] (en la que PROJECT_NUMBER es el número del proyecto que contiene el almacén de datos de Gemini Enterprise): Google Cloud Google Cloud Google Cloud

• Usuario de trabajo de BigQuery (roles/bigquery.jobUser)
• Editor de datos de BigQuery (roles/bigquery.dataEditor)

Precaución: Si eliges transferir datos de BigQuery a un almacén de datos de Gemini Enterprise, los permisos de BigQuery no se importarán 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 BigQuery.

Crea un almacén de datos de BigQuery

Para crear un almacén de datos que conecte datos de BigQuery 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 "BigQuery" en el campo de búsqueda Selecciona una fuente de datos o encuentra BigQuery 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).
   2. De manera opcional, en Opciones avanzadas, especifica el Google Cloud proyecto de facturación para la ejecución de consultas de tu almacén de datos. Para ello, ingresa el ID del proyecto en el campo ID del proyecto de facturación. Si dejas este campo vacío, las consultas le solicitarán al usuario un proyecto de facturación o se basarán en instrucciones personalizadas.
   3. Haz clic en Continuar.
   4. En la página Acciones, selecciona las acciones de BigQuery 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. Determina qué tipo de datos importarás. Antes de importar tus datos, revisa Prepara los datos para la transferencia.
      • Si importas datos estructurados, selecciona Tabla de BigQuery con tu propio esquema o Tabla de BigQuery con metadatos. Si usas tu propio esquema, este se detectará automáticamente durante la importación. Si usas metadatos, debes definir un esquema especificado por Google durante la importación.
      • Si importas datos que requieren un procesamiento especializado, selecciona una de las opciones en Importación de datos especializados.

   3. En Frecuencia de sincronización, selecciona la frecuencia con la que deseas importar datos de tu tabla de BigQuery. Esta opción no se puede cambiar después de crear el almacén de datos.

      • Selecciona Una vez para una sola importación.
      • Selecciona Periódico para establecer un programa de importación recurrente.

   4. Selecciona la tabla de datos que deseas importar. En el campo Ruta de acceso de BigQuery , haz clic en Explorar , selecciona una tabla que hayas preparado para la transferencia y, luego, haz clic en Seleccionar. Como alternativa, ingresa la ubicación de la tabla directamente en el campo Ruta de acceso de BigQuery.

   5. Haz clic en Continuar.

   Después de crear tu almacén de datos, puedes verificar el estado de la transferencia. Para ello, ve a la página Almacenes de datos y haz clic en el nombre del almacén de datos para ver sus detalles en la página Datos. Cuando la columna de estado de la pestaña Actividad cambie de En curso a Se completó la importación, se habrá completado la transferencia.

   Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

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 en la que se almacenarán 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 ser el siguiente: 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 procesamiento de BigQuery 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 BigQuery 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 con consultas verificadas en BigQuery, consulta Publica un agente de datos de BigQuery en Gemini Enterprise.