Apache Druid

Configura el 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.

Cómo habilitar 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 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, seleccione Conexiones y, luego, haga clic en Agregar conexión.

Completa los detalles de la conexión. La mayoría de las opciones 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. Algunos de los parámetros de configuración se describen a continuación:

  • Nombre: Es el nombre de la conexión.
  • Dialect: Apache Druid 0.13 o versiones posteriores, o Apache Druid 0.18+
  • Host: El DNS o la dirección IP del clúster Broker. Puedes encontrarlo en el archivo broker/runtime.properties.
  • Puerto: El puerto del Broker. 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: El nombre de usuario de la base de datos si el clúster de Apache Druid está configurado para usar seguridad básica de Druid. De lo contrario, puede especificar cualquier string.
  • Contraseña: La contraseña del usuario Si tu clúster no está configurado para usar seguridad básica de Druid, puedes especificar cualquier string.
  • Esquema: Es el esquema predeterminado que se usará cuando no haya un esquema especificado. 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 grupos de datos y PDT: Es 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 Programa de mantenimiento de PDT y grupos de datos.

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

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

  • Cantidad máxima de conexiones por nodo: El valor predeterminado es 25. Esta configuración se puede dejar con 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é de SQL Runner: Si quieres que SQL Runner no cargue previamente la información de la tabla y que solo se cargue la tabla, desmarca esta opción. Obtén más información sobre este parámetro de configuración en la documentación del almacenamiento previo en caché de ejecutor de SQL.

  • Zona horaria de la base de datos: La zona horaria de la base de datos. Compatible con Apache Druid 0.13+ y Apache Druid 0.18+.

Para verificar que la conexión se realice de forma correcta, haz clic en Probar. Consulta la página de documentación sobre 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 exista la combinación de catálogo y esquema ni que el usuario tenga el acceso requerido para ese esquema.

Si tienes problemas, consulta la documentación de Pruebas de conexión.

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

Probar la conexión en el ejecutor de SQL Navegue a SQL Runner, seleccione su conexión y esquema, y verifique si puede ver las tablas de su base de datos.

Compatibilidad de características

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

Apache Druid

Apache Druid es compatible con las siguientes funciones a partir de Looker 23.8:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
No
Agregaciones simétricas
No
Tablas derivadas
Sí
Tablas derivadas de SQL persistente
No
Tablas derivadas persistentes nativas
No
Vistas estables
No
Asesinato 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 distintivo
No
Procesos de Show del ejecutor de SQL
No
Tabla de descripción del ejecutor de SQL
No
Índices de SQL Runner Show
No
Ejecutor de SQL Select 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
Distinto del recuento aproximado
No

Apache Druid 0.13+

Apache Druid 0.13+ es compatible con las siguientes funciones a partir de Looker 23.8:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
No
Agregaciones simétricas
No
Tablas derivadas
Sí
Tablas derivadas de SQL persistente
No
Tablas derivadas persistentes nativas
No
Vistas estables
No
Asesinato 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 distintivo
No
Procesos de Show del ejecutor de SQL
No
Tabla de descripción del ejecutor de SQL
No
Índices de SQL Runner Show
No
Ejecutor de SQL Select 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
Distinto del recuento aproximado
No

Apache Druid 0.18+

Apache Druid 0.18+ es compatible con las siguientes funciones a partir de Looker 23.8:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
Sí
Agregaciones simétricas
No
Tablas derivadas
Sí
Tablas derivadas de SQL persistente
No
Tablas derivadas persistentes nativas
No
Vistas estables
No
Asesinato 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 distintivo
No
Procesos de Show del ejecutor de SQL
No
Tabla de descripción del ejecutor de SQL
No
Índices de SQL Runner Show
No
Ejecutor de SQL Select 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
Distinto del recuento aproximado
No

Próximos pasos

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