Google BigQuery

Descripción general

En esta página, se explica cómo configurar una conexión en Looker a SQL estándar de Google BigQuery o SQL heredado de Google BigQuery.

Los pasos generales para configurar una conexión de SQL estándar de Google BigQuery o de SQL heredado de Google BigQuery son los siguientes:

  1. En tu base de datos de BigQuery, configura la autenticación que usará Looker para acceder a tu base de datos de BigQuery. Looker admite las siguientes opciones de autenticación para BigQuery:

  2. En su base de datos de BigQuery, si desea usar tablas derivadas persistentes (PDT) en la conexión, cree un conjunto de datos temporal que Looker pueda usar para crear PDT en su base de datos. Consulta la sección Crea un conjunto de datos temporal para tablas derivadas persistentes en esta página a fin de conocer el procedimiento.

  3. En Looker, configura la conexión de Looker a tu base de datos de BigQuery. Consulta la sección Conecta Looker a BigQuery en esta página para ver el procedimiento.

  4. En Looker, prueba la conexión entre Looker y tu base de datos de BigQuery. Consulta la sección Prueba la conexión en esta página para conocer el procedimiento.

Autenticación con cuentas de servicio de BigQuery

Una forma de que Looker pueda autenticarse en su base de datos de BigQuery es con una cuenta de servicio de BigQuery. Cree la cuenta de servicio en su base de datos de BigQuery con el Administrador de API en la consola de Google Cloud. Debes tener permisos de administrador de Google Cloud para crear la cuenta de servicio. Google tiene documentación sobre cómo crear una cuenta de servicio y generar una clave privada.

Crea una cuenta de servicio y descarga el certificado de credenciales JSON

Sigue estos pasos para crear una cuenta de servicio de BigQuery:

  1. Abre la página de credenciales en el Administrador de API de la consola de Google Cloud y selecciona tu proyecto.

  2. Selecciona CREAR CREDENCIALES y elige Cuenta de servicio.

  3. Ingresa un nombre para la cuenta de servicio nueva, agrega una descripción (opcional) y selecciona CREAR Y CONTINUAR.

  4. Tu cuenta de servicio requiere dos funciones predefinidas de Google BigQuery:

    • BigQuery > Editor de datos de BigQuery
    • BigQuery > Usuario de trabajo de BigQuery

    Seleccione la primera función en el campo Selecciona una función, elija AGREGAR OTRA FUNCIÓN y, luego, seleccione la segunda función.

    Después de seleccionar ambas funciones, selecciona CONTINUAR y, luego, LISTO.

  5. En la página Credenciales, selecciona tu cuenta de servicio nueva:

  6. Seleccione KEYS y, luego, ADD KEY. Luego, en el menú desplegable, elija Create new key:

  7. Selecciona JSON en Tipo de clave y, luego, CREAR:

  8. La clave JSON se guardará en tu computadora.

    Después de anotar la ubicación de descarga, selecciona CLOSE.

  9. Selecciona LISTO.

  10. Busca la dirección de correo electrónico que corresponde a la cuenta de servicio. Necesitarás esta dirección para configurar la conexión de Looker a BigQuery:

  11. Una vez que crees la cuenta de servicio en tu base de datos de BigQuery, ingresarás esta información y los detalles del archivo de certificado en los campos Correo electrónico de la cuenta de servicio, Archivo JSON/P12 de la cuenta de servicio y Contraseña de la ventana Conexiones de Looker cuando configures la conexión de Looker a BigQuery.

Autenticación con OAuth

Looker admite OAuth para las conexiones de Google BigQuery, lo que significa que cada usuario de Looker se autentica ante Google con sus propias credenciales de Google OAuth y autoriza a Looker para que acceda a la base de datos.

OAuth permite que los administradores de bases de datos realicen las siguientes funciones:

  • Audita qué usuarios de Looker ejecutan consultas en la base de datos
  • Aplica controles de acceso basados en roles con los permisos de Google
  • Usa tokens de OAuth para todos los procesos y acciones que acceden a Google BigQuery, en lugar de incorporar IDs y contraseñas de BigQuery en varios lugares

