Conectarse a Google BigQuery

BigQuery es un almacén de datos de analíticas totalmente gestionado de Google, asequible y escalable a petabytes. El conector de BigQuery de Data Studio te permite acceder y visualizar datos de tus tablas de BigQuery, vistas, gráficos y consultas de SQL personalizadas directamente en Data Studio.

Antes de empezar

Para acceder a los datos de BigQuery en Data Studio, debes proporcionar un Google Cloud proyecto que tenga asociada una cuenta de facturación de Google Cloud.

BigQuery es una plataforma de analíticas de pago. Es posible que se te cobren costes de procesamiento o almacenamiento de consultas cuando accedas a datos de BigQuery a través de informes de Data Studio. Para obtener más información sobre los precios de las consultas y la capacidad, consulta los precios de BigQuery.

Roles obligatorios

Para consultar datos de BigQuery en Data Studio, necesitas permiso para leer datos y ejecutar tareas de consulta. Concede los siguientes roles de gestión de identidades y accesos en tu proyecto o conjunto de datos de Google Cloud :

  • Lector de datos de BigQuery (roles/bigquery.dataViewer): te permite leer datos y metadatos de tablas, vistas o gráficos.
  • Usuario de tareas de BigQuery (roles/bigquery.jobUser): te permite ejecutar tareas de consulta en el proyecto de facturación.

Los roles necesarios dependen del modo de credenciales de acceso a datos que selecciones para tu fuente de datos:

  • Credenciales de propietario (predeterminadas): solo el propietario de la fuente de datos necesita estos roles. Los lectores de informes pueden ver gráficos sin necesidad de tener acceso a BigQuery.
  • Credenciales de lector: todos los lectores de informes deben tener estos roles para ver los datos del informe.
  • Credenciales de la cuenta de servicio: solo la cuenta de servicio necesita estos roles. Para configurar una cuenta de servicio, consulta Configurar una Google Cloud cuenta de servicio para Data Studio.

Claves de encriptado gestionadas por el cliente (CMEK)

Data Studio puede consultar tablas de BigQuery protegidas por claves de cifrado gestionadas por el cliente (CMEK) sin necesidad de configurar nada más en Data Studio. Sin embargo, cuando Data Studio ejecuta un trabajo de consulta, BigQuery escribe los resultados de la consulta en una tabla temporal del proyecto de facturación. El conector de BigQuery de Data Studio no transfiere una clave de Cloud Key Management Service en las solicitudes de tareas de consulta.

Si tu proyecto de facturación aplica la restricción de política de organización constraints/gcp.restrictNonCmekServices para BigQuery, debes definir una clave de Cloud KMS predeterminada del proyecto en BigQuery para la ubicación del conjunto de datos. Si defines una clave predeterminada para el proyecto, BigQuery podrá cifrar automáticamente las tablas de resultados de consultas temporales y evitar errores CONDITION_NOT_MET.


Conectarse a BigQuery

Sigue estos pasos para conectar tus datos de BigQuery a un informe de Data Studio:

Pasos para conectarse

  1. Inicia sesión en Data Studio.
  2. Haz clic en Crear y, a continuación, selecciona Informe.
  3. Se abrirán el editor de informes y el panel Añadir datos al informe.
  4. Para crear una fuente de datos insertada, selecciona el conector de BigQuery.
    • Alternativa: Para usar una fuente de datos reutilizable que ya tengas, haz clic en la pestaña Mis fuentes de datos y selecciona una fuente de datos de cualquier tipo que hayas creado anteriormente o que se haya compartido contigo.
  5. Configura el acceso a tu base de datos utilizando una de las opciones de conexión.
  6. Haz clic en Añadir.

En unos instantes, se mostrará en el lienzo del informe una tabla conectada a la fuente de datos.


Opciones de conexión

Una fuente de datos de BigQuery puede obtener datos de una tabla, vista o gráfico, o de una consulta de SQL personalizada.

Conectarse a una tabla, vista o gráfico de BigQuery

Una tabla de BigQuery almacena datos en filas y columnas (campos). Las vistas de BigQuery son tablas virtuales definidas por una consulta de SQL que se ejecuta de forma dinámica en la consola de BigQuery o mediante la API de BigQuery. Un grafo de BigQuery te permite modelar relaciones en tus datos definiendo nodos y bordes basados en tablas ya creadas.

