Cómo conectar Looker a tu base de datos

Después de proteger y configurar tu base de datos, puedes conectarla a Looker.

Para crear una conexión de base de datos en Looker, ve a la página Conecta tu base de datos a Looker. Existen dos opciones para abrir la página Conecta tu base de datos a Looker:

  • Haz clic en el ícono de Menú principal, selecciona Administrador y, luego, Conexiones en la sección Base de datos del panel Administrador. En la página Conexiones, haz clic en el botón Agregar conexión.
  • Haz clic en el botón Crear en el menú de navegación principal y, luego, selecciona el elemento de menú Conexión.

En esta página, se describen los campos comunes que Looker muestra en la página Conecta tu base de datos a Looker. Los campos exactos que muestra la página dependen de la configuración del dialecto.

Para obtener información sobre cómo aplicar atributos de usuario a la configuración de conexión, consulta la sección Conexiones de la página de documentación Atributos de usuario.

La configuración de la conexión de la base de datos incluye las siguientes cuatro secciones:

Configuración general

Nombre

El nombre de la conexión que quieres que se use para ella. Necesitas este nombre de conexión de base de datos para usarlo en el parámetro connection de tu modelo de LookML. El nombre de la conexión de la base de datos también es la forma en que se identifica la conexión en la página Conexiones Administrador de Looker. No uses el nombre de ninguna carpeta para este parámetro de configuración. No es necesario que este valor coincida con ningún elemento de tu base de datos; Name es una etiqueta que identifica esta conexión en la IU de Looker.

Dialecto de SQL

Es el dialecto de SQL que coincide con tu conexión. Es importante elegir el valor correcto para ver las opciones de conexión adecuadas y hacer que Looker traduzca correctamente tu LookML a SQL.

Usa la versión más reciente del controlador

De forma predeterminada, Looker siempre se conecta a tu base de datos con la versión más reciente del controlador JDBC para el dialecto de tu base de datos. Si el dialecto de la base de datos que seleccionaste tiene más de una versión del controlador de JDBC compatible con Looker, puedes inhabilitar el botón de activación Usar la versión más reciente del controlador para seleccionar una versión anterior del controlador de JDBC para la conexión. Si quieres seleccionar una versión anterior del controlador JDBC, puedes inhabilitar el botón de activación Usa la versión más reciente del controlador para tu conexión y, luego, seleccionar la versión del controlador en el menú desplegable Versión del controlador.

Si seleccionas una versión anterior del controlador de JDBC, Looker seguirá usando esa versión anterior mientras Looker la admita.

Looker dejará de admitir una versión del controlador en las siguientes dos situaciones:

  • Se quitó la versión del controlador de la asistencia de Looker. En este caso, la conexión usará la versión más antigua del controlador que Looker admite para el dialecto.
  • La versión del controlador aún no existe debido a una reversión de Looker. En este caso, la conexión usará la versión más reciente del controlador que admite la versión revertida.

Si Looker ya no admite la versión del controlador que seleccionaste, Looker mostrará una alerta debajo del campo Versión del controlador en la página Editar la conexión de la base de datos para informarte que la versión del controlador seleccionada ya no es compatible. La alerta también te informará qué versión del controlador usa Looker para la conexión. Para borrar esta alerta, selecciona una versión compatible del controlador de JDBC en el menú desplegable Versión del controlador o activa el botón de activación Usar la versión más reciente del controlador para usar la versión más reciente del controlador.

Alcance del proyecto

Selecciona si la conexión se debe poder usar con todos los proyectos o con uno solo:

  • Todos los proyectos: Todos los proyectos de LookML de la instancia pueden tener acceso a la conexión, por lo que el nombre de la conexión se puede especificar en el parámetro connection de los archivos de modelo de ese proyecto.
  • Proyecto seleccionado: Solo un proyecto de LookML de la instancia puede tener acceso a la conexión. Cuando seleccionas esta opción, en la pantalla Connection, se muestra un menú desplegable de los proyectos de la instancia. Selecciona el proyecto que puede tener acceso a esta conexión.

Usa esta opción junto con los siguientes permisos para delegar la administración de conexiones y la configuración de modelos:

Detalles del estado

Expande la sección Detalles del estado para probar la configuración de tu conexión.

Configuración de la base de datos

Habilitar el servidor SSH

La opción Servidor SSH solo está disponible si la instancia se implementa en la infraestructura de Kubernetes y se habilitó la capacidad de agregar información de configuración del servidor SSH a tu instancia de Looker. Si esta opción no está habilitada en tu instancia de Looker y quieres habilitarla, comunícate con un especialista en ventas de Google Cloud o abre una solicitud de asistencia. Si activas la opción Habilitar el servidor SSH, Looker mostrará los campos Servidor SSH y Túnel SSH.