Para conexiones de BigQuery con OAuth:

  • Si un administrador de base de datos cambia las credenciales del cliente de OAuth para BigQuery, se verán afectados los programas o las alertas que posee un usuario. Los usuarios deben volver a acceder si el administrador cambia las credenciales de OAuth de BigQuery. Los usuarios también pueden ir a la página Cuenta de Looker desde la página de la cuenta de perfil de usuario para acceder a Google.
  • Debido a que las conexiones de BigQuery que usan OAuth son “por usuario”, las políticas de almacenamiento en caché también son por usuario y no solo por consulta. Esto significa que, en lugar de usar los resultados almacenados en caché cada vez que se ejecute la misma consulta dentro del período de almacenamiento en caché, Looker usará los resultados almacenados en caché solo si el mismo usuario ejecutó la misma consulta dentro del período de almacenamiento en caché. Para obtener más información sobre el almacenamiento en caché, consulta la página de documentación sobre el almacenamiento en caché de consultas.
  • Si desea usar tablas derivadas persistentes (PDT) en una conexión de BigQuery con OAuth, debe crear una cuenta de servicio adicional para que Looker acceda a su base de datos a los procesos de PDT. Consulta la sección Tablas derivadas persistentes en una conexión de BigQuery en esta página para obtener más información.
  • Los administradores, cuando actúen como otro usuario, usarán el token de autorización de OAuth de ese usuario. Consulta la página de documentación de Usuarios a fin de obtener información para usar el comando sudo.

Configura un proyecto de base de datos de BigQuery para OAuth

En las siguientes secciones, se describe cómo generar credenciales de OAuth y cómo configurar una pantalla de consentimiento de OAuth. Si ya configuraste una pantalla de consentimiento de OAuth para otra aplicación de tu proyecto, no tendrás que crear otra; solo configurarás una pantalla de consentimiento para todas las aplicaciones de un proyecto.

Las credenciales de OAuth y la pantalla de consentimiento de OAuth deben configurarse en Google Cloud Console. La descripción genérica de Google se encuentra en el sitio de asistencia de Google Cloud y en el sitio de Google Dev Console.

Según el tipo de usuarios que accedan a los datos de BigQuery en Looker y si sus datos de BigQuery son públicos o privados, es posible que OAuth no sea el método de autenticación más adecuado. Del mismo modo, el tipo de datos solicitados al usuario y el grado de acceso necesario a estos cuando se autentica en Google para usar Looker puede requerir la verificación de Google. Obtén más información sobre la verificación en la sección Cómo generar credenciales de Google OAuth en esta página.

Generando credenciales de Google OAuth

  1. Ve a la consola de Google Cloud.

  2. En el menú desplegable Seleccionar un proyecto, navega a tu proyecto de BigQuery. Esta acción debería llevarte al panel del proyecto.

  3. En el menú de la izquierda, selecciona la página API y servicios. Luego, selecciona Credenciales. En la página Credenciales, selecciona la flecha hacia abajo del botón Crear credenciales y elige ID de cliente de OAuth en el menú desplegable:

  4. Google requiere que configures una pantalla de consentimiento de OAuth, que le permite a tus usuarios elegir cómo otorgar acceso a sus datos privados antes de que puedas generar tus credenciales de OAuth. Para configurar la pantalla de consentimiento de OAuth, consulta la sección Configura una pantalla de consentimiento de OAuth en esta página.

  5. Si ya configuraste una pantalla de consentimiento de OAuth, Google mostrará la página Crea un ID de cliente de OAuth, que te permite crear un ID y un secreto de cliente de OAuth para usarlos en tu conexión de BigQuery a Looker. En el menú desplegable Tipo de aplicación, selecciona Aplicación web. La página se expandirá y mostrará opciones adicionales:

  6. En el campo Nombre, ingresa un nombre para la aplicación, como Looker.

  7. En la sección Orígenes autorizados de JavaScript, selecciona + AGREGAR URI para mostrar el campo URI 1. En el campo URIs 1, ingresa la URL a tu instancia de Looker, incluido el https://. Por ejemplo:

    • Si Looker aloja tu instancia: https://<instancename>.looker.com
    • Si tienes una instancia de Looker alojada por el cliente: https://looker.<mycompany>.com
    • Si tu instancia de Looker requiere un número de puerto: https://looker.<mycompany>.com:9999

  8. En la sección URI de redireccionamiento autorizados, selecciona + Agregar URI para mostrar el campo URI 1. En el campo URIs 1, ingresa la URL a tu instancia de Looker, seguida de /external_oauth/redirect. Por ejemplo, https://<instancename>.looker.com/external_oauth/redirect o https://looker.<mycompany>.com:9999/external_oauth/redirect.

  9. Selecciona Crear. Google muestra tu ID de cliente y tu secreto de cliente.

  10. Copia tu ID de cliente y los valores secretos de tu cliente. Los necesitarás para configurar OAuth para la conexión de BigQuery en Looker.

Google requiere que configures una pantalla de consentimiento de OAuth, que permite a tus usuarios elegir cómo otorgar acceso a sus datos privados y proporciona un vínculo a las Condiciones del Servicio y la Política de Privacidad de tu organización.