Para conectarte a una tabla, vista o gráfico, especifica los siguientes parámetros de conexión:

  • Un proyecto de BigQuery
  • Un conjunto de datos
  • Una tabla, vista o gráfico concretos. Data Studio también permite conectarse a tablas con particiones de fecha y de varios días.

Selecciona un proyecto

Los proyectos organizan tus recursos de Google Cloud y determinan dónde se facturan los costes de las consultas cuando tus informes superan los límites de BigQuery. Puedes consultar datos de un proyecto y facturar los costes a otro proyecto. Google Cloud Más información sobre los proyectos

Elige una de las siguientes opciones en el panel de configuración del conector:

  • PROYECTOS RECIENTES: muestra los proyectos que has abierto recientemente en la Google Cloud consola. También puedes introducir el ID de proyecto manualmente. El proyecto seleccionado se usa tanto para la facturación como para el acceso a datos.
  • MIS PROYECTOS: muestra todos los proyectos a los que tienes acceso. Si falta un proyecto en la lista, escribe su ID exacto en el campo de entrada.
  • PROYECTOS COMPARTIDOS: muestra los proyectos compartidos entre departamentos u organizaciones. Puedes designar diferentes proyectos para la selección de datos y la ejecución de la facturación.

Selecciona un conjunto de datos

Los conjuntos de datos organizan y controlan el acceso a grupos de tablas, vistas y gráficos. Selecciona un conjunto de datos de la lista o busca uno por su ID.

Los conjuntos de datos públicos de BigQuery son conjuntos de datos de muestra sin coste que se comparten de forma global en Google. Para consultar datos públicos, debes elegir un proyecto de facturación con el que pagar los costes de procesamiento de las consultas.

Seleccionar una tabla, una vista o un gráfico

Puedes conectar una fuente de datos de Data Studio a una sola tabla, vista o gráfico. En la lista Tabla o Tabla/Gráfico, selecciona un recurso o busca uno por su nombre. Cuando un conjunto de datos contiene gráficos, las tablas y los gráficos muestran iconos distintos para que puedas diferenciarlos.

Si seleccionas un gráfico, también puedes seleccionar un nodo de inicio en la lista Nodo de inicio. El nodo de inicio determina el punto de partida del recorrido del gráfico y afecta al esquema de la tabla plana. En función de la definición del grafo, puede que sea necesario seleccionar un nodo de inicio.

Probar un conjunto de datos de grafos públicos

Puedes probar el conector de BigQuery Graph usando el gráfico de comercio electrónico de Look, que está disponible públicamente. Para conectarte a este gráfico, sigue estos pasos:

  1. Selecciona PROYECTOS COMPARTIDOS.
  2. Selecciona tu proyecto de facturación.
  3. Introduce bigquery-public-data como nombre del proyecto compartido.
  4. Selecciona thelook_ecommerce como conjunto de datos.
  5. Selecciona graph en la lista Tabla/Gráfico.
  6. Opcional: Selecciona un nodo de inicio en la lista Nodo de inicio.

Trabajar con medidas de BigQuery Graph

Cuando te conectas a un grafo de BigQuery, las medidas que se definen en el grafo se importan como métricas en tu fuente de datos. Puedes usar estas medidas en gráficos, campos calculados, variables de resultados de consultas y controles de fuentes de datos.

Ten en cuenta lo siguiente cuando trabajes con medidas de gráficos:

  • Agregación fija: no puedes cambiar el tipo de agregación de una medida de gráfico en Data Studio. La agregación se determina según la definición del gráfico en BigQuery.
  • Propiedades editables: puedes editar el tipo de datos y la descripción de una medida de gráfico en tu fuente de datos de Data Studio.

Conectarse a tablas con particiones de fecha

Data Studio admite tablas con particiones por fecha de BigQuery (DATE, DATETIME o TIMESTAMP). Al seleccionar una tabla con particiones por DATE, DATETIME o TIMESTAMP, puedes definir la columna de partición como el filtro de fecha principal de tus gráficos. Si usas tablas con particiones, tus gráficos se renderizarán más rápido y se minimizarán los costes de las consultas.

Más información sobre cómo conectarse a tablas con particiones de fecha de BigQuery

Conectarse a tablas multidía (prefijo YYYYMMDD)

BigQuery admite consultas en varias tablas fragmentadas, en las que cada tabla almacena datos de un único día y termina con YYYYMMDD (por ejemplo, [prefix]_YYYYMMDD).

