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 0.2 o versiones posteriores.

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 no se crean con el comando CREATE USER. Sigue la documentación sobre los derechos de acceso de ClickHouse para configurar la sección users en el archivo users.xml. A continuación, se muestra un ejemplo básico:

    
        CHANGEIT
        
        default
        default
    

    
        
        
        web
        default
        
           test
        
        
           test
        
    

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

    database_1
    database_2
    database_3

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:

• Dialecto: ClickHouse.
• Host: Es el nombre de host accesible.
• 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 usarán el puerto 8123 y las conexiones HTTPS usarán el puerto 8443.
  • Los puertos 9000 y 9440 se usan de forma predeterminada en el cliente de línea de comandos de ClickHouse, pero Looker no puede usar estos puertos para conectarse a ClickHouse.
  • Es posible que el administrador de ClickHouse haya elegido puertos alternativos con la configuración http_port/https_port en la configuración de ClickHouse. Pídele al administrador de ClickHouse que te proporcione la configuración adecuada para tu configuración local.
• Base de datos: Nombre de la base de datos (debe ser una de las bases de datos permitidas en el archivo users.xml).
• Nombre de usuario: Nombre de usuario de la base de datos.
• Contraseña: Contraseña de la base de datos.

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

• Programa de mantenimiento: ClickHouse no admite PDT, por lo que se puede ignorar este parámetro de configuración.

• SSL: Marca esta opción para conectarte a ClickHouse a través de SSL.

• Verificar SSL: (Opcional) Marca esta opción para aplicar una verificación estricta del nombre de host en el servidor de ClickHouse. Marca esta opción solo si usas un certificado SSL firmado por una autoridad certificadora de confianza general. Si usas un certificado SSL autofirmado, no marques esta opción.

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

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

Luego, la conexión de la base de datos se agrega 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.

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

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