En el menú de la izquierda, selecciona la página Pantalla de consentimiento de OAuth. Antes de configurar la pantalla de consentimiento de OAuth, debes elegir el tipo de usuarios para los que usarás esta app. Según la opción que elijas, es posible que tu app requiera verificación de Google.

Elige la opción que deseas y selecciona Crear. Google muestra la página de la pantalla de consentimiento de OAuth. Puede configurar esta pantalla para todas las aplicaciones de su proyecto, incluidas las internas y las públicas.

Google verificará las aplicaciones públicas si se cumple alguna de las siguientes condiciones:

  • La aplicación usa las API de Google que usan permisos restringidos o sensibles.
  • La pantalla de consentimiento de OAuth incluye el logotipo de la aplicación.
  • El proyecto superó el umbral de dominio.

Sigue estos pasos para configurar tu pantalla de consentimiento de OAuth:

  1. En el campo Nombre de la aplicación, ingrese el nombre de la aplicación a la que el usuario otorga acceso, en este caso, Looker.

  2. En el campo Correo electrónico de asistencia al usuario, ingrese el correo electrónico de asistencia al que los usuarios deben comunicarse para informar problemas de acceso o consentimiento.

  3. Seleccione AGREGAR DOMINIO para ver el campo Dominio autorizado 1. En este campo, ingresa el dominio de la URL de tu instancia de Looker. Por ejemplo, si Looker aloja tu instancia en https://<instance_name>.cloud.looker.com, el dominio es cloud.looker.com. Para implementaciones de Looker alojadas por el cliente, ingresa el dominio en el que alojas Looker.

  4. En la sección Información de contacto del desarrollador, ingresa una o más direcciones de correo electrónico que Google puede usar para comunicarse contigo en relación con tu proyecto.

    Los campos restantes son opcionales, pero puedes usarlos para personalizar aún más tu pantalla de consentimiento.

  5. Selecciona GUARDAR Y CONTINUAR.

  6. Google muestra la página Alcances, en la que puedes configurar los alcances. Looker solo requiere los permisos predeterminados, por lo que no se requiere la configuración de permisos adicionales. Selecciona GUARDAR Y CONTINUAR.

  7. En la página Resumen, selecciona VOLVER AL PANEL.

Ahora puedes continuar con el procedimiento de generación de tus credenciales de OAuth.

Para obtener más información sobre cómo configurar la pantalla de consentimiento de OAuth de Google, consulte la documentación de asistencia de Google.

Configura la conexión de Looker para BigQuery con OAuth

Si quieres habilitar OAuth para tu conexión de BigQuery, selecciona la opción OAuth en la página Conexión de Looker cuando configuras la conexión de Looker a BigQuery. Cuando habilites la opción OAuth, Looker mostrará los campos ID de cliente de OAuth y Secreto de cliente de OAuth. Pegue los valores de ID de cliente y Secreto del cliente que obtuvo como paso en el procedimiento Cómo generar credenciales de Google OAuth de esta página.

Completa el resto del procedimiento como se describe en la sección Conecta Looker a BigQuery de esta página.

Cómo se autentican los usuarios de Looker en BigQuery con OAuth

Una vez que se configure la conexión de Looker a BigQuery para OAuth, los usuarios podrán usar Looker a fin de realizar la autenticación inicial en tu base de datos de BigQuery de una de las siguientes maneras:

Autenticación en Google desde una consulta

Una vez que la conexión de Looker a BigQuery esté configurada para OAuth, Looker solicitará a los usuarios que accedan con su Cuenta de Google antes de ejecutar consultas que usen la conexión de BigQuery. Looker muestra este mensaje de Explorar, Paneles, Apariencia y Ejecutor de SQL.

El usuario debe seleccionar Acceder y autenticarse con OAuth. Después de que el usuario se autentique en BigQuery, podrá seleccionar el botón Ejecutar en Explorar, y Looker cargará los datos allí.

Autenticarse en Google desde la página de la cuenta de usuario

Una vez que se configure la conexión de Looker a BigQuery para OAuth, un usuario podrá autenticarse en su Cuenta de Google desde la página de la cuenta de usuario de Looker:

  1. En Looker, selecciona el ícono de perfil y, luego, Account en el menú del usuario.
  2. Desplácese hacia abajo hasta la sección Credenciales de conexión de OAuth y seleccione el botón Acceder para elegir la conexión a la base de datos de BigQuery que desea utilizar.
  3. Selecciona la cuenta correspondiente en la página Acceder con Google.
  4. Selecciona Permitir en la pantalla de consentimiento de OAuth para que Looker vea y administre tus datos en Google BigQuery.

