Apache Druid

Encripta el tráfico de red

Una práctica recomendada es 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 bases 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

Desactivando la aproximación de COUNT DISTINCT (opcional)

De forma predeterminada, Druid tiene una aproximación de 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`

Cómo crear 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 a 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 más 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+ o Apache Druid 0.18+.

  • Host: DNS o dirección IP del agente del clúster. Puedes encontrarlo en el 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. De lo contrario, 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: El esquema predeterminado que se usa cuando no se especifica un esquema. Ingresar un esquema es opcional.

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

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

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

  • Programa de mantenimiento de grupos de datos y PDT: Una expresión cron que indica cuándo Looker debe verificar los grupos de datos y las 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 tu clúster de Apache Druid está configurado para usar TLS de Drruid.

  • Verificar SSL: Verifica si se aplica una 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 inicialmente en el valor predeterminado. Consulta la página de documentación Cómo 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.

  • Almacenamiento previo en caché del Runner de SQL: Para hacer que el Ejecutor de SQL no precargue la información de la tabla y cargue la información de la tabla solo cuando una tabla está seleccionada, borra esta opción. Obtén más información sobre esta configuración en la documentación de Precaché de SQL Runner.

  • Zona horaria de la base de datos: Es la zona horaria de la base de datos. Compatible con Apache Druid 0.13 o versiones posteriores y Apache Druid 0.18 o versiones posteriores.

Para verificar que la conexión se haya establecido correctamente, haz clic en Probar. Consulta la página de documentación Cómo probar 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 la combinación de catálogo y esquema exista ni que el usuario tenga el acceso requerido 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 tu conexión y 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 la base de datos también debe admitirlas.

Apache Druid

A partir de Looker 24.16, 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
Pivotes basados 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 de valores distintos
No
Procesos de presentación del ejecutor de SQL
No
Tabla de descripción del ejecutor de SQL
No
Índices de programas del ejecutor de SQL
No
Selección del ejecutor de SQL 10
Sí
Cantidad de Ejecutor de SQL
Sí
Explicación de SQL
Sí
Credenciales de OAuth
No
Comentarios contextuales
Sí
Agrupación de conexiones
No
Esbozos de HLL
No
Aggregate Awareness
No
PDT incrementales
No
Milisegundos
Sí
Microsegundos
No
Vistas materializadas
No
Distinción de recuento aproximado
No

Apache Druid 0.13 y versiones posteriores

Apache Druid 0.13 y versiones posteriores admiten las siguientes funciones a partir de Looker 24.16:

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
Pivotes basados 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 de valores distintos
No
Procesos de presentación del ejecutor de SQL
No
Tabla de descripción del ejecutor de SQL
No
Índices de programas del ejecutor de SQL
No
Selección del ejecutor de SQL 10
Sí
Cantidad de Ejecutor de SQL
Sí
Explicación de SQL
Sí
Credenciales de OAuth
No
Comentarios contextuales
Sí
Agrupación de conexiones
No
Esbozos de HLL
No
Aggregate Awareness
No
PDT incrementales
No
Milisegundos
Sí
Microsegundos
No
Vistas materializadas
No
Distinción de recuento aproximado
No

Apache Druid 0.18 y versiones posteriores

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

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
Pivotes basados 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 de valores distintos
No
Procesos de presentación del ejecutor de SQL
No
Tabla de descripción del ejecutor de SQL
No
Índices de programas del ejecutor de SQL
No
Selección del ejecutor de SQL 10
Sí
Cantidad de Ejecutor de SQL
Sí
Explicación de SQL
Sí
Credenciales de OAuth
No
Comentarios contextuales
Sí
Agrupación de conexiones
No
Esbozos de HLL
No
Aggregate Awareness
No
PDT incrementales
No
Milisegundos
Sí
Microsegundos
No
Vistas materializadas
No
Distinción de recuento aproximado
No

Próximos pasos

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