Servidor SSH

No puedes especificar el puerto de localhost; el servidor SSH lo elige automáticamente por ti. Si necesitas crear una conexión SSH que requiera que especifiques un puerto de localhost, abre una solicitud de asistencia.

Selecciona una configuración del servidor SSH de la lista desplegable. Se requiere un servidor SSH para seleccionar o crear un túnel SSH adecuado. Puedes crear un servidor SSH nuevo en la pestaña Servidores SSH del panel Conexiones.

Túnel SSH

Selecciona un túnel SSH existente de la lista desplegable o haz clic en el ícono Crear túnel nuevo si quieres crear un túnel SSH nuevo con un nombre de host y un puerto o un puerto local.

Nombre de host

Es el nombre de host de la base de datos que debe usar Looker para conectarse al host de tu base de datos.

Si trabajaste con un analista de Looker para configurar un túnel SSH a tu base de datos, en el campo Host, ingresa "localhost". Si aplicas un atributo de usuario al campo Host, el atributo de usuario no puede tener un nivel de acceso de usuario establecido en Editable. Si configuraste un túnel SSH para conectarte a tu base de datos, no puedes aplicar un atributo de usuario al campo Host remoto:puerto.

Puerto

Es el puerto de la base de datos que debe usar Looker para conectarse al host de tu base de datos.

Si trabajaste con un analista de Looker para configurar un túnel SSH a tu base de datos, en el campo Puerto, ingresa el número de puerto que redirecciona a tu base de datos, que debería haber proporcionado tu analista de Looker.

Puerto local

De forma predeterminada, Looker selecciona automáticamente un puerto local disponible para el túnel SSH. Para elegir un puerto local de forma manual, selecciona Ingresar valores manualmente y, luego, ingresa un número de puerto en el campo Custom Local Port. Asegúrate de que el puerto local esté disponible en tu instancia.

ID del proyecto de facturación (solo Google BigQuery)

El ID del proyecto de facturación es el ID del proyecto de Google Cloud . Para obtener más información, consulta la página de documentación de Google BigQuery.

ID del proyecto de almacenamiento (solo para Google BigQuery)

El nombre del ID del proyecto de almacenamiento, si separas el procesamiento y el almacenamiento en proyectos diferentes. Puedes consultar conjuntos de datos en un proyecto de Google Cloud diferente si tus desarrolladores de LookML especifican nombres de tablas con alcance completo en el parámetro sql_table_name de tus vistas, exploraciones o uniones de LookML. Para obtener más información, consulta la página de documentación de Google BigQuery.

Conjunto de datos principal (solo Google BigQuery)

Es el nombre del conjunto de datos que Looker debe usar de forma predeterminada cuando consulta tu base de datos. Para obtener más información, consulta la página de documentación de Google BigQuery.

Nombre de la base de datos

El nombre de la base de datos en el host. Por ejemplo, es posible que tengas un nombre de host de my-instance.us-east-1.redshift.amazonaws.com en el que haya una base de datos llamada sales_info. Ingresa sales_info en este campo. Si tienes varias bases de datos en el mismo host, es posible que debas crear varias conexiones para usarlas (con la excepción de MySQL, en el que la palabra base de datos significa algo un poco diferente que en la mayoría de los dialectos de SQL).

Esquema predeterminado

Es el esquema predeterminado que usa Looker cuando no se especifica uno. Esto se aplica cuando usas el Ejecutor de SQL, durante la generación del proyecto de LookML y cuando consultas tablas.

Configuración de autenticación

Para las conexiones de Google BigQuery, Snowflake, Trino y Databricks, selecciona el tipo de autenticación que quieres que Looker use para acceder a tu base de datos:

  • En el caso de las conexiones de Google BigQuery, tienes la opción de configurar OAuth o una cuenta de servicio para que Looker se autentique en tu base de datos.
  • En el caso de las conexiones de Snowflake, Trino y Databricks, tienes la opción de configurar OAuth o una cuenta de base de datos para que Looker la use para autenticarse en tu base de datos.

Cuando usas OAuth, tus usuarios deben acceder a tu base de datos para emitir consultas desde Looker. Cuando los usuarios inician un flujo de autorización de OAuth en Looker, Looker muestra un diálogo Autorizar conexión de OAuth en el que se les notifica que autorizar la conexión permite que la instancia de Looker acceda a los datos en su nombre y que los usuarios con privilegios de Looker, como los administradores o los desarrolladores, podrían tener visibilidad de sus datos. Los usuarios deben seleccionar Autorizar para continuar con la página de acceso de OAuth. La información de consentimiento se almacena en el almacenamiento local del navegador. Si se borra el almacenamiento local, el diálogo vuelve a aparecer la próxima vez que el usuario inicie un flujo de autorización de OAuth. Para obtener más información sobre cómo configurar OAuth en una conexión a Looker, consulta los procedimientos de conexión de Google BigQuery, Snowflake, Trino o Databricks.