Una vez que te autentiques en Google a través de Looker, puedes salir o volver a autorizar tus credenciales en cualquier momento a través de la página Cuenta, como se describe en la página de documentación Personaliza tu cuenta de usuario. Aunque los tokens de Google BigQuery no vencen, un usuario puede seleccionar la opción Volver a autorizar para acceder con otra Cuenta de Google.

Revoca tokens de OAuth

Los usuarios pueden revocar el acceso desde aplicaciones como Looker a la Cuenta de Google en la configuración de su Cuenta de Google.

Los tokens de Google BigQuery no vencen; sin embargo, si un administrador de bases de datos cambia las credenciales de OAuth de la conexión de base de datos de una manera que invalida las credenciales existentes, los usuarios tendrán que volver a acceder con sus Cuentas de Google antes de ejecutar cualquier consulta que use esa conexión.

Tablas derivadas persistentes en una conexión de BigQuery

Si desea usar tablas derivadas persistentes (PDT) para su conexión de BigQuery, es posible que deba hacer lo siguiente, según la configuración de conexión:

  • Usa la consola de BigQuery de Google Cloud para crear un conjunto de datos temporal en tu base de datos de BigQuery que Looker pueda usar para escribir PDT. Consulta la sección Crea un conjunto de datos temporal para tablas derivadas persistentes en esta documentación. Esto es necesario para los PDT, independientemente de las otras opciones de configuración en la conexión.
  • Usa el Administrador de API en la consola de Google Cloud a fin de crear una cuenta de servicio independiente para los procesos de PDT de Looker. Consulta la sección Crea una cuenta de servicio y descarga el certificado de credenciales JSON en esta página para conocer el procedimiento. El tipo de autenticación de tu conexión determina si se requiere una cuenta de servicio de PDT y también cuando ingresas la información de esta en la ventana Conexiones de Looker cuando configuras la conexión de Looker a BigQuery:
    • Si su conexión usa OAuth para la autenticación de usuarios, debe crear una cuenta de servicio independiente para los procesos de PDT. Ingresará la información de la cuenta de servicio y los detalles del archivo de certificado en la sección Anulaciones de PDT de la ventana Conexiones de Looker. La ventana Conexiones de Looker muestra automáticamente la sección Anulaciones de PDT cuando activa el botón de activación Habilitar PDT para una conexión que también está configurada con la opción OAuth en el campo Autenticación. Si deseas obtener más información, consulta la sección Habilita PDT para conexiones de Looker a BigQuery con OAuth.
    • Si su conexión usa cuentas de servicio para la autenticación de usuarios, tiene la opción de crear una cuenta de servicio independiente para los procesos de PDT. Si eliges tener una cuenta de servicio de PDT independiente, ingresarás la información en la sección Anulaciones de PDT para los campos Correo electrónico de la cuenta de servicio, Archivo JSON/P12 de la cuenta de servicio y Contraseña de la ventana Conexiones de Looker. La sección Anulaciones de PDT aparece cuando activas el botón de activación Habilitar PDT para una conexión de Looker a BigQuery mediante la autenticación de la cuenta de servicio.

Crea un conjunto de datos temporal para tablas derivadas persistentes

Si quieres habilitar las tablas derivadas persistentes (PDT) para tu conexión de BigQuery, activa el botón de activación Habilitar PDT en la página Conexión de Looker cuando configuras la conexión de Looker a BigQuery. Cuando habilites las PDT, Looker mostrará el campo Conjunto de datos temporal. En este campo, ingresará el nombre del conjunto de datos que puede usar Looker para crear PDT. Debes configurar esta base de datos o esquema con anticipación, con los permisos de escritura adecuados.

Puedes configurar un conjunto de datos temporal con la consola de BigQuery de Google Cloud:

  1. Abre la consola de BigQuery de Google Cloud y selecciona tu proyecto.

  2. Seleccione el menú de tres puntos y, luego, Crear conjunto de datos.

  3. Ingresa un ID de conjunto de datos (por lo general, looker_scratch) y, luego, selecciona la Ubicación de los datos (opcional), el Vencimiento predeterminado de la tabla y la solución de administración de claves de encriptación. Selecciona CREAR CONJUNTO DE DATOS para terminar.

Ahora que creaste el conjunto de datos, puedes especificar el nombre del conjunto de datos en el campo Conjunto de datos temporal de la ventana Conexiones de Looker cuando configuras la conexión de Looker a BigQuery.

Habilita las PDT para las conexiones de Looker a BigQuery con OAuth

