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 e ao 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 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 podem ser configurados usando SQL (CREATE USER) ou pela seção users no arquivo users.xml. Siga a documentação ClickHouse access rights (em inglês) 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 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:

  • 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.
    • O 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 à sua configuração.
  • Banco de dados: nome do banco de dados (precisa ser um dos bancos de dados permitidos nas 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 do certificado SSL e do nome do host no servidor do ClickHouse. Selecione Verificar SSL somente 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 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.

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 Connection 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 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+

  • 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 oferecer suporte a eles.

Suporte a recursos do ClickHouse 26+

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

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 maiúsculas de minúsculas
Tipo de local
Tipo de lista
Percentil
Percentil distinto
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
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
Calendários personalizados

Suporte a recursos do ClickHouse

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

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 maiúsculas de minúsculas
Tipo de local
Tipo de lista
Percentil
Percentil distinto
SQL Runner Show Processes
SQL Runner Describe Table
SQL Runner Show Indexes
SQL Runner Select 10
SQL Runner Count
SQL Explain
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
Calendários personalizados

Próximas etapas

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