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, incluido cómo encriptar el tráfico de red, definir permisos de usuario y revisar las funciones compatibles. Looker admite ClickHouse versión 0.2 o posterior, y ClickHouse 26+ con controladores JDBC modernizados y compatibilidad con agregación simétrica.

Encripta el 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 Habilita el acceso seguro a la base de datos.

Para habilitar el encriptado 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 de 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>

Además, en este archivo, configura el acceso adecuado a la base de datos:

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

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 bases de datos. Consulta la página de documentación Conecta Looker a tu base de datos para obtener información. A continuación, se describen algunos de los parámetros de configuración:

• Dialecto: Selecciona ClickHouse 26+ o ClickHouse.
• Host: Nombre de host o dirección IP accesibles del servidor de ClickHouse.
• Puerto: 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.
• Database: 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 la verificación estricta del certificado SSL y del nombre de host en el servidor de ClickHouse. Selecciona Verify SSL solo si usas un certificado SSL firmado por una autoridad certificadora generalmente confiable. Si usas un certificado SSL autofirmado, deja este parámetro de configuración sin marcar.
• Parámetros JDBC adicionales: (Opcional) Parámetros adicionales de cadena de JDBC. Consulta la sección Parámetros de JDBC admitidos en esta página para obtener la lista de parámetros que admite Looker.

Para verificar que la conexión se realice 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, la conexión de la base de datos se agrega a la lista en la página Administrador Conexiones 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 adicionales de JDBC para 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+

• 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 (heredados)

• 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 características

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

Compatibilidad de funciones de ClickHouse 26+

ClickHouse 26+ admite las siguientes funciones a partir de Looker 26.20:

Función	¿Es compatible?
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas persistentes basadas en SQL
Tablas derivadas persistentes nativas
Vistas estables
Eliminació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
Mostrar procesos del Ejecutor de SQL
Describir tabla del Ejecutor de SQL
Mostrar índices del Ejecutor de SQL
Seleccionar 10 del Ejecutor de SQL
Recuento del Ejecutor de SQL
Explicar SQL
Credenciales de OAuth 2.0
Comentarios contextuales
Agrupación de conexiones
Esbozos de HLL
Reconocimiento agregado
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
Medidas entre períodos
Distinción de recuento aproximado
Modelos analíticos en la base de datos
Calendarios personalizados

Compatibilidad de funciones de ClickHouse

ClickHouse admite las siguientes funciones a partir de Looker 26.20:

Función	¿Es compatible?
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas persistentes basadas en SQL
Tablas derivadas persistentes nativas
Vistas estables
Eliminació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
Mostrar procesos del Ejecutor de SQL
Describir tabla del Ejecutor de SQL
Mostrar índices del Ejecutor de SQL
Seleccionar 10 del Ejecutor de SQL
Recuento del Ejecutor de SQL
Explicar SQL
Credenciales de OAuth 2.0
Comentarios contextuales
Agrupación de conexiones
Esbozos de HLL
Reconocimiento agregado
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
Medidas entre períodos
Distinción de recuento aproximado
Modelos analíticos 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.