En el caso de las conexiones de BigQuery que usan OAuth, los usuarios se autentican en Looker con sus credenciales de OAuth. Looker admite PDT para conexiones de BigQuery con OAuth, pero Looker no puede usar OAuth, por lo que usted debe configurar una cuenta de servicio de BigQuery específicamente a fin de permitir que Looker acceda a su base de datos para procesos de PDT.

Puedes configurar una cuenta de servicio de PDT en tu base de datos de BigQuery con el Administrador de API de Google Cloud. Consulta la sección Crea una cuenta de servicio y descarga el certificado de credenciales JSON en esta página.

Una vez que crees la cuenta de servicio en tu base de datos de BigQuery, ingresarás la información de la cuenta de servicio y los detalles del archivo de certificado en la sección Anulaciones de PDT de la ventana Conexiones de Looker cuando configures la conexión de Looker a BigQuery. La ventana Conexiones de Looker muestra automáticamente la sección Anulaciones de PDT cuando activa el botón de activación Habilitar PDT para una conexión que también está configurada con la opción OAuth en el campo Autenticación. Usa los siguientes campos de la sección Anulaciones de PDT para ingresar la información de la cuenta de servicio que Looker puede usar para los procesos de PDT en tu base de datos:

  • Subir archivos p12 o json: Usa el botón Subir archivo para subir el archivo de certificado de la cuenta de servicio de BigQuery que quieres usar en los procesos PDT en la conexión. Puedes obtener este archivo mediante el administrador de la API de Google Cloud como paso del procedimiento para crear una cuenta de servicio y descargar el certificado de credenciales JSON.
  • Nombre de usuario: Este campo solo se aplica si sube un archivo P12 en el campo Upload p12 or json de la sección PDT Overrides. Ingresa la dirección de correo electrónico de la cuenta de servicio de BigQuery que quieres usar en los procesos de PDT en la conexión. Puedes obtener esta dirección de correo electrónico del administrador de la API de Google Cloud como paso del procedimiento Crea una cuenta de servicio y descarga el certificado de credenciales JSON.
  • Contraseña: Este campo solo se aplica si sube un archivo P12 en el campo Subir archivos p12 o json de la sección Anulaciones de PPD. Ingresa la contraseña del archivo de credenciales .p12 para la cuenta de servicio de BigQuery que deseas usar en los procesos PDT en la conexión.

Conecta Looker a BigQuery

En la sección Administrador de Looker, seleccione Conexiones para abrir la página Conexiones y, luego, realice una de las siguientes acciones:

  • Para crear una nueva conexión, selecciona el botón Add Connection.
  • Para editar una conexión existente, búscala en la tabla Bases de datos y, luego, selecciona el botón Editar en la ficha de la conexión.

