ClickHouse

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 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 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: 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 as 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 configurações http_port/https_port na configuração do ClickHouse. Pergunte ao administrador do ClickHouse sobre 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.
  • Senha: senha do banco de dados.
  • Parâmetros JDBC adicionais: (opcional) outros parâmetros de string JDBC.
  • Programação de manutenção: o ClickHouse não é compatível com PDTs, então essa configuração pode ser ignorada.
  • SSL: marque para se conectar ao ClickHouse por SSL.
  • Verificar SSL: (opcional) marque para aplicar uma verificação rigorosa do nome do host no servidor ClickHouse. Marque essa opção 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 a caixa desmarcada.

Para verificar se a conexão foi bem-sucedida, clique em Testar. 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 Conectar.

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.

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

Recurso Compatível?
Looker (Google Cloud Core)
Agregações simétricas
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 do 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
SQL Runner Select 10
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