Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Looker

Integração com parceiro

O Looker pode se conectar ao ClickHouse Cloud ou a uma implantação on-premise por meio da fonte de dados oficial do ClickHouse.

Reúna seus detalhes de conexão

Para se conectar ao ClickHouse via HTTP(S), você precisa das seguintes informações:

Parâmetro(s) Descrição
HOST and PORT Normalmente, a porta é 8443 ao usar TLS ou 8123 quando não se usa TLS.
DATABASE NAME Por padrão, há um banco de dados chamado default; use o nome do banco de dados ao qual você deseja se conectar.
USERNAME and PASSWORD Por padrão, o nome de usuário é default. Use o nome de usuário apropriado para o seu caso de uso.

Os detalhes do seu serviço do ClickHouse Cloud estão disponíveis no console do ClickHouse Cloud. Selecione um serviço e clique em Connect:

botão Connect do serviço do ClickHouse Cloud

Escolha HTTPS. Os detalhes de conexão são exibidos em um comando curl de exemplo.

detalhes de conexão HTTPS do ClickHouse Cloud

Se você estiver usando ClickHouse autogerenciado, os detalhes de conexão são definidos pelo administrador do seu ClickHouse.

Crie uma fonte de dados do ClickHouse

Navegue até Admin -> Database -> Connections e clique no botão "Add Connection" no canto superior direito.

Adicionando uma nova conexão na interface de gerenciamento de banco de dados do Looker

Escolha um nome para sua fonte de dados e selecione ClickHouse no menu suspenso de dialeto. Insira suas credenciais no formulário.

Informando suas credenciais do ClickHouse no formulário de conexão do Looker

Se você estiver usando ClickHouse Cloud ou se a sua implantação exigir SSL, certifique-se de que o SSL esteja ativado nas configurações adicionais.

Ativando SSL para a conexão com o ClickHouse nas configurações do Looker

Primeiro, teste a conexão e, quando isso for concluído, conecte-se à sua nova fonte de dados do ClickHouse.

Testando e conectando-se à fonte de dados do ClickHouse

Agora você já deve conseguir vincular a fonte de dados do ClickHouse ao seu projeto do Looker.

Limitações conhecidas

  1. Os seguintes tipos de dados são tratados como strings por padrão:
    • Array - a serialização não funciona como esperado devido às limitações do driver JDBC
    • Decimal* - pode ser alterado para número no model
    • LowCardinality(…) - pode ser alterado para um tipo apropriado no model
    • Enum8, Enum16
    • UUID
    • Tuple
    • Map
    • JSON
    • Nested
    • FixedString
    • tipos Geo
      • MultiPolygon
      • Polygon
      • Point
      • Ring
  2. O recurso de agregação simétrica não tem suporte
  3. O full outer join ainda não foi implementado no driver
Navigation