Pular para o conteúdo principal
O ClickHouse oferece um conector oficial para o Tableau, disponível no Tableau Exchange. O conector é baseado no avançado driver JDBC do ClickHouse. Com esse conector, o Tableau integra bancos de dados e tabelas do ClickHouse como fontes de dados. Para ativar essa funcionalidade, siga o guia de configuração abaixo.

​
Configuração necessária antes do uso

  1. Reúna os detalhes da sua conexão Para se conectar ao ClickHouse via HTTP(S), você precisa das seguintes informações: Escolha HTTPS. Os detalhes de conexão são exibidos em um comando curl de exemplo. Se você estiver usando ClickHouse autogerenciado, os detalhes de conexão são definidos pelo administrador do seu ClickHouse.
  2. Baixe e instale o Tableau Desktop.
  3. Siga as instruções de clickhouse-tableau-connector-jdbc para baixar a versão compatível do driver JDBC do ClickHouse.
Certifique-se de baixar o arquivo JAR clickhouse-jdbc-X.X.X-all-dependencies.jar. Esse artefato está disponível a partir da versão 0.9.2.
  1. Salve o driver JDBC na seguinte pasta (de acordo com seu sistema operacional; se a pasta não existir, você pode criá-la):
    • macOS: ~/Library/Tableau/Drivers
    • Windows: C:\Program Files\Tableau\Drivers
  2. Configure uma fonte de dados do ClickHouse no Tableau e comece a criar visualizações de dados!

​
Configure uma fonte de dados do ClickHouse no Tableau

Agora que você instalou e configurou o driver clickhouse-jdbc, vamos ver como definir uma fonte de dados no Tableau que se conecta ao banco de dados TPCD no ClickHouse.
  1. Inicie o Tableau. (Se ele já estiver em execução, reinicie-o.)
  2. No menu à esquerda, clique em More na seção To a Server. Procure por ClickHouse by ClickHouse na lista de conectores disponíveis:

Não está vendo o conector ClickHouse by ClickHouse na lista de conectores? Isso pode estar relacionado a uma versão antiga do Tableau Desktop. Para resolver isso, considere atualizar o Tableau Desktop ou instalar o conector manualmente.
  1. Clique em ClickHouse by ClickHouse e a seguinte caixa de diálogo será exibida:

  1. Clique em Install and Restart Tableau. Reinicie o aplicativo.
  2. Após a reinicialização, o conector aparecerá com o nome completo: ClickHouse JDBC by ClickHouse, Inc.. Ao clicar nele, a seguinte caixa de diálogo será exibida:

  1. Insira os detalhes da conexão:
Ao usar o ClickHouse Cloud, é necessário marcar a caixa de seleção SSL para conexões seguras.

Nosso banco de dados ClickHouse se chama TPCD, mas você deve definir Database como default na caixa de diálogo acima e, em seguida, selecionar TPCD em Schema na próxima etapa. (Isso provavelmente ocorre devido a um bug no conector, então esse comportamento pode mudar, mas, por enquanto, você deve usar default como banco de dados.)
  1. Clique no botão Sign In e você deverá ver uma nova pasta de trabalho do Tableau:

  1. Selecione TPCD na lista suspensa Schema e você deverá ver a lista de tabelas em TPCD:

Agora você está pronto para criar visualizações no Tableau!

​
Criando visualizações no Tableau

Agora que temos uma fonte de dados do ClickHouse configurada no Tableau, vamos visualizar os dados…
  1. Arraste a tabela CUSTOMER para a pasta de trabalho. Observe que as colunas aparecem, mas a tabela de dados está vazia:

  1. Clique no botão Update Now e 100 linhas de CUSTOMER serão carregadas na tabela.
  2. Arraste a tabela ORDERS para a pasta de trabalho e, em seguida, defina Custkey como o campo de relacionamento entre as duas tabelas:

  1. Agora você tem as tabelas ORDERS e LINEITEM associadas entre si na sua fonte de dados, então pode usar esse relacionamento para responder a perguntas sobre os dados. Selecione a aba Sheet 1 na parte inferior da pasta de trabalho.

  1. Suponha que você queira saber quantos itens específicos foram pedidos em cada ano. Arraste OrderDate de ORDERS para a seção Columns (o campo horizontal) e, em seguida, arraste Quantity de LINEITEM para Rows. O Tableau gerará o seguinte gráfico de linhas:

Não é um gráfico de linhas muito empolgante, mas o conjunto de dados foi gerado por um script e criado para testar o desempenho de consultas, então você perceberá que não há muita variação nos pedidos simulados dos dados TCPD.
  1. Suponha que você queira saber o valor médio dos pedidos (em dólares) por trimestre e também por modo de envio (air, mail, ship, truck etc.):
    • Clique na aba New Worksheet para criar uma nova planilha
    • Arraste OrderDate de ORDERS para Columns e altere de Year para Quarter
    • Arraste Shipmode de LINEITEM para Rows
Você deverá ver o seguinte:
  1. Os valores Abc estão apenas preenchendo o espaço até que você arraste uma métrica para a tabela. Arraste Totalprice de * ORDERS* para a tabela. Observe que o cálculo padrão é SUM de Totalprices:

  1. Clique em SUM e altere a Measure para Average. No mesmo menu suspenso, selecione Format e altere Numbers para Currency (Standard):

Muito bem! Você conectou o Tableau ao ClickHouse com sucesso e abriu um mundo inteiro de possibilidades para analisar e visualizar seus dados do ClickHouse.

​
Instale o conector manualmente

Caso você use uma versão antiga do Tableau Desktop que não inclua o conector por padrão, é possível instalá-lo manualmente seguindo estas etapas:
  1. Baixe o arquivo taco mais recente no Tableau Exchange
  2. Coloque o arquivo taco em
    • macOS: ~/Documents/My Tableau Repository/Connectors
    • Windows: C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors
  3. Reinicie o Tableau Desktop. Se a instalação tiver sido concluída com sucesso, você verá o conector na seção New Data Source.

​
Dicas de conexão e análise

Para mais orientações sobre como otimizar sua integração Tableau-ClickHouse, visite Dicas de conexão e Dicas de análise.

​
Testes

O conector está sendo testado com o framework TDVT e atualmente apresenta uma cobertura de 97%.

​
Resumo

Você pode conectar o Tableau ao ClickHouse usando o driver genérico ODBC/JDBC do ClickHouse. No entanto, este conector simplifica o processo de configuração da conexão. Se tiver qualquer problema com o conector, entre em contato pelo GitHub.
Última modificação em 12 de junho de 2026