Nombre de usuario

Es el nombre de usuario de una cuenta de usuario de tu base de datos que Looker puede usar para conectarse a ella.

Contraseña

Es la contraseña de una cuenta de usuario de tu base de datos que Looker puede usar para conectarse a ella.

Expande la sección Detalles del estado para probar la configuración de tu conexión.

Configuración opcional

Cantidad máxima de conexiones por nodo

Aquí puedes establecer la cantidad máxima de conexiones que Looker puede establecer con tu base de datos. En su mayoría, estableces la cantidad de consultas simultáneas que Looker puede ejecutar en tu base de datos. Looker también reserva hasta tres conexiones para finalizar consultas. Si el grupo de conexiones es muy pequeño, Looker reservará menos conexiones.

Establece este valor con cuidado. Si el valor es demasiado alto, es posible que sobrecargues la base de datos. Si el valor es demasiado bajo, las consultas deberán compartir una pequeña cantidad de conexiones, lo que podría hacer que muchas consultas parezcan lentas para los usuarios, ya que deben esperar a que se devuelvan otras consultas anteriores.

El valor predeterminado (que varía según el dialecto de SQL) suele ser un punto de partida razonable. La mayoría de las bases de datos también tienen su propia configuración para la cantidad máxima de conexiones que aceptarán. Si la configuración de tu base de datos limita las conexiones, asegúrate de que el valor de Cantidad máxima de conexiones por nodo sea igual o inferior al límite de tu base de datos.

Tiempo de espera del grupo de conexiones

Si tus usuarios solicitan más conexiones de las que se configuran en el parámetro Cantidad máxima de conexiones por nodo, las solicitudes esperarán a que finalicen otras antes de ejecutarse. Aquí se configura la cantidad máxima de tiempo que esperará una solicitud. La configuración predeterminada es de 120 segundos.

Establece este valor con cuidado. Si se establece un valor demasiado bajo, es posible que los usuarios vean que sus consultas se cancelan porque no hay tiempo suficiente para que finalicen las consultas de otros usuarios. Si se establece un valor demasiado alto, es posible que se acumule una gran cantidad de consultas, lo que hará que los usuarios esperen mucho tiempo. Por lo general, el valor predeterminado es un punto de partida razonable.

Cantidad máx. de consultas simultáneas para esta conexión

Este valor opcional limita la cantidad de consultas simultáneas que enviará Looker a esta conexión de base de datos a la vez. Si llegan más solicitudes simultáneas que solicitan la misma conexión, Looker las pondrá en cola internamente y las procesará en orden. Si configuras este valor, se reemplazará el valor existente de Cantidad máxima de conexiones por nodo.

Cantidad máx. de consultas simultáneas por usuario para esta conexión

Este valor opcional limita la cantidad de consultas simultáneas de un usuario que Looker enviará a esta conexión de base de datos a la vez. Si llegan más solicitudes simultáneas que solicitan la misma conexión, Looker las pondrá en cola internamente y las procesará en orden. El valor predeterminado se establece según el dialecto de la base de datos y, por lo general, es 25.

El parámetro de configuración Cantidad máx. de consultas simultáneas por usuario para esta conexión se aplica a la conexión individual para la que se establece. Este parámetro de configuración anula la opción de inicio per-user-query-limit a nivel de la instancia para la conexión.

Debido a que el parámetro de configuración Cantidad máx. de consultas simultáneas por usuario para esta conexión anula el parámetro de configuración per-user-query-limit, es importante comprender en qué se diferencian estos parámetros de configuración:

  • El parámetro de configuración Cantidad máx. de consultas simultáneas por usuario para esta conexión se aplica por usuario y por conexión, pero NO por nodo. El parámetro de configuración Cantidad máx. de consultas simultáneas por usuario para esta conexión se aplica a las consultas simultáneas del usuario para la conexión en toda la instancia de Looker. En el caso de las instancias de Looker agrupadas en clústeres, el valor que establezcas para Cantidad máx. de consultas simultáneas por usuario para esta conexión se divide por la cantidad de nodos de tu clúster de Looker para determinar la cantidad de consultas simultáneas que un usuario puede ejecutar en cada nodo.

    Por ejemplo, si tienes un clúster de 5 nodos y estableces este valor en 15, cada nodo permitirá 3 consultas simultáneas por usuario para esta conexión (15/5 = 3), lo que da un total de 15 consultas en todos los nodos.

  • La opción de inicio per-user-query-limit se aplica por usuario, por conexión y por nodo.

    Por ejemplo, si tienes un clúster de 5 nodos con un per-user-query-limit de 15, cada nodo permitirá 15 consultas simultáneas por usuario para esta conexión, lo que da un total de 75 consultas en todos los nodos (15 * 5 = 75).

