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 generar informes y análisis en Looker, lo que respalda las decisiones directas basadas en datos.

En esta página, se explica cómo establecer la configuración de tu instancia de ClickHouse y de la conexión de Looker, lo que incluye cómo encriptar el tráfico de red, definir los permisos de los usuarios y revisar las funciones compatibles. Looker admite la versión 0.2 o posterior de ClickHouse, y ClickHouse 26 o versiones posteriores 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 la encriptación SSL en el servidor, consulta la documentación de 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 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: Es el nombre de host o la dirección IP accesible 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.
  • De forma predeterminada, el cliente de línea de comandos de TCP nativo de ClickHouse usa los puertos 9000 y 9440, pero Looker debe usar los puertos HTTP(S) para conectarse a ClickHouse.
  • Es posible que el administrador de ClickHouse haya elegido puertos alternativos con los parámetros de configuración http_port o https_port en la configuración de ClickHouse. Pídele al administrador de ClickHouse los parámetros de configuración adecuados para tu configuración.
• Base de datos: Es el nombre de la base de datos (debe ser una de las bases de datos permitidas en tus permisos de ClickHouse).
• Nombre de usuario: Es el nombre de usuario de la base de datos.
• Contraseña: Es la 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 de confianza general. Si usas un certificado SSL autofirmado, deja este parámetro de configuración sin marcar.
• Parámetros adicionales de JDBC: (Opcional) Parámetros de cadena de JDBC adicionales. Consulta la sección Parámetros de JDBC admitidos en esta página para ver la lista de parámetros que admite Looker.

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

Si Looker muestra Can Connect, presiona Connect para crear la conexión.

Luego, la conexión de tu base de datos se agrega a la lista en la página Administrador de Conexiones de Looker.

Parámetros de JDBC admitidos

Para 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.

Más de 26 parámetros de ClickHouse

• 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
• ssl_mode
• 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, el dialecto de tu base de datos también debe admitirlas.

Compatibilidad con funciones de ClickHouse 26 y versiones posteriores

ClickHouse 26 y versiones posteriores admiten las siguientes funciones a partir de Looker 26.20:

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

Compatibilidad con 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 de SQL persistentes
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
Describe Table del Ejecutor de SQL
Ejecutor de SQL: Mostrar índices
Seleccionar 10 en el Ejecutor de SQL
Recuento del Ejecutor de SQL
SQL Explain
Credenciales de OAuth 2.0
Comentarios de contexto
Agrupación de conexiones
Esbozos de HLL
Reconocimiento agregado
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
Mediciones 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.