ClickHouse

Cómo encriptar 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 no se crean con el comando CREATE USER. Sigue la documentación de derechos de acceso de ClickHouse para configurar la sección users en el archivo users.xml. Este es un ejemplo básico:

<!-- 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 adecuado a la base de datos.

<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 información. A continuación, se describen algunos de los parámetros de configuración:

  • Dialect: ClickHouse
  • Host: Nombre de host accesible
  • Puerto: 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 8123 y HTTPS usará 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 http_port/https_port configuración en la configuración de ClickHouse. Pídele al administrador de ClickHouse 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 JDBC adicionales: (Opcional) Parámetros de cadena de JDBC adicionales. Consulta la sección Parámetros de JDBC admitidos en esta página para obtener la lista de parámetros que admite Looker.

  • Maintenance Schedule: 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 la 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 generalmente confiable. Si usas un certificado SSL autofirmado, no lo marques.

Para verificar que la conexión se realice correctamente, haz clic en Probar. Consulta la página de documentación Prueba la conectividad de la base de datos para obtener información sobre la solución de problemas.

Para guardar esta configuración, haz clic en Conectar.

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

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

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

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
Distinción entre mayúsculas y 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