Completa los detalles de la conexión. La mayoría de estos parámetros de configuración son comunes en la mayoría de los dialectos de las bases de datos y se describen en la página de documentación Conecta Looker a tu base de datos. Las siguientes opciones de configuración se mencionan para destacarlas o para aclarar cómo se aplican específicamente a las conexiones de BigQuery:

  • Dialect: Selecciona SQL estándar de Google BigQuery o SQL heredado de Google BigQuery.
  • ID del proyecto de facturación: El ID del proyecto de Google Cloud. El proyecto de facturación es el proyecto de Google Cloud al que se le factura, pero aún puedes consultar conjuntos de datos en otro proyecto de Google Cloud si los desarrolladores de LookML especifican nombres de tabla con alcance completo en el parámetro sql_table_name de las vistas, las exploraciones o las uniones de LookML. Para BigQuery, un nombre de tabla con permisos completos usa el formato <project_name>.<dataset_name>.<table_name>. Si no hay una referencia de gran alcance, BigQuery buscará la tabla en el proyecto de facturación y el conjunto de datos que especificaste en la página Conexiones de Looker para la conexión de BigQuery a Looker. Consulta la documentación de BigQuery para obtener una explicación de la jerarquía de recursos en BigQuery.
  • Conjunto de datos: Es el nombre del conjunto de datos predeterminado que planeas usar. Si una tabla no tiene especificado un conjunto de datos, se supone que está en él. (También puedes modelar otros conjuntos de datos en este proyecto). El valor Conjunto de datos debe coincidir con el nombre de un conjunto de datos en tu base de datos de BigQuery.
  • Autenticación: Es el tipo de autenticación que usará Looker para acceder a la base de datos, ya sea Cuenta de servicio o OAuth:
    • Cuenta de servicio: Selecciona esta opción para usar una cuenta de servicio de BigQuery a fin de que Looker se autentique en tu base de datos (consulta la Autenticación con cuentas de servicio de BigQuery para obtener más información). Cuando se seleccione Cuenta de servicio, verás los siguientes campos:
      • Subir archivo JSON o P12 de servicio: usa el botón Subir archivo para subir el archivo de certificado de la cuenta de servicio de BigQuery. Puedes obtener este archivo mediante el administrador de la API de Google Cloud como paso del procedimiento para crear una cuenta de servicio y descargar el certificado de credenciales JSON.
      • Correo electrónico de la cuenta de servicio: Este campo solo se aplica si sube un archivo P12 en el campo Subir archivo JSON o P12 de servicio. Ingresa la dirección de correo electrónico de la cuenta de servicio de BigQuery, que obtendrás del administrador de la API de Google Cloud como paso en el procedimiento Crea una cuenta de servicio y descarga el certificado de credenciales JSON.
      • Contraseña: Es la contraseña del archivo de credenciales P12 para la cuenta de servicio de BigQuery. El campo Password solo se aplica si subes un archivo P12 al campo Upload Service JSON or P12 File.
    • OAuth: Selecciona esta opción para permitir que cada usuario de Looker se autentique en Google BigQuery y autorice a Looker a acceder a la base de datos con la cuenta de BigQuery del usuario. Consulta la sección Autenticación con OAuth en esta página a fin de obtener más información sobre cómo implementar OAuth para tu conexión de BigQuery. Cuando se seleccione OAuth, verás los siguientes campos:
  • Habilitar PDT: Habilite este botón de activación para permitir las tablas derivadas persistentes (PDT) en la conexión. Deberá especificar el conjunto de datos temporal en su base de datos que usará Looker para escribir las PDT. Consulta la sección Crea un conjunto de datos temporal para tablas derivadas persistentes en esta página a fin de conocer el procedimiento. Nota: Si tu conexión está configurada para OAuth, deberás usar la sección Anulación de PDT a fin de especificar una cuenta de servicio que Looker puede usar para procesos de PDT en tu conexión de BigQuery. Si deseas obtener más detalles, consulta la sección Habilita PDT para conexiones de Looker a BigQuery con OAuth.
  • Conjunto de datos temporal: Es el conjunto de datos de BigQuery que creó en la consola de BigQuery de Google Cloud para permitir que Looker escriba tablas derivadas persistentes en su base de datos. Consulta la sección Crea un conjunto de datos temporal para tablas derivadas persistentes a fin de obtener el procedimiento.
  • Zona horaria de la base de datos: La zona horaria predeterminada de BigQuery es UTC. La configuración de la zona horaria que especifique aquí debe coincidir con la de la zona horaria de BigQuery. Consulta la sección Zona horaria de la base de datos de la página Conecta Looker a tu base de datos para obtener más información.
  • Query Time Zone: Consulta la sección Query Time Zone de la página Conecta Looker a tu base de datos para obtener más información.
  • Parámetros adicionales de JDBC: Agregue los parámetros adicionales de JDBC, como las etiquetas de BigQuery (consulte la sección Etiquetas de trabajo y comentarios del contexto de conexiones de BigQuery en esta página para obtener más información). Estos son algunos de los otros parámetros admitidos:
    • connectTimeout: la cantidad de milisegundos que se debe esperar para establecer una conexión. La configuración predeterminada es 240,000.
    • readTimeout: Es la cantidad de milisegundos que se esperará una lectura. La configuración predeterminada es 240,000.
    • rootUrl: Si tienes una instancia de BigQuery en una red privada, especifica un extremo alternativo para conectarte a BigQuery que no sea el extremo público predeterminado.
  • Máximo de gigabytes de facturación: En las conexiones de BigQuery, se le cobra por cada consulta en función del tamaño de la consulta. Para evitar que los usuarios ejecuten accidentalmente una consulta demasiado costosa, puedes establecer una cantidad máxima de gigabytes que un usuario puede extraer en una sola consulta. Puede dejar en blanco el campo Máximo de gigabytes de facturación para indicar que no hay límite en el tamaño de la consulta. Obtén más información sobre los precios aquí.
  • Cantidad máxima de conexiones por nodo: Puede dejarse en el valor predeterminado inicialmente. Obtén más información sobre esta configuración en la sección Máximo de conexiones por nodo de la página de documentación Conecta Looker a tu base de datos.
  • Tiempo de espera del grupo de conexiones: Inicialmente, se puede dejar con el valor predeterminado. Obtén más información sobre esta configuración en la sección Tiempo de espera del grupo de conexiones de la página de documentación Conecta Looker a tu base de datos.
  • Inhabilitar contexto: Esta opción inhabilita los comentarios contextuales en una conexión de BigQuery. Los comentarios contextuales en conexiones de Google BigQuery están inhabilitados de forma predeterminada porque los comentarios de contexto invalidan la capacidad de Google BigQuery de almacenar en caché y pueden afectar negativamente el rendimiento de la caché. Si desea habilitar los comentarios de contexto para una conexión de BigQuery, desactive el botón Inhabilitar contexto. Consulta la sección Etiquetas de trabajo y comentarios del contexto de las conexiones de BigQuery para obtener más información.
  • Almacenamiento previo en caché de SQL Runner: Si quieres que SQL Runner no cargue previamente la información de la tabla y, en su lugar, para cargar la información de la tabla solo cuando se seleccione una tabla, desmarca esta opción. Consulta la sección Almacenamiento previo en caché de SQL Runner de la página Conecta Looker a tu base de datos para obtener más información.

Una vez que completes todos los campos aplicables para la conexión, puedes probar tu conexión según sea necesario.

Para guardar esta configuración, haz clic en Conectar.

Prueba la conexión

Puedes probar la configuración de tu conexión desde algunos lugares en la IU de Looker:

  • Selecciona el botón Probar en la parte inferior de la página de Configuración de conexiones, como se describe en la página de documentación de Conexión de Looker a tu base de datos.
  • Selecciona el botón Probar en la lista de conexiones en la página de administración Conexiones, como se describe en la página de documentación de Conexiones.

Para conexiones nuevas, si Looker muestra Puede conectarse, selecciona Agregar conexión. Looker ejecutará el resto de las pruebas de conexión para verificar que la cuenta de servicio se configuró correctamente y con los roles adecuados.

Prueba una conexión que use OAuth

  1. En Looker, ve a Development Mode.
  2. Si tienes una conexión de BigQuery existente que usa OAuth, navega a los archivos del proyecto para ver un proyecto de Looker que use tu conexión de BigQuery. Para las conexiones nuevas de BigQuery que usan OAuth, abre un archivo de modelo y reemplaza el valor connection del modelo con el nombre de tu nueva conexión de BigQuery y, luego, guarda el archivo del modelo.
  3. Abre uno de los paneles o Exploras del modelo y ejecuta una consulta. Cuando intentes ejecutar una consulta, Looker te pedirá que accedas con tu Cuenta de Google. Sigue las indicaciones de acceso de Google OAuth.

Etiquetas de trabajos y comentarios del contexto para conexiones de BigQuery

Para las conexiones de BigQuery, Looker envía el contexto de consulta en forma de etiquetas de trabajo de BigQuery. De forma predeterminada, Looker envía las siguientes claves de etiquetas de contexto para las conexiones de BigQuery:

  • looker-context-user_id: Es el identificador único de cada usuario en la instancia de Looker. Puede hacer coincidir este ID de usuario con los ID de usuario de la página Usuarios en el menú Administrador.

  • looker-context-history_slug: Es el identificador único de cada consulta que la instancia de Looker ejecuta en la base de datos.

  • looker-context-instance_slug: Es el número de ID de la instancia de Looker que emitió la consulta. La asistencia de Looker puede usar esta información para ayudarte a solucionar problemas, si es necesario.

Puede configurar etiquetas de trabajo adicionales para que Looker las envíe con cada consulta en la conexión de BigQuery mediante el campo de texto Parámetros de JDBC adicionales de la página Conexiones. En el campo Parámetros adicionales de JDBC, agrega un parámetro JDBC adicional, labels, y proporciona una lista separada por comas de pares key=value codificados en una URL. Por ejemplo, si incluye esto en el campo Parámetros adicionales de JDBC:

labels=this%3Dconnection-label,that%3Danother-connection-label

%3D es la codificación de URL para =, por lo que se agregarían las siguientes dos etiquetas a cada consulta que Looker envíe a la base de datos de BigQuery, además de las etiquetas de contexto predeterminadas de Looker:

  • this: connection-label
  • that: another-connection-label

Ten en cuenta que BigQuery tiene restricciones en las etiquetas de trabajo:

  • Se ignorará cualquier etiqueta de conexión que tenga la misma clave que una etiqueta de contexto.
  • Si la unión de etiquetas de conexión y etiquetas de contexto excede el máximo de 64 etiquetas en total, las primeras serán descartadas, seguidas por las de conexión, hasta que la cantidad total sea de 64 etiquetas.

Looker garantiza que las etiquetas de contexto cumplan con todos los requisitos de validez de las etiquetas de BigQuery, pero no verifica la validez de las etiquetas de conexión. Configurar etiquetas de conexión no válidas puede provocar que las consultas fallen.

