ClickHouse

O Looker oferece suporte à ClickHouse versão 0.2 e mais recente.

Como criptografar o tráfego de rede

O Looker recomenda 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 a banco de dados.

Para ativar a criptografia SSL no lado do servidor, consulte a documentação da 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 tradicional. Siga o documento Direitos de acesso da ClickHouse para configurar a seção users no arquivo users.xml. Veja 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 adequado ao banco de dados:

<allow_databases>
    <database>database_1</database>
    <database>database_2</database>
    <database>database_3</database>
</allow_databases>

Como adicionar a conexão

Na seção Administrador do Looker, selecione Conexões e, em seguida, clique em Adicionar conexão.

Preencha os detalhes de conexão. Para mais informações, consulte a página de documentação Como conectar o Looker ao seu banco de dados:

  • 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 usarão 8123 e HTTPS usará 8443.
    • As portas 9000 e 9440 são usadas por padrão pelo cliente de linha de comando ClickHouse, mas essas portas não podem ser usadas pelo Looker para se conectarem à ClickHouse.
    • Seu administrador da ClickHouse pode ter escolhido portas alternativas com as configurações do http_port/https_port. Peça ao administrador da ClickHouse as configurações apropriadas à 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 adicionais: (opcional) outros parâmetros de string JDBC.
  • Programação de manutenção de PDT e de grupo de dados: o ClickHouse não é compatível com PDTs, então isso pode ser ignorado.
  • SSL: marque para se conectar a ClickHouse via SSL.
  • Verificar SSL: (opcional) selecione para aplicar uma verificação rígida de nome do host no servidor ClickHouse. Só confirme isso se você estiver usando um certificado SSL assinado por uma autoridade de certificação geralmente confiável. Se você usa um certificado SSL autoassinado, deixe-o desmarcada.

Suporte a recursos

Para que o Looker ofereça suporte a alguns recursos, seu dialeto do banco de dados também precisa aceitá-los.

Na versão mais recente do Looker, o ClickHouse é compatível com os seguintes recursos do Looker:

Próximas etapas

Depois de concluir a configuração do banco de dados, conecte-se ao banco de dados no Looker.