Apache Druid

Cifrar el tráfico de red

Te recomendamos que cifres el tráfico de red entre la aplicación Looker y tu base de datos. Considera una de las opciones descritas en la página de documentación Habilitar el acceso seguro a la base de datos.

Configurar un 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.

Habilitar SQL

Para habilitar SQL en tu base de datos de Druid, añade esta línea al archivo de configuración broker/runtime.properties:

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

druid.sql.enable=true

Desactivar la aproximación de COUNT DISTINCT (opcional)

De forma predeterminada, Druid aproxima COUNT DISTINCT. Para obtener resultados precisos, añade esta línea al archivo de configuración broker/runtime.properties:

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

`druid.sql.planner.useApproximateCountDistinct=false`

Crear la conexión de Looker a tu base de datos

En la sección Administrar de Looker, selecciona Conexiones y, a continuación, haz clic en Añadir conexión.

Rellena los detalles de la conexión. La mayoría de los ajustes son comunes a la mayoría de los dialectos de bases de datos. Consulta la página de documentación Conectar Looker a tu base de datos para obtener información. A continuación, se describen algunos de los ajustes:

  • Nombre: el nombre de la conexión.

  • Dialecto: Apache Druid, Apache Druid 0.13+ (Apache Druid 0.13.x - 0.17.x) o Apache Druid 0.18+.

  • Host: dirección DNS o IP del broker del clúster. Puedes encontrarlo en el archivo broker/runtime.properties.

  • Puerto: puerto del broker. El puerto predeterminado es 8082. Si tu clúster está protegido con SSL, el puerto predeterminado es 8182.

  • Base de datos: el nombre de tu base de datos. El valor predeterminado es druid.

  • Nombre de usuario: el nombre de usuario de la base de datos si tu clúster de Apache Druid está configurado para usar seguridad básica de Druid. Si no es así, puedes especificar cualquier cadena.

  • Contraseña: la contraseña del usuario. Si tu clúster no está configurado para usar Druid Basic Security, puedes especificar cualquier cadena.

  • Esquema: el esquema predeterminado que se usará cuando no se especifique ninguno. Introducir un esquema es opcional.

  • Parámetros JDBC adicionales: parámetros JDBC de Avatica separados por punto y coma.

    • Estas propiedades se pueden definir como propiedades de conexión:
      • useApproximateCountDistinct
      • useApproximateTopN
      • useFallback
      • sqlTimeZone

    Ejemplo: none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

  • Programación de mantenimiento: una expresión cron que indica cuándo debe comprobar Looker los grupos de datos y las tablas derivadas persistentes. Consulta más información sobre este ajuste en la documentación Programación de mantenimiento.

  • SSL comprueba si tu clúster de Apache Druid está configurado para usar TLS de Druid.

  • Verificar SSL: marca esta opción para aplicar una verificación estricta del nombre de host.

  • Máximo de conexiones por nodo: el valor predeterminado es 25. Este ajuste se puede dejar con el valor predeterminado al principio. Consulta la página de documentación Conectar Looker a tu base de datos para obtener más información.

  • Tiempo de espera del grupo de conexiones: el valor predeterminado es 120 segundos.

  • Precaché de Ejecutor de SQL: para que Ejecutor de SQL no precargue la información de las tablas y solo la cargue cuando se seleccione una tabla, desactive esta opción. Consulta más información sobre este ajuste en la documentación de Precache de SQL Runner.

  • Zona horaria de la base de datos: 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 ha realizado correctamente, haz clic en Probar. Consulta la página de documentación Probar la conectividad de la base de datos para obtener información sobre cómo solucionar problemas.

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 necesario a ese esquema.

Si tienes algún problema, consulta nuestra documentación sobre pruebas de conexiones.

Para guardar estos ajustes, haz clic en Conectar.

Prueba la conexión en SQL Runner. Ve a SQL Runner, selecciona tu conexión y tu esquema y comprueba si puedes ver las tablas de tu base de datos.