Por lo tanto, en el caso de las instancias de Looker agrupadas en clústeres, aplicar un valor para la cantidad máxima de consultas simultáneas por usuario para esta conexión puede afectar el rendimiento de las consultas para tus usuarios.

Parámetros adicionales de JDBC

Un controlador de conectividad de bases de datos de Java (JDBC) es un componente de software que administra la conexión entre Looker y tu base de datos.

Cuando el controlador JDBC de tu base de datos inicia una conexión de Looker a tu base de datos, el controlador crea una URL con un conjunto de parámetros, como host, puerto, base de datos o almacén, y parámetros adicionales específicos del dialecto. Cuando configuras la conexión para tu base de datos, puedes especificar parámetros de JDBC adicionales que Looker debe incluir cuando se comunica con el controlador de la base de datos. Según tu dialecto y el parámetro específico, el controlador de JDBC puede procesar los parámetros de JDBC o pasarlos a tu base de datos.

Para mantener la seguridad de tu conexión, Looker tiene una lista de entidades permitidas para los parámetros de JDBC que se admiten en cada dialecto de base de datos.

  • Si intentas crear o actualizar una conexión con parámetros de JDBC no admitidos, Looker mostrará un mensaje de error con los parámetros no permitidos.
  • Si tienes una conexión existente con parámetros de JDBC no compatibles, Looker quitará los parámetros y, luego, se conectará a tu base de datos.

Para obtener una lista de los parámetros de JDBC compatibles con tu dialecto, consulta la sección "Parámetros de JDBC compatibles" de la página Instrucciones de configuración de la base de datos de tu dialecto.

Para hacer referencia a un atributo de usuario en un parámetro de JDBC, usa la sintaxis de plantillas de Liquid: _user_attributes['name_of_attribute']. Consulta el siguiente ejemplo:

my_jdbc_param={{ _user_attributes['name_of_attribute'] }}

Programación de mantenimiento

El regenerador de Looker verifica los grupos de datos y las tablas persistentes (tanto las tablas de datos agregados como las tablas derivadas persistentes) que se basan en sql_trigger_value. Según estas verificaciones, el regenerador de Looker vuelve a compilar o descarta las tablas persistentes del esquema temporal de tu base de datos.

El valor de Programa de mantenimiento establece el intervalo de cron para el regenerador de Looker. El regenerador de Looker inicia un ciclo de regeneración para verificar los grupos de datos y las tablas persistentes en el intervalo de cron. Si un ciclo del regenerador de Looker aún está en curso en el siguiente intervalo de cron, el regenerador de Looker completará el ciclo del regenerador que está en curso y, luego, esperará hasta el siguiente intervalo de cron para comenzar el siguiente ciclo del regenerador.

La configuración Programa de mantenimiento acepta una expresión cron. El valor predeterminado es */5 * * * *, lo que significa que el ciclo del regenerador de Looker iniciará un ciclo en el intervalo de cinco minutos, si se completó el ciclo del regenerador anterior. Si el ciclo anterior del regenerador no se completó, el regenerador de Looker se iniciará en el siguiente intervalo de cinco minutos después de que se complete su ciclo.

El intervalo predeterminado de cinco minutos también es el intervalo más frecuente que se admite para la programación de mantenimiento. Looker no aplica un intervalo máximo para el Programa de mantenimiento, lo que significa que puedes extender el intervalo entre los ciclos del regenerador de Looker durante el tiempo que se pueda especificar con una expresión cron. Ten en cuenta que los ciclos más largos del regenerador de Looker pueden afectar negativamente la actualización de los datos en la caché y las tablas persistentes.

Después de que el regenerador de Looker complete todas las verificaciones y las recompilaciones de PDT en un ciclo, esperará el siguiente intervalo de cron para iniciar el próximo ciclo. Si tienes compilaciones de PDT de larga duración, es posible que haya períodos prolongados entre los ciclos del regenerador de Looker. Otros factores pueden afectar el tiempo necesario para volver a compilar las tablas, como se describe en la sección Consideraciones importantes para implementar tablas persistentes de la página Tablas derivadas en Looker.

