ClickHouse

Encriptar o tráfego de rede

É uma prática recomendada encriptar o tráfego de rede entre a aplicação Looker e a sua base de dados. Considere uma das opções descritas na página de documentação Ativar o acesso seguro à base de dados.

Para ativar a encriptação SSL do lado do servidor, consulte a documentação das definições globais do servidor do ClickHouse.

Utilizadores e segurança

Primeiro, configure o utilizador do Looker no servidor ClickHouse. Os utilizadores da base de dados ClickHouse não são criados com o comando CREATE USER. Siga a documentação sobre os direitos de acesso do ClickHouse para configurar a secção users no ficheiro users.xml. Segue-se 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 ficheiro, configure o acesso adequado à base de dados.

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

Criar a ligação do Looker à sua base de dados

Na secção Administração do Looker, selecione Ligações e, de seguida, clique em Adicionar ligação.

Preencha os detalhes da ligação. A maioria das definições é comum à maioria dos dialetos de bases de dados. Consulte a página de documentação Associar o Looker à sua base de dados para ver informações. Algumas das definições são descritas a seguir:

  • Dialeto: ClickHouse.
  • Anfitrião: nome do anfitrião acessível.
  • Porta: porta na qual o serviço ClickHouse está acessível através de HTTP(S).
    • Por predefinição, as ligações HTTP usam 8123 e as ligações HTTPS usam 8443.
    • As portas 9000 e 9440 são usadas por predefinição pelo cliente de linha de comandos do ClickHouse, mas o Looker não pode usar estas portas para estabelecer ligação ao ClickHouse.
    • O seu administrador do ClickHouse pode ter escolhido portas alternativas com as definições http_port/https_port na configuração do ClickHouse. Peça ao administrador do ClickHouse as definições adequadas à sua configuração local.
  • Base de dados: nome da base de dados (tem de ser uma das bases de dados permitidas no ficheiro users.xml).
  • Nome de utilizador: nome de utilizador da base de dados.
  • Palavra-passe: palavra-passe da base de dados.
  • Parâmetros JDBC adicionais: (opcional) parâmetros de string JDBC adicionais.
  • Agendamento de manutenção: o ClickHouse não suporta PDTs, pelo que esta definição pode ser ignorada.
  • SSL: selecione esta opção para estabelecer ligação ao ClickHouse através de SSL.
  • Validar SSL: (opcional) selecione esta opção para aplicar a validação rigorosa do nome de anfitrião no servidor ClickHouse. Selecione esta opção apenas se estiver a usar um certificado SSL assinado por uma autoridade de certificação geralmente fidedigna. Se estiver a usar um certificado SSL autoassinado, deixe esta opção desmarcada.

Para verificar se a associação foi bem-sucedida, clique em Testar. Consulte a página de documentação Testar a conetividade da base de dados para ver informações de resolução de problemas.

Para guardar estas definições, clique em Associar.

Suporte de funcionalidades

Para que o Looker suporte algumas funcionalidades, o dialeto da base de dados também tem de as suportar.

O ClickHouse suporta as seguintes funcionalidades a partir do Looker 25.14:

Funcionalidade Compatível?
Nível de apoio técnico
Suportado
Looker (Google Cloud Core)
Sim
Dados agregados simétricos
Não
Tabelas derivadas
Sim
Tabelas derivadas SQL persistentes
Não
Tabelas derivadas nativas persistentes
Não
Vistas estáveis
Não
Interrupção de consultas
Sim
Tabelas dinâmicas baseadas em SQL
Não
Fusos horários
Não
SSL
Sim
Subtotais
Não
Parâmetros JDBC adicionais
Sim
Sensível a maiúsculas e minúsculas
Sim
Tipo de localização
Sim
Tipo de lista
Sim
Percentil
Sim
Percentil distinto
Não
Execução de SQL Mostrar processos
Sim
Execução de SQL Describe Table
Sim
Execução de SQL Mostrar índices
Não
Execução de SQL Select 10
Sim
Contagem da execução de SQL
Sim
SQL Explain
Não
Credenciais do OAuth 2.0
Não
Comentários de contexto
Sim
Agrupamento de ligações
Não
Esboços HLL
Não
Notoriedade agregada
Não
PDTs incrementais
Não
Milissegundos
Não
Microssegundos
Não
Vistas materializadas
Não
Medidas de comparação de períodos
Não
Contagem distinta aproximada
Não