ClickHouse

Conecte o Looker ao seu banco de dados ClickHouse para analisar os dados e criar painéis interativos. Essa conexão ajuda a disponibilizar seus dados do ClickHouse para relatórios e análises no Looker, permitindo decisões diretas com base em 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 de 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 ou mais recente usando drivers JDBC modernizados e suporte a conjuntos simétricos.

Criptografar o tráfego de rede

É uma prática recomendada criptografar o tráfego de rede entre o aplicativo 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 ClickHouse.

Usuários e segurança

Primeiro, configure seu usuário do Looker no servidor ClickHouse. Os usuários do banco de dados 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>

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 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 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 ClickHouse.
• Porta: porta em que o serviço ClickHouse pode ser acessado por HTTP(S).
  • Por padrão, as conexões HTTP usam 8123, e as 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.
  • O administrador do ClickHouse pode ter escolhido portas alternativas com as configurações http_port ou https_port na configuração do ClickHouse. Pergunte ao administrador do ClickHouse sobre as configurações adequadas à 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 de host no servidor ClickHouse. Selecione Verificar SSL somente se você estiver usando um certificado SSL assinado por uma autoridade certificadora geralmente confiável. Se você estiver usando um certificado SSL autoassinado, deixe essa configuração desmarcada.
• Parâmetros JDBC adicionais: (opcional) outros parâmetros 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 estabelecida, 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 mostrar Pode se conectar, pressione Conectar para criar a conexão.

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

Parâmetros JDBC aceitos

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

Parâmetros do ClickHouse 26 ou mais recentes

• 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
• sslmode
• 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 ofereça suporte a alguns recursos, o dialeto do banco de dados também precisa ser compatível com eles.

Suporte a recursos do ClickHouse 26 e versões mais recentes

O ClickHouse 26+ oferece suporte aos seguintes recursos a partir do Looker 26.18:

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
Interrupção 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
Descrever tabela do SQL Runner
Mostrar índices do SQL Runner
Selecionar 10 no SQL Runner
Contagem do SQL Runner
Explicação do SQL
Credenciais do OAuth 2.0
Comentários contextuais
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.18:

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
Interrupção 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
Descrever tabela do SQL Runner
Mostrar índices do SQL Runner
Selecionar 10 no SQL Runner
Contagem do SQL Runner
Explicação do SQL
Credenciais do OAuth 2.0
Comentários contextuais
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.