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. Peça ao administrador do ClickHouse as configurações adequadas à sua configuração local.
• Banco de dados: nome do banco de dados (deve 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 a verificação estrita 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 25.10: