ClickHouse

Conecta Looker a tu base de datos de ClickHouse para analizar tus datos y crear paneles interactivos. Esta conexión ayuda a que tus datos de ClickHouse estén disponibles para la generación de informes y el análisis en Looker, lo que permite tomar decisiones directas basadas en datos.

En esta página, se explica cómo configurar tu instancia de ClickHouse y los parámetros de configuración de conexión de Looker, lo que incluye cómo encriptar el tráfico de red, definir los permisos del usuario y revisar las funciones admitidas. Looker admite ClickHouse versión 0.2 o posterior, y ClickHouse 26 o posterior con controladores JDBC modernizados y compatibilidad con la agregación simétrica.

Encriptación del 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 Cómo habilitar el acceso seguro a la base de datos.

Para habilitar el cifrado SSL en el servidor, consulta la documentación de la configuración global del servidor de ClickHouse.

Usuarios y seguridad

Primero, configura tu usuario de Looker en el servidor de ClickHouse. Los usuarios de la base de datos de ClickHouse se pueden configurar con SQL (CREATE USER) o a través de la sección users en el archivo users.xml. Sigue la documentación sobre los derechos de acceso de ClickHouse para configurar el acceso de los usuarios. En el siguiente ejemplo básico, se usa users.xml:

<!-- Users and ACL. -->
<users>
    <looker>
        <password>CHANGEIT</password>
        <networks incl="networks" />
        <profile>default</profile>
        <quota>default</quota>
    </looker>

    <web>
        <password></password>
        <networks incl="networks" />
        <profile>web</profile>
        <quota>default</quota>
        <allow_databases>
           <database>test</database>
        </allow_databases>
        <allow_dictionaries>
           <dictionary>test</dictionary>
        </allow_dictionaries>
    </web>
</users>

También dentro de este archivo, configura el acceso a la base de datos adecuado:

<allow_databases>
    <database>database_1</database>
    <database>database_2</database>
    <database>database_3</database>
</allow_databases>

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

  • Dialect: Selecciona ClickHouse 26+ o ClickHouse.
  • Host: Nombre de host o dirección IP accesibles del servidor de ClickHouse.
  • Puerto: Es el puerto en el que se puede acceder al servicio de ClickHouse a través de HTTP(S).
    • De forma predeterminada, las conexiones HTTP usan 8123 y las conexiones HTTPS usan 8443.
    • Los puertos 9000 y 9440 se usan de forma predeterminada en el cliente de línea de comandos TCP nativo de ClickHouse, pero Looker debe usar los puertos HTTP(S) para conectarse a ClickHouse.
    • Es posible que el administrador de ClickHouse haya elegido puertos alternativos con la configuración http_port o https_port en la configuración de ClickHouse. Pídele al administrador de ClickHouse la configuración adecuada para tu configuración.
  • Base de datos: Nombre de la base de datos (debe ser una de las bases de datos permitidas en tus permisos de ClickHouse).
  • Nombre de usuario: Nombre de usuario de la base de datos.
  • Contraseña: Contraseña de la base de datos.
  • SSL: Marca esta opción para conectarte a ClickHouse a través de SSL/TLS.
  • Verificar SSL: (Opcional) Marca esta opción para aplicar una verificación estricta del certificado SSL y del nombre de host en el servidor de ClickHouse. Selecciona Verificar SSL solo si usas un certificado SSL firmado por una autoridad certificadora generalmente confiable. Si usas un certificado SSL autofirmado, deja esta configuración sin marcar.
  • Parámetros adicionales de JDBC: (Opcional) Son parámetros adicionales de la cadena de JDBC. Consulta la sección Parámetros JDBC admitidos en esta página para ver la lista de parámetros que admite Looker.

Para verificar que la conexión se realizó correctamente, haz clic en el botón Probar conexión en la sección Detalles del estado que se encuentra en la parte inferior de la página Configuración de conexión.

Si Looker muestra Se puede conectar, presiona Conectar para crear la conexión.

Luego, tu conexión de base de datos se agregará a la lista en la página Connections Admin de Looker.

