ClickHouse

Como criptografar o tráfego de rede

É recomendável 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 Como 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 ClickHouse. Os usuários do banco de dados 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>

Como 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 Como 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 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 compatíveis com o Looker.

  • Programação de Manutenção: o ClickHouse não oferece suporte a PDTs, 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 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 em Test. Consulte a página de documentação Testar a conectividade do banco de dados para informações sobre solução de problemas.

Para salvar essas configurações, clique em Connect.

Parâmetros JDBC aceitos

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 seu banco de dados para 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.10:

Recurso Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas persistentes com base em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Interrupção de consultas
Tabelas dinâmicas com base 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
PDTs 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