Si tu base de datos no está activa las 24 horas, todos los días, te recomendamos que limites las verificaciones a los momentos en que esté activa. Estas son algunas expresiones adicionales de cron:

Expresión cron Definición
*/5 8-17 * * MON-FRI Verificar los grupos de datos y las PDT cada 5 minutos durante el horario de atención, de lunes a viernes
*/5 8-17 * * * Verificar los grupos de datos y las PDT cada 5 minutos durante el horario de atención, todos los días
0 8-17 * * MON-FRI Verifica los grupos de datos y las PDT cada hora durante el horario de atención, de lunes a viernes.
1 3 * * * Verificar los grupos de datos y las PDT todos los días a las 3:01 a.m.

Ten en cuenta lo siguiente cuando crees una expresión cron:

  • Looker usa parse-cron v0.1.3, que no admite ? en expresiones cron.
  • La expresión cron usa la zona horaria de la aplicación de Looker para determinar cuándo se realizan las verificaciones.
  • Si no se están compilando las PDT, restablece la cadena cron al valor predeterminado de */5 * * * *.

A continuación, se incluyen algunos recursos para ayudarte a crear cadenas de cron:

Inhabilitar conexión

La opción Inhabilitar conexión permite que los administradores de Looker cierren temporalmente una conexión en los casos en que haya problemas downstream con la base de datos, en lugar de finalizar las consultas de forma manual o permitir que las consultas permanezcan en la cola de consultas.

Cuando el botón de activación Inhabilitar conexión está habilitado, Looker no enviará ninguna consulta a la base de datos, sino que devolverá un mensaje de error al usuario que indica que la conexión está inhabilitada.

Una vez que se resuelvan los problemas de la base de datos, un administrador de Looker puede desactivar el botón de activación Inhabilitar conexión. Una vez que se vuelva a habilitar la conexión, todas las consultas volverán a funcionar como se espera.

SSL

Elige si quieres usar la encriptación SSL para proteger los datos cuando se transfieren entre Looker y tu base de datos. SSL es solo una opción que se puede usar para proteger tus datos; se describen otras opciones seguras en la página de documentación Habilita el acceso seguro a la base de datos.

Verificar SSL

Elige si deseas exigir la verificación del certificado SSL que usa la conexión. Si se requiere la verificación, la autoridad certificadora (AC) de SSL que firmó el certificado SSL debe provenir de la lista de fuentes de confianza del cliente. Si la AC no es una fuente de confianza, no se establece la conexión con la base de datos.

Si no se selecciona esta casilla, se seguirá usando la encriptación SSL en la conexión, pero no se requerirá la verificación de la conexión SSL, por lo que se podrá establecer una conexión cuando la AC no esté en la lista de fuentes de confianza del cliente.

Almacenar previamente en caché tablas y columnas

En el Ejecutor de SQL, toda la información de la tabla se carga previamente en cuanto seleccionas una conexión y un esquema. Esto permite que el Ejecutor de SQL muestre rápidamente las columnas de la tabla en cuanto haces clic en el nombre de una tabla. Sin embargo, para las conexiones y los esquemas con muchas tablas o con tablas muy grandes, es posible que no quieras que el Ejecutor de SQL cargue previamente toda la información.

Si prefieres que el Ejecutor de SQL cargue la información de la tabla solo cuando se selecciona una tabla, puedes desmarcar la opción Almacenar previamente en caché tablas y columnas para inhabilitar la carga previa del Ejecutor de SQL para la conexión.

Recuperar y almacenar en caché el esquema

Para algunas funciones de escritura de SQL, como el reconocimiento de agregaciones, Looker usa el esquema de información de tu base de datos para optimizar la escritura de SQL. Si el esquema de información no se almacena en caché, es posible que Looker deba bloquear ocasionalmente la escritura de SQL en la base de datos para poder recuperar el esquema de información. En el caso de los dialectos de Denodo o los dialectos que usan el sistema de archivos distribuido de Hadoop (HDFS), recuperar el esquema de información puede tardar lo suficiente como para afectar de forma significativa el rendimiento de tus consultas de Looker. Si sabes que tu esquema de información es lento, puedes inhabilitar la opción Recuperar y almacenar en caché el esquema para tu conexión. Inhabilitar esta función impedirá parte de la optimización de SQL de Looker para ciertas funciones, por lo que debes habilitar la opción Recuperar y almacenar en caché el esquema, a menos que sepas que el esquema de información de tu conexión es particularmente lento.

Estimación de costos

El botón de activación Estimación de costos solo se aplica a las siguientes conexiones de base de datos:

El botón de activación Estimación de costos habilita las siguientes funciones en la conexión:

