Encripta el tráfico de red
Se recomienda encriptar el tráfico de red entre la aplicación de Looker y tu base de datos. Considera una de las opciones que se describen en la página de documentación Habilita el acceso seguro a la base de datos.
Configura tu clúster de Apache Druid
<DRUID_BASE_DIR> hace referencia al directorio base en el que se instala el clúster de Apache Druid en un servidor.
Habilita SQL
Para habilitar SQL en tu base de datos de Druid, agrega esta línea al archivo de configuración broker/runtime.properties:
<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties
druid.sql.enable=true
Desactivación de la aproximación de COUNT DISTINCT (opcional)
De forma predeterminada, Druid aproxima COUNT DISTINCT. Para obtener resultados precisos, agrega esta línea al archivo de configuración broker/runtime.properties:
<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties
`druid.sql.planner.useApproximateCountDistinct=false`
Crea la conexión de Looker a tu base de datos
En la sección Administrador de Looker, selecciona Conexiones y, luego, haz clic en Agregar conexión.
Completa los detalles de la conexión. La mayoría de los parámetros de configuración son comunes en la mayoría de los dialectos de bases de datos. Consulta la página de documentación Conecta Looker a tu base de datos para obtener información. A continuación, se describen algunos de los parámetros de configuración:
- Nombre: Es el nombre de la conexión.
Dialecto: Apache Druid, Apache Druid 0.13+ (Apache Druide 0.13.x - 0.17.x) o Apache Druid 0.18+.
Host: Es la dirección IP o el DNS del Broker del clúster. Puedes encontrarlo en tu archivo
broker/runtime.properties.Puerto: Es el puerto del agente. El puerto predeterminado es 8082. Si tu clúster está protegido por SSL, el puerto predeterminado es 8182.
Base de datos: Es el nombre de tu base de datos. El valor predeterminado es
druid.Nombre de usuario: Es el nombre de usuario de la base de datos si tu clúster de Apache Druid está configurado para usar la seguridad básica de Druid. Si no es así, puedes especificar cualquier cadena.
Contraseña: Es la contraseña del usuario. Si tu clúster no está configurado para usar la seguridad básica de Druid, puedes especificar cualquier cadena.
Esquema: Es el esquema predeterminado que se usará cuando no se especifique ninguno. Ingresar un esquema es opcional.
Parámetros adicionales de JDBC: Son parámetros de JDBC de Avatica delimitados por punto y coma. Consulta la sección Parámetros de JDBC admitidos en esta página para ver la lista de parámetros que admite Looker.
- Estas propiedades se pueden establecer como propiedades de conexión:
useApproximateCountDistinctuseApproximateTopNuseFallbacksqlTimeZone
Ejemplo:
none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit- Estas propiedades se pueden establecer como propiedades de conexión:
Programa de mantenimiento: Es una expresión
cronque indica cuándo Looker debe verificar los grupos de datos y las tablas derivadas persistentes. Obtén más información sobre este parámetro de configuración en la documentación de Programa de mantenimiento.SSL: Verifica si tu clúster de Apache Druid está configurado para usar TLS de Druid.
Verificar SSL: Marca esta opción para aplicar de manera forzosa la verificación estricta del nombre de host.
Cantidad máxima de conexiones por nodo: El valor predeterminado es 25. Este parámetro de configuración se puede dejar en el valor predeterminado inicialmente. Consulta la página de documentación Conecta Looker a tu base de datos para obtener más información.
Tiempo de espera del grupo de conexiones: El valor predeterminado es de 120 segundos.
Almacenamiento previo en caché del Ejecutor de SQL: Para que el Ejecutor de SQL no cargue previamente la información de la tabla y solo la cargue cuando se seleccione una tabla, desmarca esta opción. Obtén más información sobre este parámetro de configuración en la documentación de Almacenamiento previo en caché del Ejecutor de SQL.
Zona horaria de la base de datos: Es la zona horaria de la base de datos. Compatible con Apache Druid 0.13 y versiones posteriores, y Apache Druid 0.18 y versiones posteriores.
Para verificar que la conexión se haya establecido correctamente, 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 la conexión.
Looker ejecuta una consulta SELECT 1 para verificar una conexión básica y realizar una prueba de consulta. No valida que exista la combinación de catálogo y esquema, ni que el usuario tenga el acceso requerido a ese esquema.
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 de la página Conexiones de Administrador de Looker.
Prueba la conexión en el Ejecutor de SQL. Navega al Ejecutor de SQL, selecciona tu conexión y esquema, y, luego, verifica si puedes ver las tablas de tu base de datos.
Parámetros de JDBC admitidos
Para Apache Druid, Looker admite los siguientes parámetros de JDBC en el campo Parámetros de JDBC adicionales de la conexión. Consulta la documentación de tu base de datos para obtener información sobre estos parámetros.
authenticationavatica_passwordavatica_userserializationsqlTimeZonetimeZoneuseApproximateCountDistinctuseApproximateTopNuseFallbackurl
Compatibilidad de funciones
Para que Looker admita algunas funciones, el dialecto de tu base de datos también debe admitirlas.
Apache Druid
Apache Druid admite las siguientes funciones a partir de Looker 26.22:
| Función | ¿Es compatible? |
|---|---|
| Looker (Google Cloud Core) | |
| Agregaciones simétricas | |
| Tablas derivadas | |
| Tablas derivadas de SQL persistentes | |
| Tablas derivadas persistentes nativas | |
| Vistas estables | |
| Eliminación de consultas | |
| Tablas dinámicas basadas en SQL | |
| Zonas horarias | |
| SSL | |
| Subtotales | |
| Parámetros adicionales de JDBC | |
| Distingue mayúsculas de minúsculas | |
| Tipo de ubicación | |
| Tipo de lista | |
| Percentil | |
| Percentil de valores distintos | |
| Mostrar procesos del Ejecutor de SQL | |
| Describe Table del Ejecutor de SQL | |
| Ejecutor de SQL: Mostrar índices | |
| Seleccionar 10 en el Ejecutor de SQL | |
| Recuento del Ejecutor de SQL | |
| SQL Explain | |
| Credenciales de OAuth 2.0 | |
| Comentarios de contexto | |
| Agrupación de conexiones | |
| Esbozos de HLL | |
| Reconocimiento agregado | |
| PDT incrementales | |
| Milisegundos | |
| Microsegundos | |
| Vistas materializadas | |
| Mediciones entre períodos | |
| Distinción de recuento aproximado | |
| Modelos analíticos en la base de datos | |
| Calendarios personalizados |
Apache Druid 0.13.x - 0.17.x
Apache Druid 0.13.x - 0.17.x admite las siguientes funciones a partir de Looker 26.22:
| Función | ¿Es compatible? |
|---|---|
| Looker (Google Cloud Core) | |
| Agregaciones simétricas | |
| Tablas derivadas | |
| Tablas derivadas de SQL persistentes | |
| Tablas derivadas persistentes nativas | |
| Vistas estables | |
| Eliminación de consultas | |
| Tablas dinámicas basadas en SQL | |
| Zonas horarias | |
| SSL | |
| Subtotales | |
| Parámetros adicionales de JDBC | |
| Distingue mayúsculas de minúsculas | |
| Tipo de ubicación | |
| Tipo de lista | |
| Percentil | |
| Percentil de valores distintos | |
| Mostrar procesos del Ejecutor de SQL | |
| Describe Table del Ejecutor de SQL | |
| Ejecutor de SQL: Mostrar índices | |
| Seleccionar 10 en el Ejecutor de SQL | |
| Recuento del Ejecutor de SQL | |
| SQL Explain | |
| Credenciales de OAuth 2.0 | |
| Comentarios de contexto | |
| Agrupación de conexiones | |
| Esbozos de HLL | |
| Reconocimiento agregado | |
| PDT incrementales | |
| Milisegundos | |
| Microsegundos | |
| Vistas materializadas | |
| Mediciones entre períodos | |
| Distinción de recuento aproximado | |
| Modelos analíticos en la base de datos | |
| Calendarios personalizados |
Apache Druid 0.18 o versiones posteriores
Apache Druid 0.18 y versiones posteriores admiten las siguientes funciones a partir de Looker 26.22:
| Función | ¿Es compatible? |
|---|---|
| Looker (Google Cloud Core) | |
| Agregaciones simétricas | |
| Tablas derivadas | |
| Tablas derivadas de SQL persistentes | |
| Tablas derivadas persistentes nativas | |
| Vistas estables | |
| Eliminación de consultas | |
| Tablas dinámicas basadas en SQL | |
| Zonas horarias | |
| SSL | |
| Subtotales | |
| Parámetros adicionales de JDBC | |
| Distingue mayúsculas de minúsculas | |
| Tipo de ubicación | |
| Tipo de lista | |
| Percentil | |
| Percentil de valores distintos | |
| Mostrar procesos del Ejecutor de SQL | |
| Describe Table del Ejecutor de SQL | |
| Ejecutor de SQL: Mostrar índices | |
| Seleccionar 10 en el Ejecutor de SQL | |
| Recuento del Ejecutor de SQL | |
| SQL Explain | |
| Credenciales de OAuth 2.0 | |
| Comentarios de contexto | |
| Agrupación de conexiones | |
| Esbozos de HLL | |
| Reconocimiento agregado | |
| PDT incrementales | |
| Milisegundos | |
| Microsegundos | |
| Vistas materializadas | |
| Mediciones entre períodos | |
| Distinción de recuento aproximado | |
| Modelos analíticos en la base de datos | |
| Calendarios personalizados |
Próximos pasos
Después de completar la conexión de la base de datos, configura las opciones de autenticación.