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
8123y las conexiones HTTPS usan8443. - Los puertos
9000y9440se 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_portohttps_porten la configuración de ClickHouse. Pídele al administrador de ClickHouse la configuración adecuada para tu configuración.
- De forma predeterminada, las conexiones HTTP usan
- 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_insertautoCommitcompresscompress_algorithmcompress_levelconnect_timeoutconnection_timeoutcontinueBatchOnErrorcreateDatabaseIfNotExistcustom_settingsdatabasedatabaseTermexternalDatabasefetchSizeformatjdbcCompliantkeep_alive_timeoutmax_buffer_sizemax_execution_timemax_result_bytesmax_result_rowsmax_threadsnamedParameterquery_timeoutreceive_timeoutresult_overflow_moderetrysession_checksession_idsession_timeoutsession_timezonesocket_timeoutsslsslmodetransactionSupportuse_server_time_zoneuse_time_zonewait_for_async_insertwrapperObject
Parámetros de ClickHouse (heredado)
beta.row_binary_for_simple_insertcompressconnection_timeoutcontinueBatchOnErrorcreateDatabaseIfNotExistcustom_http_headerscustom_http_paramsdefault_query_settingsdisable_frameworks_detectionjdbc_ignore_unsupported_valuesjdbc_resultset_auto_closejdbc_sql_parserjdbc_use_max_result_rowsjdbcCompliancemax_execution_timepasswordsession_timezonesocket_timeouttypeMappingsuse_server_time_zoneuse_time_zoneuserwrapperObject
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.