Consulta la página de documentación Explora datos en Looker para obtener más información.

Agrupación de conexiones de base de datos

En el caso de los dialectos que admiten la agrupación de conexiones de bases de datos, esta función permite que Looker use grupos de conexiones a través del controlador de JDBC. La agrupación de conexiones de bases de datos permite un rendimiento de consultas más rápido; una consulta nueva no necesita crear una conexión de base de datos nueva, sino que puede usar una conexión existente de la agrupación de conexiones. La capacidad de agrupación de conexiones garantiza que se limpie una conexión después de la ejecución de una consulta y que esté disponible para su reutilización después de que finalice la ejecución de la consulta. Consulta la página de documentación Agrupación de conexiones de bases de datos para obtener más información.

Configuración de tablas derivadas persistentes (PDT)

La siguiente configuración aparece si se habilitan las PDT.

Habilitar PDT

Activa el botón de activación Habilitar PDT para habilitar las tablas derivadas persistentes. Cuando se habilitan las PDT, la ventana Conexión muestra campos de PDT adicionales y la sección Anulaciones de PDT. Looker muestra el botón de activación Habilitar PDT solo si el dialecto de la base de datos admite el uso de PDT.

Ten en cuenta lo siguiente sobre las PDT:

  • Las PDT no son compatibles con las conexiones de Snowflake que usan OAuth.
  • Inhabilitar las PDT en una conexión no inhabilita los grupos de datos asociados a tus PDT. Incluso si inhabilitas las PDT, los grupos de datos existentes seguirán ejecutando sus consultas sql_trigger en la base de datos. Si quieres que un grupo de datos deje de ejecutar su consulta sql_trigger en tu base de datos, debes borrar o marcar como comentario el parámetro datagroup de tu proyecto de LookML, o bien puedes actualizar el parámetro de configuración Programa de mantenimiento de la conexión para que Looker verifique las PDT y los grupos de datos con muy poca frecuencia o nunca.
  • En el caso de las conexiones de Snowflake, Looker establece el valor del parámetro AUTOCOMMIT en TRUE (el valor predeterminado de Snowflake). AUTOCOMMIT es necesario para los comandos de SQL que Looker ejecuta para mantener su sistema de registro de PDT.

Base de datos temporal

Si bien esta base de datos se etiqueta como Base de datos temporal, debes ingresar el nombre de la base de datos o del esquema (según tu dialecto de SQL) para que Looker lo use a fin de crear tablas derivadas persistentes. Debes configurar esta base de datos o esquema con anticipación, con los permisos de escritura adecuados. En la página de documentación Instrucciones de configuración de la base de datos, selecciona el dialecto de tu base de datos para ver las instrucciones correspondientes.

Cada conexión debe tener su propio esquema o base de datos temporal. No se pueden compartir entre conexiones.

Cantidad máxima de conexiones del compilador de PDT

El parámetro de configuración Cantidad máxima de conexiones del compilador de PDT te permite especificar cuántas compilaciones de tablas simultáneas puede iniciar el regenerador de Looker en la conexión de base de datos. El parámetro de configuración Cantidad máxima de conexiones del compilador de PDT solo se aplica a los tipos de tablas para los que el regenerador de Looker inicia las recompilaciones:

  • Tablas con activador de persistencia (tablas derivadas persistentes y tablas de datos agregados que usan la estrategia de persistencia datagroup_trigger o sql_trigger_value).
  • Tablas persistentes que usan la estrategia persist_for, pero solo cuando la tabla persist_for forma parte de una cascada de tablas derivadas en la que depende de una tabla que usa la estrategia de persistencia datagroup_trigger o sql_trigger_value. En este caso, el regenerador de Looker volverá a compilar una tabla persist_for, ya que se necesita para volver a compilar otra tabla en la cascada. De lo contrario, el regenerador no inicia compilaciones para las tablas de persist_for.

El parámetro de configuración Cantidad máxima de conexiones del compilador de PDT se establece de forma predeterminada en 1, pero se puede establecer en un valor de hasta 100. Sin embargo, el valor no puede ser superior al que se establece en el campo Cantidad máxima de conexiones por nodo ni en el per-user-query-limit establecido en las opciones de inicio de Looker.

Establece este valor con cuidado. Si el valor es demasiado alto, es posible que sobrecargues la base de datos. Si el valor es bajo, las PDT o las tablas de datos agregados de larga duración pueden retrasar la creación de otras tablas persistentes o ralentizar otras consultas en la conexión. Las bases de datos que admiten la arquitectura de múltiples usuarios, como BigQuery, Snowflake y Redshift, pueden tener un mejor rendimiento cuando se trata de controlar compilaciones de consultas paralelas.