Cuando Data Studio encuentra tablas con el formato de sufijo YYYYMMDD durante la selección de tablas, agrupa las tablas diarias con nombres de prefijo claros ([prefix]_YYYYMMDD). Cuando creas un gráfico a partir de una tabla de varios días, Data Studio solo consulta automáticamente los datos de los últimos 28 días. Puedes cambiar este periodo en cualquier momento editando las propiedades de Periodo en la pestaña Configuración del gráfico.


Conectarse a BigQuery mediante una consulta de SQL personalizada

La opción CONSULTA PERSONALIZADA te permite conectar con tus datos escribiendo código SQL, incluidas las consultas de un gráfico de BigQuery. La sintaxis de las consultas personalizadas sigue el dialecto SQL estándar. Para usar la sintaxis SQL antigua, selecciona Usar SQL antiguo.

Te recomendamos que crees y pruebes tu consulta directamente en la consola de BigQuery y, a continuación, copies y pegues la secuencia de comandos SQL verificada en el cuadro del editor de consultas personalizadas de Data Studio.

Anular el proyecto de facturación

El ajuste Proyecto de facturación te permite especificar qué Google Cloud proyecto paga los costes de ejecución de las consultas personalizadas. Si tu organización opera en muchos proyectos, puedes introducir manualmente el ID de proyecto de facturación en el campo.

Para consultar datos de un proyecto mientras se factura otro, especifica el proyecto de facturación en este campo y haz referencia explícita al proyecto de datos en la cláusula FROM de tu consulta (FROM project_id.dataset_id.table_id).

Ejemplo de configuración de una consulta personalizada de BigQuery: el proyecto de facturación está configurado como proyecto de Looker Studio y la consulta especifica un conjunto de datos públicos de BigQuery en la cláusula FROM de la consulta.

Usar parámetros de consulta

Los parámetros permiten crear informes personalizables con mayor capacidad de respuesta. Puedes transferir parámetros de una fuente de datos de BigQuery a la consulta subyacente. Si quieres usar un parámetro en una consulta personalizada, sigue las directrices de sintaxis para ejecutar consultas con parámetros en BigQuery.

Para ver las instrucciones de configuración completas, las reglas de sintaxis de los parámetros y la configuración de seguridad a nivel de fila mediante parámetros (@DS_START_DATE, @DS_END_DATE y @DS_USER_EMAIL), consulta el artículo Usar parámetros en una consulta personalizada.


Notas y consejos

A continuación, te ofrecemos algunas notas y consejos para que puedas sacar el máximo partido a tus fuentes de datos de BigQuery.

¿Es la primera vez que usas Data Studio?

Para obtener más información sobre las funciones principales de los informes de Data Studio, consulta los siguientes recursos:

se integra con BigQuery

Algunos productos de Google y herramientas externas permiten exportar datos directamente a tablas de BigQuery. Cuando conectas Data Studio a BigQuery, Data Studio calcula automáticamente las métricas estándar y da formato a los nombres de los campos:

  • Explorar datos de BigQuery en Data Studio: los analistas de datos pueden explorar datos de BigQuery usando Data Studio directamente desde la consola de BigQuery. Ejecuta una consulta o selecciona una tabla y, a continuación, selecciona Explorar en Data Studio para ver los datos en un informe interactivo. Para obtener más información, consulta el artículo Analizar datos con Data Studio.
  • BigQuery Export de Google Analytics: cuando Data Studio identifica una tabla generada por BigQuery Export de Google Analytics, se muestra un icono de Google Analytics junto a la tabla. Cuando conectas una tabla, Data Studio crea automáticamente muchas de las métricas estándar que se encuentran en Google Analytics como campos calculados.

Métrica Recuento de registros

Cada fuente de datos de BigQuery incluye automáticamente la métrica Recuento de registros en la lista de campos. Usa Record Count en los gráficos para contar registros o verificar el total de filas que devuelve tu consulta.

Ver polígonos GEOGRAPHY de BigQuery

Puedes mostrar límites geoespaciales (datos espaciales de polígonos GEOGRAPHY) de BigQuery usando Google Maps en tu informe. Para ver un tutorial detallado sobre cómo usar datos de secciones censales públicos, consulta el artículo Ver polígonos GEOGRAPHY de BigQuery con Data Studio.

Solucionar errores y revisar limitaciones

Si tus gráficos no se cargan o devuelven advertencias de configuración, consulta la guía Solucionar errores y limitaciones del conector de BigQuery.