Funciones admitidas

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 25.14:

Función ¿Es compatible?
Nivel de asistencia
Compatible
Looker (servicio principal de Google Cloud)
No
Agregados simétricos
No
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
No
Tablas derivadas nativas persistentes
No
Vistas estables
No
Eliminación de consultas
No
Pivotes basados en SQL
No
Zonas horarias
No
SSL
Sí
Subtotales
No
Parámetros adicionales de JDBC
Sí
Distingue entre mayúsculas y minúsculas
Sí
Tipo de ubicación
Sí
Tipo de lista
No
Percentil
No
Percentil de valores distintos
No
SQL Runner Show Processes
No
SQL Runner Describe Table
No
SQL Runner Show Indexes
No
SQL Runner Select 10
Sí
Recuento de SQL Runner
Sí
Explicación de SQL
Sí
Credenciales de OAuth 2.0
No
Comentarios contextuales
Sí
Grupo de conexiones
No
Esquemas HLL
No
Notoriedad agregada
No
PDTs incrementales
No
Milisegundos
Sí
Microsegundos
No
Vistas materializadas
No
Métricas de comparación con el periodo anterior
No
Recuento aproximado de valores distintos
No

Apache Druid 0.13+ (Apache Druid 0.13.x - 0.17.x)

Apache Druid 0.13+ admite las siguientes funciones a partir de Looker 25.14:

Función ¿Es compatible?
Nivel de asistencia
Compatible
Looker (servicio principal de Google Cloud)
No
Agregados simétricos
No
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
No
Tablas derivadas nativas persistentes
No
Vistas estables
No
Eliminación de consultas
No
Pivotes basados en SQL
No
Zonas horarias
Sí
SSL
Sí
Subtotales
No
Parámetros adicionales de JDBC
Sí
Distingue entre mayúsculas y minúsculas
Sí
Tipo de ubicación
No
Tipo de lista
No
Percentil
No
Percentil de valores distintos
No
SQL Runner Show Processes
No
SQL Runner Describe Table
No
SQL Runner Show Indexes
No
SQL Runner Select 10
Sí
Recuento de SQL Runner
Sí
Explicación de SQL
Sí
Credenciales de OAuth 2.0
No
Comentarios contextuales
Sí
Grupo de conexiones
No
Esquemas HLL
No
Notoriedad agregada
No
PDTs incrementales
No
Milisegundos
Sí
Microsegundos
No
Vistas materializadas
No
Métricas de comparación con el periodo anterior
No
Recuento aproximado de valores distintos
No

Apache Druid 0.18 o versiones posteriores

Apache Druid 0.18 y versiones posteriores admiten las siguientes funciones a partir de Looker 25.14:

Función ¿Es compatible?
Nivel de asistencia
Compatible
Looker (servicio principal de Google Cloud)
Sí
Agregados simétricos
No
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
No
Tablas derivadas nativas persistentes
No
Vistas estables
No
Eliminación de consultas
No
Pivotes basados en SQL
No
Zonas horarias
Sí
SSL
Sí
Subtotales
No
Parámetros adicionales de JDBC
Sí
Distingue entre mayúsculas y minúsculas
Sí
Tipo de ubicación
Sí
Tipo de lista
No
Percentil
No
Percentil de valores distintos
No
SQL Runner Show Processes
No
SQL Runner Describe Table
No
SQL Runner Show Indexes
No
SQL Runner Select 10
Sí
Recuento de SQL Runner
Sí
Explicación de SQL
Sí
Credenciales de OAuth 2.0
No
Comentarios contextuales
Sí
Grupo de conexiones
No
Esquemas HLL
No
Notoriedad agregada
No
PDTs incrementales
No
Milisegundos
Sí
Microsegundos
No
Vistas materializadas
No
Métricas de comparación con el periodo anterior
No
Recuento aproximado de valores distintos
No

Pasos siguientes

Una vez que hayas completado la conexión de la base de datos, configura las opciones de autenticación.