Esta é a documentação do Looker. Para conferir a documentação do Looker Studio, acesse https://support.google.com/looker-studio.

ClickHouse

O Looker é compatível com a versão 0.2 ou mais recente do ClickHouse.

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 Como ativar o acesso seguro ao 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 o usuário do Looker no servidor da ClickHouse. Os usuários do banco de dados da ClickHouse não são criados com o comando CREATE USER tradicional. Siga o documento Direitos de acesso à casa do clique 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 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. Grande parte 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 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 o HTTPS usa 8443.
- As portas 9000 e 9440 são usadas por padrão pelo cliente da linha de comando ClickHouse, mas não podem ser usadas pelo Looker para se conectar à ClickHouse.
- Talvez o administrador do ClickHouse tenha escolhido portas alternativas usando as definições do http_port/https_port. Peça ao administrador do ClickHouse as definições adequadas 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.
Parâmetros JDBC adicionais (opcional): parâmetros adicionais de string JDBC.
Programação de manutenção de TDP e grupo de dados: o ClickHouse não oferece suporte a TDPs. Portanto, pode ser ignorado.
SSL: marque para se conectar ao ClickHouse via SSL.
Verificar SSL: (opcional) marque para aplicar a verificação estrita do nome do host no servidor ClickHouse. Marque essa opção apenas se você estiver usando um certificado SSL assinado por uma autoridade de certificação confiável. Se você estiver usando um certificado SSL autoassinado, deixe-o desmarcada.

Para verificar se a conexão foi estabelecida, 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 as configurações, clique em Conectar.

Suporte a recursos

Para que o Looker ofereça suporte a alguns recursos, o dialeto do seu banco de dados também precisa fazer isso.

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

Recurso	Compatível?
Nível do suporte	Compatível
Looker (Google Cloud Core)	Sim
Agregados simétricos	Não
Tabelas derivadas	Sim
Tabelas derivadas do SQL persistentes	Não
Tabelas derivadas nativas nativas	Não
Visualizações estáveis	Não
Encerramento de consultas	Sim
Tabelas 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 SQL Runner	Sim
Índices de exibição do SQL Runner	Não
Seleção do SQL Runner 10	Sim
Contagem de executores SQL	Sim
Explicação do SQL	Não
Credenciais OAuth	Não
Comentários de contexto	Sim
Pooling de conexão	Não
Esboços do HLL	Não
Reconhecimento agregado	Não
TDPs incrementais	Não
Milissegundos	Não
Microssegundos	Não
Visualizações materializadas	Não
Número aproximado de contas distintas	Não