Apache Druid

Configura el clúster de Apache Druid

<DRUID_BASE_DIR> hace referencia al directorio base en el que el clúster de Apache Druid está instalado 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

Desactivando la aproximación COUNT DISTINCT (opcional)

De forma predeterminada, Druid se aproxima a 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 las bases de datos. Consulta la página de documentación Conecta Looker a tu base de datos para obtener más información. A continuación, se describen algunas de las opciones de configuración:

  • Nombre: Es el nombre de la conexión.
  • Dialecto: Apache Druid, Apache Druid 0.13 y versiones posteriores, o Apache Druid 0.18 y versiones posteriores
  • Host: La dirección IP o el DNS del corredor del clúster. Puedes encontrarlo en el archivo broker/runtime.properties.
  • Puerto: Indica el puerto del Corredor. 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 Druid Basic Security. 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 Druid Basic Security, puedes especificar cualquier string.
  • Esquema: Es el esquema predeterminado que se usará cuando no se especifique ningún esquema. Ingresar un esquema es opcional.

  • Parámetros adicionales de JDBC: Parámetros de JDBC de Avatica delimitados por punto y coma

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

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

  • Programa de mantenimiento de PDT y grupos de datos: Es una expresión cron que indica cuándo Looker debe verificar grupos de datos y tablas derivadas persistentes. Obtén más información sobre esta configuración en la documentación del Programa de mantenimiento de grupos de datos y PDT.

  • SSL: Comprueba si el 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.

  • Cantidad máxima de conexiones por nodo: El valor predeterminado es 25. Inicialmente, esta configuración se puede dejar en el valor predeterminado. 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 realice una carga previa de la información de la tabla y la cargue solo cuando se seleccione una tabla, desmarca esta opción. Obtén más información sobre esta configuración en la documentación de Almacenamiento previo en caché del Ejecutor de SQL.

  • 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 sea exitosa, haz clic en Probar. Consulta la página de documentación Prueba la conectividad de la base de datos para obtener información sobre la solución de 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 cómo probar conexiones.

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

Prueba la conexión en el Ejecutor de SQL. Navega al ejecutor de SQL, selecciona la conexión y el esquema y, luego, verifica si puedes ver las tablas de tu base de datos.

Compatibilidad de características

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

Apache Druid

A partir de Looker 23.20, Apache Druid admite las siguientes funciones:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
No.
Agregados simétricos
No.
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
No.
Tablas derivadas persistentes nativas
No.
Vistas estables
No.
Cierre de consultas
No.
Tablas dinámicas basadas en SQL
No.
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
No.
Percentil
No.
Percentil distinto
No.
Mostrar procesos del Ejecutor de SQL
No.
Tabla de descripción del ejecutor de SQL
No.
Mostrar índices del Ejecutor de SQL
No.
Selección del Ejecutor de SQL 10
Sí
Recuento de ejecutores de SQL
Sí
Explicación de SQL
Sí
Credenciales de OAuth
No.
Comentarios de contexto
Sí
Agrupación de conexiones
No.
Bocetos de HLL
No.
Reconocimiento global
No.
PDT incrementales
No.
Milisegundos
Sí
Microsegundos
No.
Vistas materializadas
No.
Recuento aproximado distinto
No.

Apache Druid 0.13 y versiones posteriores

A partir de Looker 23.20, Apache Druid 0.13 y versiones posteriores admiten las siguientes funciones:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
No.
Agregados simétricos
No.
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
No.
Tablas derivadas persistentes nativas
No.
Vistas estables
No.
Cierre de consultas
No.
Tablas dinámicas basadas en SQL
No.
Zonas horarias
Sí
SSL
Sí
Subtotales
No.
Parámetros adicionales de JDBC
Sí
Distingue mayúsculas de minúsculas
Sí
Tipo de ubicación
No.
Tipo de lista
No.
Percentil
No.
Percentil distinto
No.
Mostrar procesos del Ejecutor de SQL
No.
Tabla de descripción del ejecutor de SQL
No.
Mostrar índices del Ejecutor de SQL
No.
Selección del Ejecutor de SQL 10
Sí
Recuento de ejecutores de SQL
Sí
Explicación de SQL
Sí
Credenciales de OAuth
No.
Comentarios de contexto
Sí
Agrupación de conexiones
No.
Bocetos de HLL
No.
Reconocimiento global
No.
PDT incrementales
No.
Milisegundos
Sí
Microsegundos
No.
Vistas materializadas
No.
Recuento aproximado distinto
No.

Apache Druid 0.18 y versiones posteriores

A partir de Looker 23.20, Apache Druid 0.18 y versiones posteriores admiten las siguientes funciones:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
Sí
Agregados simétricos
No.
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
No.
Tablas derivadas persistentes nativas
No.
Vistas estables
No.
Cierre de consultas
No.
Tablas dinámicas basadas en SQL
No.
Zonas horarias
Sí
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
No.
Percentil
No.
Percentil distinto
No.
Mostrar procesos del Ejecutor de SQL
No.
Tabla de descripción del ejecutor de SQL
No.
Mostrar índices del Ejecutor de SQL
No.
Selección del Ejecutor de SQL 10
Sí
Recuento de ejecutores de SQL
Sí
Explicación de SQL
Sí
Credenciales de OAuth
No.
Comentarios de contexto
Sí
Agrupación de conexiones
No.
Bocetos de HLL
No.
Reconocimiento global
No.
PDT incrementales
No.
Milisegundos
Sí
Microsegundos
No.
Vistas materializadas
No.
Recuento aproximado distinto
No.

Próximos pasos

Después de completar la conexión de la base de datos, configura las opciones de autenticación.