Si deseas aumentar el parámetro de configuración Cantidad máxima de conexiones del compilador de PDT, se recomienda aumentarlo primero en un incremento de 1. Si se produce algún comportamiento inesperado, vuelve a establecerlo en el valor predeterminado de 1. De lo contrario, si el rendimiento de las consultas no se ve afectado, puedes seguir aumentándolo de forma incremental en 1 y verificar el rendimiento en cada incremento antes de seguir aumentando el parámetro de configuración.

Ten en cuenta lo siguiente sobre el parámetro de configuración Cantidad máxima de conexiones del compilador de PDT:

  • El parámetro de configuración Cantidad máxima de conexiones del compilador de PDT solo se aplica a las conexiones que se requieren para la recompilación de tablas, no a las conexiones que se necesitan para las verificaciones de activadores. Una verificación de activador es una consulta que verifica si se activa la estrategia de persistencia de la tabla. Debido a que estas consultas de verificación de activador siempre se ejecutan de forma secuencial, no se aplica el parámetro de configuración Cantidad máxima de conexiones del compilador de PDT.
  • En una instancia de Looker agrupada en clústeres, el regenerador se ejecuta solo en el nodo principal. El parámetro de configuración Cantidad máxima de conexiones del compilador de PDT solo se aplica al nodo principal y, por lo tanto, establece el límite para todo el clúster.
  • El parámetro de configuración Cantidad máxima de conexiones del compilador de PDT no se aplica a los siguientes tipos de tablas. Estos tipos de tablas se compilan de forma consecutiva:
    • Tablas que se conservan a través del parámetro persist_for (a menos que la tabla dependa de tablas que usen las estrategias datagroup_trigger o sql_trigger_value)
    • Tablas en el modo de desarrollo.
    • Tablas que se volvieron a compilar con la opción Volver a compilar tablas derivadas y ejecutar
    • Tablas en las que una depende de otra en una cascada de dependencias. Una tabla no se puede compilar al mismo tiempo que una tabla de la que depende. Por ejemplo, si table_B depende de table_A, entonces table_A debe terminar de volver a compilarse antes de que table_B pueda comenzar a volver a compilarse.

Reintentar compilaciones de PDT con errores

El botón de activación Reintentar compilaciones de PDT con errores configura cómo el regenerador de Looker intenta volver a compilar las tablas con activador de persistencia que fallaron en el ciclo anterior del regenerador. El regenerador de Looker es el proceso que vuelve a compilar las tablas con activador de persistencia (PDT y tablas de datos agregados) según el intervalo que se configura en el parámetro de conexión Programa de mantenimiento. Cuando se habilita el botón de activación Retry Failed PDT Builds, el regenerador de Looker intentará volver a compilar una PDT que falló en el ciclo anterior del regenerador, incluso si no se cumple la condición de activación de la PDT. Cuando se inhabilita este parámetro de configuración, el regenerador de Looker intentará volver a compilar una PDT que falló anteriormente solo cuando se cumpla la condición de activación de la PDT. La opción Reintentar compilaciones de PDT con errores está inhabilitada de forma predeterminada.

Consulta la página de documentación Tablas derivadas en Looker para obtener más información sobre el regenerador de Looker.

Control de la API de PDT

El botón de activación Control de la API de PDT determina si las llamadas a la API start_pdt_build, check_pdt_build y stop_pdt_build se pueden usar para esta conexión. Cuando el botón de activación Control de la API de PDT está inhabilitado, estas llamadas a la API fallarán cuando hagan referencia a PDT en esta conexión. El botón de activación Control de la API de PDT está inhabilitado de forma predeterminada.

Habilitar anulaciones de PDT

Si tu base de datos admite tablas derivadas persistentes y activaste el botón de activación Habilitar PDT en la configuración de la conexión, Looker mostrará el botón de activación Anulaciones de PDT. Habilita el botón de activación Anulaciones de PDT para mostrar la sección Anulaciones de PDT, en la que puedes ingresar parámetros de JDBC separados (host, puerto, base de datos, nombre de usuario, contraseña, esquema, parámetros adicionales y sentencias posteriores a la conexión) que son específicos para los procesos de PDT. Esto puede ser valioso por varios motivos:

  • Si creas un usuario de base de datos independiente para los procesos de PDT, puedes usar PDT en tu proyecto de Looker, incluso si asignas atributos de usuario a tus credenciales de acceso a la base de datos o usas OAuth para tu conexión de base de datos.
  • Los procesos de PDT pueden autenticarse a través de un usuario de base de datos independiente que tenga una prioridad más alta. De esta manera, la base de datos puede priorizar los trabajos de PDT sobre las consultas de usuarios menos críticas.
  • Se puede revocar el acceso de escritura para la conexión de base de datos estándar de Looker y otorgarlo solo a un usuario especial que los procesos de PDT usarán para la autenticación. Esta es una mejor estrategia de seguridad para la mayoría de las organizaciones.
  • En el caso de bases de datos como Snowflake, los procesos de PDT se pueden enrutar a hardware más potente que no se comparte con el resto de los usuarios de Looker. De esta manera, las PDT se pueden compilar con rapidez sin incurrir en el costo de ejecutar hardware costoso a tiempo completo.