Parámetros de JDBC admitidos

En el caso de ClickHouse, Looker admite los siguientes parámetros de JDBC en el campo Parámetros de JDBC adicionales de la conexión. Consulta la documentación de tu base de datos para obtener información sobre estos parámetros.

Parámetros de ClickHouse 26 y versiones posteriores

  • async_insert
  • autoCommit
  • compress
  • compress_algorithm
  • compress_level
  • connect_timeout
  • connection_timeout
  • continueBatchOnError
  • createDatabaseIfNotExist
  • custom_settings
  • database
  • databaseTerm
  • externalDatabase
  • fetchSize
  • format
  • jdbcCompliant
  • keep_alive_timeout
  • max_buffer_size
  • max_execution_time
  • max_result_bytes
  • max_result_rows
  • max_threads
  • namedParameter
  • query_timeout
  • receive_timeout
  • result_overflow_mode
  • retry
  • session_check
  • session_id
  • session_timeout
  • session_timezone
  • socket_timeout
  • ssl
  • sslmode
  • transactionSupport
  • use_server_time_zone
  • use_time_zone
  • wait_for_async_insert
  • wrapperObject

Parámetros de ClickHouse (heredado)

  • beta.row_binary_for_simple_insert
  • compress
  • connection_timeout
  • continueBatchOnError
  • createDatabaseIfNotExist
  • custom_http_headers
  • custom_http_params
  • default_query_settings
  • disable_frameworks_detection
  • jdbc_ignore_unsupported_values
  • jdbc_resultset_auto_close
  • jdbc_sql_parser
  • jdbc_use_max_result_rows
  • jdbcCompliance
  • max_execution_time
  • password
  • session_timezone
  • socket_timeout
  • typeMappings
  • use_server_time_zone
  • use_time_zone
  • user
  • wrapperObject

Compatibilidad de funciones

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

Compatibilidad con funciones de ClickHouse 26 y versiones posteriores

A partir de Looker 26.18, ClickHouse 26 y versiones posteriores admiten las siguientes funciones:

Función ¿Es compatible?
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas persistentes de SQL
Tablas derivadas persistentes nativas
Vistas estables
Cancelación de consultas
Tablas dinámicas basadas en SQL
Zonas horarias
SSL
Subtotales
Parámetros adicionales de JDBC
Distingue mayúsculas de minúsculas
Tipo de ubicación
Tipo de lista
Percentil
Percentil de valores distintos
Ejecutor de SQL: Mostrar procesos
Ejecutor de SQL: Describe la tabla
Ejecutor de SQL: Mostrar índices
Seleccionar 10 en el Ejecutor de SQL
Recuento del Ejecutor de SQL
Explicación de SQL
Credenciales de OAuth 2.0
Comentarios contextuales
Agrupación de conexiones
Esbozos de HLL
Reconocimiento agregado
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
Medidas comparativas entre períodos
Distinción de recuento aproximado
Modelos analíticos integrados en la base de datos
Calendarios personalizados

Compatibilidad con funciones de ClickHouse

A partir de Looker 26.18, ClickHouse admite las siguientes funciones:

Función ¿Es compatible?
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas persistentes de SQL
Tablas derivadas persistentes nativas
Vistas estables
Cancelación de consultas
Tablas dinámicas basadas en SQL
Zonas horarias
SSL
Subtotales
Parámetros adicionales de JDBC
Distingue mayúsculas de minúsculas
Tipo de ubicación
Tipo de lista
Percentil
Percentil de valores distintos
Ejecutor de SQL: Mostrar procesos
Ejecutor de SQL: Describe la tabla
Ejecutor de SQL: Mostrar índices
Seleccionar 10 en el Ejecutor de SQL
Recuento del Ejecutor de SQL
Explicación de SQL
Credenciales de OAuth 2.0
Comentarios contextuales
Agrupación de conexiones
Esbozos de HLL
Reconocimiento agregado
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
Medidas comparativas entre períodos
Distinción de recuento aproximado
Modelos analíticos integrados en la base de datos
Calendarios personalizados

Próximos pasos

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