> ## Documentation Index > Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. > O Tableau pode usar databases e tabelas do ClickHouse como fonte de dados. # Como conectar o Tableau ao ClickHouse export const ClickHouseSupportedBadge = () => { return
Suportado pelo ClickHouse
; }; export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return
{alt}
; }; O ClickHouse oferece um conector oficial para o Tableau, disponível no [Tableau Exchange](https://exchange.tableau.com/products/1064). O conector é baseado no avançado [driver JDBC](/docs/pt-BR/integrations/language-clients/java/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: | 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. 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](https://github.com/ClickHouse/clickhouse-java/releases). Esse artefato está disponível a partir da versão `0.9.2`. 4. 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` 5. 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: Tela de conexão do Tableau mostrando o menu de seleção de conectores com a opção ClickHouse by ClickHouse destacada
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](#install-the-connector-manually). 3. Clique em **ClickHouse by ClickHouse** e a seguinte caixa de diálogo será exibida: Caixa de diálogo de instalação do conector no Tableau mostrando os detalhes do conector ClickHouse JDBC e o botão de instalação
4. Clique em **Install and Restart Tableau**. Reinicie o aplicativo. 5. 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: Caixa de diálogo de conexão do ClickHouse no Tableau mostrando campos para servidor, porta, banco de dados, nome de usuário e senha
6. Insira os detalhes da conexão: | Configuração | Valor | | --------------- | ----------------------------------------------------- | | Servidor | **Seu host do ClickHouse (sem prefixos nem sufixos)** | | Porta | **8443** | | Banco de dados | **default** | | Nome de usuário | **default** | | Senha | \*\*\*\*\*\* | 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.) 7. Clique no botão **Sign In** e você deverá ver uma nova pasta de trabalho do Tableau: Nova pasta de trabalho do Tableau mostrando a tela inicial de conexão com opções de seleção de banco de dados
8. Selecione **TPCD** na lista suspensa **Schema** e você deverá ver a lista de tabelas em **TPCD**: Seleção de esquema no Tableau mostrando as tabelas do banco de dados TPCD, incluindo CUSTOMER, LINEITEM, NATION, ORDERS e outras
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: Pasta de trabalho do Tableau com a tabela CUSTOMER arrastada para a área de trabalho, mostrando cabeçalhos de coluna, mas sem dados
2. Clique no botão **Update Now** e 100 linhas de **CUSTOMER** serão carregadas na tabela. 3. Arraste a tabela **ORDERS** para a pasta de trabalho e, em seguida, defina **Custkey** como o campo de relacionamento entre as duas tabelas: Editor de relacionamento do Tableau mostrando a conexão entre as tabelas CUSTOMER e ORDERS usando o campo Custkey
4. 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. Planilha do Tableau mostrando as dimensões e medidas das tabelas do ClickHouse disponíveis para análise
5. 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: Gráfico de linhas do Tableau mostrando a quantidade pedida por ano a partir de dados do ClickHouse
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. 6. 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: Visualização de tabela cruzada do Tableau com trimestres como colunas e modos de envio como linhas
7. 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**: Tabela cruzada do Tableau mostrando a soma do preço total por trimestre e modo de envio
8. Clique em **SUM** e altere a **Measure** para **Average**. No mesmo menu suspenso, selecione **Format** e altere **Numbers** para **Currency (Standard)**: Tabela cruzada do Tableau mostrando o preço médio dos pedidos por trimestre e modo de envio com formatação de moeda
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](https://exchange.tableau.com/products/1064) 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](/docs/pt-BR/integrations/connectors/data-visualization/tableau/tableau-connection-tips) e [Dicas de análise](/docs/pt-BR/integrations/connectors/data-visualization/tableau/tableau-analysis-tips).
## Testes
O conector está sendo testado com o [framework TDVT](https://tableau.github.io/connector-plugin-sdk/docs/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.