ClickHouse

Conecte o Looker ao seu banco de dados do ClickHouse para analisar seus dados e criar painéis interativos. Essa conexão ajuda a disponibilizar os dados do ClickHouse para relatórios e análises no Looker, o que ajuda na tomada de decisões diretas com base em dados.

Nesta página, mostramos como definir as configurações de conexão da instância do ClickHouse e do Looker, incluindo como criptografar o tráfego de rede, definir permissões do usuário e analisar os recursos compatíveis. O Looker é compatível com o ClickHouse versão 0.2 ou mais recente e com o ClickHouse 26+ usando drivers JDBC modernizados e suporte a conjuntos simétricos.

Criptografia do tráfego de rede

É uma prática recomendada criptografar o tráfego de rede entre o aplicativo do Looker e seu banco de dados. Considere uma das opções descritas na página de documentação Como ativar o acesso seguro ao banco de dados.

Para ativar a criptografia SSL no lado do servidor, consulte a documentação de configurações globais do servidor do ClickHouse.

Usuários e segurança

Primeiro, configure o usuário do Looker no servidor do ClickHouse. Os usuários do banco de dados do ClickHouse podem ser configurados usando SQL (CREATE USER) ou pela seção users no arquivo users.xml. Siga a documentação de direitos de acesso do ClickHouse para configurar o acesso do usuário. O exemplo básico a seguir 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>

Ainda nesse arquivo, configure o acesso adequado ao banco de dados:

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

Criar a conexão do Looker com seu banco de dados

Na seção Administrador do Looker, selecione Conexões e clique em Adicionar conexão.

Preencher os detalhes de conexão. A maioria das configurações é comum para a maioria dos dialetos de banco de dados. Consulte a página de documentação Como conectar o Looker ao seu banco de dados para mais informações. Algumas das configurações são descritas a seguir:

• Dialeto: selecione ClickHouse 26+ ou ClickHouse.
• Host: nome do host ou endereço IP acessível do servidor do ClickHouse.
• Porta: porta em que o serviço do ClickHouse pode ser acessado por HTTP(S).
  • Por padrão, as conexões HTTP usam 8123, e as conexões HTTPS usam 8443.
  • As portas 9000 e 9440 são usadas por padrão pelo cliente de linha de comando TCP nativo do ClickHouse, mas as portas HTTP(S) precisam ser usadas pelo Looker para se conectar ao ClickHouse.
  • Seu administrador do ClickHouse pode ter escolhido portas alternativas com as configurações http_port ou https_port na configuração do ClickHouse. Peça ao administrador do ClickHouse as configurações adequadas para sua configuração.
• Banco de dados: nome do banco de dados (precisa ser um dos bancos de dados permitidos nas suas permissões do ClickHouse).
• Nome de usuário: nome de usuário do banco de dados.
• Senha: senha do banco de dados.
• SSL: marque para se conectar ao ClickHouse por SSL/TLS.
• Verificar SSL: (opcional) marque para aplicar a verificação estrita de certificado SSL e nome do host no servidor ClickHouse. Selecione Verificar SSL apenas se você estiver usando um certificado SSL assinado por uma autoridade de certificação geralmente confiável. Se você estiver usando um certificado SSL autoassinado, deixe essa configuração desmarcada.
• Parâmetros JDBC adicionais: (opcional) parâmetros adicionais de string JDBC. Consulte a seção Parâmetros JDBC compatíveis nesta página para ver a lista de parâmetros compatíveis com o Looker.

Para verificar se a conexão foi bem-sucedida, clique no botão Testar conexão na seção Detalhes do status na parte de baixo da página Configurações de conexão.

Se o Looker exibir Pode se conectar, pressione Conectar para criar a conexão.

A conexão do banco de dados é adicionada à lista na página Administrador de Conexões do Looker.

Parâmetros JDBC compatíveis

Para o ClickHouse, o Looker é compatível com os seguintes parâmetros JDBC no campo Parâmetros JDBC adicionais para a conexão. Consulte a documentação do seu banco de dados para mais informações sobre esses parâmetros.

Parâmetros do 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
• ssl_mode
• transactionSupport
• use_server_time_zone
• use_time_zone
• wait_for_async_insert
• wrapperObject

Parâmetros do ClickHouse (legado)

• 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

Suporte a recursos

Para que o Looker seja compatível com alguns recursos, o dialeto do banco de dados também precisa ser compatível com eles.

Suporte a recursos do ClickHouse 26+

O ClickHouse 26+ é compatível com os seguintes recursos a partir do Looker 26.20:

Recurso	Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas persistentes em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Encerramento de consultas
Tabelas dinâmicas baseadas em SQL
Fusos horários
SSL
Subtotais
Parâmetros adicionais da JDBC
Diferencia maiúsculas de minúsculas
Tipo de local
Tipo de lista
Percentil
Percentil distinto
Mostrar processos do SQL Runner
Tabela de descrição do SQL Runner
Mostrar índices do SQL Runner
SQL Runner Select 10
Contagem do SQL Runner
Explicação do SQL
Credenciais do OAuth 2.0
Comentários de contexto
Pooling de conexão
Esboços HLL
Reconhecimento agregado
TDPs incrementais
Milissegundos
Microssegundos
Visualizações materializadas
Medidas de comparação de períodos
Contagem aproximada aproximada
Modelos analíticos no banco de dados
Agendas personalizadas

Suporte a recursos do ClickHouse

O ClickHouse é compatível com os seguintes recursos a partir do Looker 26.20:

Recurso	Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas persistentes em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Encerramento de consultas
Tabelas dinâmicas baseadas em SQL
Fusos horários
SSL
Subtotais
Parâmetros adicionais da JDBC
Diferencia maiúsculas de minúsculas
Tipo de local
Tipo de lista
Percentil
Percentil distinto
Mostrar processos do SQL Runner
Tabela de descrição do SQL Runner
Mostrar índices do SQL Runner
SQL Runner Select 10
Contagem do SQL Runner
Explicação do SQL
Credenciais do OAuth 2.0
Comentários de contexto
Pooling de conexão
Esboços HLL
Reconhecimento agregado
TDPs incrementais
Milissegundos
Microssegundos
Visualizações materializadas
Medidas de comparação de períodos
Contagem aproximada aproximada
Modelos analíticos no banco de dados
Agendas personalizadas

Próximas etapas

Depois de concluir a conexão do banco de dados, configure as opções de autenticação.