Las etiquetas de trabajo de BigQuery que envía Looker de forma predeterminada (looker-context-user_id, looker-context-history_id y looker-context-instance_slug) corresponden a los comentarios en contexto de SQL que Looker adjunta a las consultas en SQL para dialectos de base de datos que no sean BigQuery. En las conexiones de BigQuery, los comentarios contextuales están inhabilitados de forma predeterminada porque invalidan la capacidad de BigQuery para almacenar en caché y pueden afectar negativamente el rendimiento de la caché. Si desea habilitar los comentarios contextuales para una conexión de BigQuery, desactive el botón de activación Inhabilitar contexto de la conexión de BigQuery. Te recomendamos mantener la configuración predeterminada para Inhabilitar comentarios contextuales a fin de poder usar la caché de BigQuery. Sin embargo, si anulas la selección de la opción Inhabilitar comentario de contexto para una conexión de BigQuery, Looker enviará comentarios del contexto de SQL y etiquetas de trabajo de BigQuery a la base de datos.

Los comentarios de contexto de SQL y las etiquetas de trabajo de BigQuery transmiten la misma información. Por ejemplo, Looker podría generar los siguientes comentarios de contexto de SQL para una consulta:

-- Looker Query Context

'{"user_id":1,"history_id":4757,"instance_slug":"ec2804ddef74c466f2a43e0afaa3ff6b"}'

Luego, Looker generaría las siguientes etiquetas de trabajo de BigQuery para la misma consulta:

[{"value":"1","key":"looker-context-user_id"),

 {"value":"4757","key":"looker-context-history_id"),

 {"value":"ec2804ddef74c466f2a43e0afaa3ff6b","key":"looker-context-instance_slug"}]

Compatibilidad de características

Para que Looker admita algunas funciones, tu dialecto de base de datos también debe admitirlas.

SQL estándar de Google BigQuery

SQL estándar de Google BigQuery es compatible con las siguientes funciones a partir de Looker 23.8:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
Sí
Agregaciones simétricas
Sí
Tablas derivadas
Sí
Tablas derivadas de SQL persistente
Sí
Tablas derivadas persistentes nativas
Sí
Vistas estables
Sí
Asesinato de consultas
Sí
Pivotes basados en SQL
Sí
Zonas horarias
Sí
SSL
Sí
Subtotales
Sí
Parámetros adicionales de JDBC
Sí
Distingue mayúsculas de minúsculas
Sí
Tipo de ubicación
Sí
Tipo de lista
Sí
Percentil
Sí
Percentil distintivo
Sí
Procesos de Show del ejecutor de SQL
No
Tabla de descripción del ejecutor de SQL
No
Índices de SQL Runner Show
No
Ejecutor de SQL Select 10
Sí
Recuento de ejecutores de SQL
Sí
Explicación de SQL
No
Credenciales de OAuth
Sí
Comentarios de contexto
Sí
Agrupación de conexiones
No
Bocetos de HLL
Sí
Reconocimiento global
Sí
PDT incrementales
Sí
Milisegundos
Sí
Microsegundos
Sí
Vistas materializadas
Sí
Distinto del recuento aproximado
Sí

SQL heredado de Google BigQuery

El SQL heredado de Google BigQuery es compatible con las siguientes funciones a partir de Looker 23.8:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
No
Agregaciones simétricas
Sí
Tablas derivadas
Sí
Tablas derivadas de SQL persistente
Sí
Tablas derivadas persistentes nativas
Sí
Vistas estables
No
Asesinato de consultas
Sí
Pivotes basados en SQL
Sí
Zonas horarias
No
SSL
Sí
Subtotales
No
Parámetros adicionales de JDBC
Sí
Distingue mayúsculas de minúsculas
Sí
Tipo de ubicación
Sí
Tipo de lista
Sí
Percentil
Sí
Percentil distintivo
Sí
Procesos de Show del ejecutor de SQL
No
Tabla de descripción del ejecutor de SQL
No
Índices de SQL Runner Show
No
Ejecutor de SQL Select 10
Sí
Recuento de ejecutores de SQL
Sí
Explicación de SQL
No
Credenciales de OAuth
Sí
Comentarios de contexto
Sí
Agrupación de conexiones
No
Bocetos de HLL
No
Reconocimiento global
Sí
PDT incrementales
No
Milisegundos
Sí
Microsegundos
Sí
Vistas materializadas
No
Distinto del recuento aproximado
Sí

Próximos pasos

Después de conectar tu base de datos con Looker, configura opciones de acceso para tus usuarios.