ClickHouse

Como 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 servidor, consulte a documentação sobre configurações globais do servidor do ClickHouse (em inglês).

Usuários e segurança

Primeiro, configure o usuário do Looker no servidor da 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 da ClickHouse para configurar a seção users no arquivo users.xml. Este é 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>

Ainda nesse arquivo, configure o acesso apropriado 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 Administrador do Looker, selecione Conexões e clique em Adicionar conexão.

Preencher os detalhes de conexão. A maioria das configurações é comum à 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:

  • Dialeto: ClickHouse.
  • Host: nome do host acessível.
  • Porta: a porta em que o serviço ClickHouse pode ser acessado por HTTP(S).
    • Por padrão, as conexões HTTP usam 8123, e o HTTPS usa 8443.
    • As portas 9000 e 9440 são usadas por padrão pelo cliente de linha de comando da ClickHouse, mas o Looker não pode usar essas portas para se conectar ao ClickHouse.
    • O administrador da ClickHouse pode ter escolhido portas alternativas com as configurações de http_port/https_port na configuração da ClickHouse. Peça ao administrador da ClickHouse sobre as configurações apropriadas para 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.
  • Outros parâmetros do JDBC (opcional): outros parâmetros de string do JDBC.
  • Programação de manutenção de PDT e grupo de dados: o ClickHouse não é compatível com PDTs, então essa informação pode ser ignorada.
  • SSL: verifique para se conectar à ClickHouse sobre SSL.
  • Verificar SSL: (opcional) marque para aplicar a verificação rígida 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 a caixa desmarcada.

Para verificar se a conexão foi bem-sucedida, clique em Testar. Consulte a página de documentação Como 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.

A ClickHouse oferece suporte aos seguintes recursos a partir do Looker 24.10:

Recurso Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
Sim
Agregações simétricas
Não
Tabelas derivadas
Sim
Tabelas derivadas de SQL persistentes
Não
Tabelas derivadas nativas nativas
Não
Visualizações estáveis
Não
Eliminação de consultas
Sim
Dinâmicas baseadas em SQL
Não
Fusos horários
Não
SSL
Sim
Subtotais
Não
Parâmetros adicionais do JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
Sim
Tipo de lista
Sim
Percentil
Sim
Percentil distinto
Não
Processos de exibição do SQL Runner
Sim
Tabela de descrição do executor do SQL
Sim
Mostrar índices do SQL Runner
Não
Seleção do SQL Runner 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
Não
Credenciais OAuth
Não
Comentários de contexto
Sim
Pool de conexão
Não
Esboços do HLL
Não
Agregar reconhecimento
Não
TDPs incrementais
Não
Milissegundos
Não
Microssegundos
Não
Visualizações materializadas
Não
Contagem aproximada diferente
Não