Apache Druid

Encriptación del 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 Cómo habilitar 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

Cómo desactivar 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`

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 en la mayoría de los dialectos de bases de datos. Consulta la página de documentación Cómo conectar 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.

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

• Host: Es la dirección IP o 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 con 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 Druid Basic Security, puedes especificar cualquier cadena.

• Esquema: Es el esquema predeterminado que se usa cuando no se especifica 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 establecer como propiedades de conexión:
    • useApproximateCountDistinct
    • useApproximateTopN
    • useFallback
    • sqlTimeZone

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

• Programa de mantenimiento: Es una expresión cron que indica cuándo debe verificar Looker 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: Comprueba si tu clúster de Apache Druid está configurado para usar Druid TLS.

• 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. Inicialmente, este parámetro de configuración se puede dejar 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 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 la cargue solo cuando se selecciona una tabla, desmarca esta opción. Obtén más información sobre este parámetro de configuración en la documentación de SQL Runner Precache.

• Zona horaria de la base de datos: Es la zona horaria de la base de datos. Es compatible con Apache Druid 0.13 y Apache Druid 0.18.

Para verificar que la conexión se haya realizado correctamente, 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 requerido a ese esquema.

Si tienes algún problema, consulta nuestra documentación sobre cómo probar las conexiones.

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

Prueba la conexión en el Ejecutor de SQL. Navega al SQL Runner, 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, tu dialecto de base de datos también debe admitirlas.

Apache Druid

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

Apache Druid 0.13 y versiones posteriores (Apache Druid 0.13.x a 0.17.x)

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

Apache Druid 0.18 y versiones posteriores

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

Próximos pasos

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