ClickHouse

Como criptografar o tráfego de rede

É recomendável 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 Ativar o acesso seguro ao banco de dados.

Para ativar a criptografia SSL no lado do servidor, consulte a documentação de configurações do servidor global do ClickHouse.

Usuários e segurança

Primeiro, configure seu usuário do Looker no servidor do ClickHouse. Os usuários do banco de dados ClickHouse não são criados com o comando CREATE USER. Siga a documentação sobre 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 neste arquivo, configure o acesso ao banco de dados apropriado.

<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 Como conectar o Looker ao seu banco de dados para mais informações. Confira a seguir algumas das configurações:

  • Dialecto: ClickHouse.
  • Host: nome de 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 de grupos de dados e de TDP: a ClickHouse não oferece suporte a TDPs, portanto, isso pode ser ignorado.
  • SSL: verifique se a conexão com a ClickHouse é feita por SSL.
  • Verificar SSL: (opcional) verifique se a verificação de nome de host estrito é aplicada no servidor ClickHouse. Marque esta 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, não marque essa opção.

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

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

Recurso Compatível?
Nível de suporte
Compatível
Looker (Google Cloud Core)
Sim
Agregações simétricas
Não
Tabelas derivadas
Sim
Tabelas derivadas SQL persistentes
Não
Tabelas derivadas nativas nativas
Não
Visualizações estáveis
Não
Consulta de interrupção
Sim
Pivots baseados 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
SQL Runner Show Processes
Sim
Tabela de descrição do SQL Runner
Sim
Índices de exibição do SQL Runner
Não
SQL Runner Select 10
Sim
Contagem do SQL Runner
Sim
SQL Explain
Não
Credenciais do OAuth
Não
Comentários de contexto
Sim
Pooling de conexão
Não
Esboços HLL
Não
Conscientização agregada
Não
PDTs incrementais
Não
Milissegundos
Não
Microssegundos
Não
Visualizações materializadas
Não
Contagem aproximada de valores distintos
Não