ClickHouse

Conecte o Looker ao 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, oferecendo suporte a decisões diretas orientadas por dados.

Esta página orienta você na configuração da instância do ClickHouse e das configurações de conexão do Looker, incluindo como criptografar o tráfego de rede, definir permissões do usuário e analisar os recursos compatíveis. O Looker oferece suporte ao ClickHouse versão 0.2 ou mais recente.

Criptografar o tráfego de rede

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

Para ativar a criptografia SSL no servidor, consulte a documentação ClickHouse Global Server Settings (em inglês).

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 não são criados com o comando CREATE USER. Siga a documentação de direitos de acesso do ClickHouse para configurar a seção users no arquivo users.xml. Confira um exemplo 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>

Também 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 o banco de dados

Na seção Admin do Looker, selecione Connections e clique em Add Connection.

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 Conectar o Looker ao banco de dados para mais informações. Algumas das configurações são descritas a seguir:

• Dialect: ClickHouse.
• Host: nome do host acessível.
• 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 HTTPS usam 8443.
  • As portas 9000 e 9440 são usadas por padrão pelo cliente de linha de comando do ClickHouse, mas não podem ser usadas pelo Looker para se conectar ao ClickHouse.
  • O administrador do ClickHouse pode ter escolhido portas alternativas com as http_port/https_port configurações na configuração do ClickHouse. Peça ao administrador do ClickHouse as configurações adequadas à sua configuração local.
• Banco de dados: nome do banco de dados (precisa ser um dos bancos de dados permitidos no arquivo users.xml).
• Nome de usuário: nome de usuário do banco de dados.
• Password: senha do banco de dados.

• Parâmetros JDBC adicionais: (opcional) parâmetros de string JDBC adicionais. Consulte a seção Parâmetros JDBC compatíveis nesta página para conferir a lista de parâmetros que o Looker oferece suporte.

• Programação de Manutenção: o ClickHouse não oferece suporte a TDPs, então essa configuração pode ser ignorada.

• SSL: marque para se conectar ao ClickHouse por SSL.

• Verificar SSL: (opcional) marque para aplicar a verificação estrita do nome do host no servidor do ClickHouse. Marque essa opção 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-o desmarcado.

Para verificar se a conexão foi estabelecida, clique no botão Test Connection na seção Status details na parte de baixo da página Connections Settings.

Se o Looker mostrar Can Connect, pressione Connect para criar a conexão.

A conexão do banco de dados será adicionada à lista na página Connections Admin do Looker.

Parâmetros JDBC compatíveis

Para o ClickHouse, o Looker oferece suporte aos seguintes parâmetros JDBC no campo Additional JDBC parameters da conexão. Consulte a documentação do banco de dados para mais informações sobre esses 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

Suporte a recursos

Para que o Looker ofereça suporte a alguns recursos, o dialeto do banco de dados também precisa oferecer suporte a eles.

O ClickHouse oferece suporte aos seguintes recursos a partir do Looker 26.14:

Recurso	Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas SQL persistentes
Tabelas derivadas nativas persistentes
Visualizações estáveis
Eliminação de consultas
Tabelas dinâmicas baseadas em SQL
Fusos horários
SSL
Subtotais
Parâmetros adicionais da JDBC
Diferenciação entre maiúsculas e minúsculas
Tipo de local
Tipo de lista
Percentil
Percentil distinto
Mostrar processos do SQL Runner
Descrever tabela do SQL Runner
Mostrar índices do SQL Runner
Selecionar 10 do SQL Runner
Contagem do SQL Runner
Explicar 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