Por ejemplo, en una conexión en la que los campos de nombre de usuario y contraseña se establecen en atributos de usuario, la sección Anulaciones de PDT puede crear un usuario independiente (pdt_user) con su propia contraseña. Con esta configuración, ocurrirá lo siguiente:

  • Cada usuario puede acceder a la base de datos con sus credenciales individuales, según lo asignado por sus atributos de usuario.
  • La cuenta de pdt_user se usará para todos los procesos de PDT, con niveles de acceso adecuados para la creación y actualización de PDT.
  • El tráfico de consultas de los usuarios y el tráfico de procesos de PDT se pueden diferenciar rápidamente para fines como la supervisión con la Actividad del sistema.

zona horaria de la base de datos

Es la zona horaria en la que tu base de datos almacena la información basada en el tiempo. Looker necesita saber esto para poder convertir los valores de tiempo para los usuarios, lo que facilita la comprensión y el uso de los datos basados en el tiempo. Consulta la página de documentación Usa la configuración de zona horaria para obtener más información.

zona horaria de la consulta

La opción Zona horaria de la consulta solo se muestra si inhabilitaste las zonas horarias elegidas por los usuarios.

Cuando se inhabilitan las zonas horarias elegidas por los usuarios, la zona horaria de la consulta es la que se muestra a los usuarios cuando consultan datos basados en el tiempo y la zona horaria a la que Looker convertirá los datos basados en el tiempo de la zona horaria de la base de datos.

Consulta la página de documentación Usa la configuración de zona horaria para obtener más información.

Expande la sección Detalles del estado para probar la configuración de tu conexión.

Revisar

Una vez que hayas ingresado todos los parámetros de configuración de la conexión de la base de datos, puedes revisar y probar la conexión para asegurarte de que esté configurada correctamente.

Prueba la configuración de la conexión

Para probar la configuración de la conexión, haz clic en el botón Probar conexión en la sección Detalles del estado, en la parte inferior de la página Configuración de conexiones.

Si Looker muestra Can Connect, presiona Connect para crear la conexión. Luego, la conexión de tu base de datos se agrega a la lista en la página Administrador de Conexiones de Looker.

Los administradores pueden probar la conexión en cualquier momento. Para ello, deben hacer clic en el botón Probar junto a la lista de conexiones en la página Administrador de conexiones, como se describe en la página de documentación Conexiones.

Si configuraste uno o más valores de parámetros de conexión para un atributo de usuario, aparecerá la opción Probar como usuario. Selecciona un usuario y, luego, haz clic en Probar para verificar que la base de datos pueda conectarse y ejecutar consultas como este usuario.

Soluciona problemas

Si tu conexión no supera una o más pruebas, ten en cuenta lo siguiente:

  • Si ejecutas la versión 3.6 o anterior de Mongo en Atlas y obtienes un error de vínculo de comunicación, consulta la página de documentación de Mongo Connector.
  • Para recibir mensajes de conexión exitosa relacionados con el esquema temporal y las PDT, debes permitir esa funcionalidad cuando configures tu base de datos de Looker. Puedes encontrar instrucciones para hacerlo en la página de documentación Instrucciones de configuración de la base de datos.
  • Las conexiones de bases de datos que usan OAuth, como Snowflake, Google BigQuery, Trino y Databricks, requieren un acceso de usuario. Si no accediste a tu cuenta de usuario de OAuth cuando pruebas una de estas conexiones, Looker muestra una advertencia con un vínculo para acceder. Haz clic en el vínculo, selecciona Autorizar en el cuadro de diálogo Autorizar conexión de OAuth si se te solicita y, luego, ingresa tus credenciales de OAuth para permitir que Looker acceda a la información de tu cuenta de OAuth.
  • En el caso de las instancias de Looker alojadas por el cliente, consulta la página de documentación Prueba la conectividad de la base de datos para las instancias alojadas por el cliente para obtener sugerencias para solucionar problemas.

Próximos pasos

Después de conectar tu base de datos a Looker, podrás configurar las opciones de acceso para tus usuarios.