Conectores criados com o SDK do Web Data Connector 3.0
O Web Data Connector 3.0 é a versão mais recente do conector de dados da Web, a solução do Tableau para conexão com dados em aplicativos e serviços da Web expostos por meio de APIs em vez de drivers ODBC/JDBC.
O SDK do Web Data Connector 3.0 fornece as ferramentas necessárias para criar seu próprio conector personalizado para dados da Web. Além disso, os conectores criados por parceiros podem ser usados no Tableau Exchange.
Observação: o Web Data Connector 3.0 fazia parte da versão 2022.3 do Tableau.
Sobre o Web Data Connector 3.0
Diferentemente das iterações anteriores do conector de dados da Web e análogo ao SDK do Tableau Connector, o Web Data Connector 3.0 permite criar um conector personalizado para dados da Web e empacotar o conector como um arquivo .taco. Os conectores WDC 3.0 podem ser usados como qualquer conector baseado em driver criado usando o Tableau Connector SDK e não exigem que você hospede o conector em seu próprio servidor web.
Assim como outros conectores .taco, os conectores WDC 3.0 são arquivos .jar empacotados e assinados contendo um conjunto de arquivos XML e Javascript/TypeScript. Esses arquivos definem a aparência e o comportamento do conector, incluindo:
- Uma IU de conector baseada na Web
- Chamadas de API para recuperar dados do seu aplicativo ou endpoint de serviço
- Instruções para mapear os dados recuperados em extrações do Tableau
Observação: o Web Data Connector 3.0 permanece somente para extração, mas permite que você visualize seus dados e publique sua análise como qualquer outra fonte de dados.
Importante: há um problema conhecido com conectores baseados em WDC 3.0 no Tableau Server. Consulte Problemas conhecidos (Tableau Server somente) abaixo.
Crie seu próprio conector
Para começar a criar seu próprio conector personalizado, consulte a documentação oficial do Web Data Connector 3.0 .
Use um conector criado com o SDK do Web Data Connector 3.0
Depois de criar um conector com o SDK do Web Data Connector 3.0, siga estas etapas para usá-lo com o Tableau:
- Baixe o arquivo do conector, [connector name].taco.
- Coloque o arquivo .taco no seguinte diretório (localização padrão):
- Para 2021.2 e mais recente:
Para o Tableau Desktop Para o Tableau Prep Builder Para o Tableau Server - Windows - C:\Users\[Windows User]\Documents\Meu repositório do Tableau\Connectors
- macOS - /Users/[user]/Documents/Meu repositório do Tableau/Connectors
- Windows: C:\Users\[Windows User]\Documents\Meu repositório do Tableau Prep\Connectors
- MacOS: /Users//Documents/Meu repositório do Tableau Prep/Connectors
Windows: C:\Program Files\Tableau\Connectors
Linux: /opt/tableau/connectors
- Para 2021.1 e anteriores:
Para o Tableau Desktop Para o Tableau Prep Builder Para Tableau Server, Tableau Prep Conductor, Criação de fluxo do Tableau Prep - Windows - C:\Users\[Windows User]\Documents\Meu repositório do Tableau\Connectors
- macOS - /Users/[user]/Documents/Meu repositório do Tableau/Connectors
- Windows: C:\Users\[Windows User]\Documents\Meu repositório do Tableau Prep\Connectors
- MacOS: /Users//Documents/Meu repositório do Tableau Prep/Connectors
- Tableau Server: [Tableau_Server_Installation_Directory]/data/tabsvc/vizqlserver/Connectors
Para habilitar seu conector para preparação, você também precisa adicionar o taco aos seguintes locais:
- Tableau Prep Conductor: [Tableau_Server_Installation_Directory]/data/tabsvc/flowprocessor/Connectors
- Criação de fluxo do Tableau Prep: [Tableau_Server_Installation_Directory]/data/tabsvc/flowqueryservice/Connectors
- Para 2021.2 e mais recente:
Observação: após instalar o conector, ele aparecerá na lista de conectores no Tableau.
Ao encontrar um problema com a biblioteca do WDC, o simulador ou qualquer uma das amostras de desenvolvedor, envie uma questão no Github(O link abre em nova janela).
Conectar o Tableau aos dados
- Inicie o Tableau e, em Conectar, selecione o nome do conector que você acabou de instalar. Para obter uma lista de conectores de dados completa, selecione Mais, em Para um servidor.
- Digite as informações solicitadas e depois selecione Fazer logon.
- Aguarde enquanto o conector recupera seus dados no Tableau.
- Selecione a guia de planilha para iniciar a sua análise.
Ordem de carregamento para conectores
Se um conector tiver a mesma classe de um conector já registrado, o novo conector será rejeitado. Os conectores carregados primeiro têm precedência quando dois conectores compartilham nomes de classe.
O Tableau carrega conectores por diretório na seguinte ordem:
- Conectores Tableau inseridos
- Conectores localizados em
C:\Program Files\Tableau\Connectors(Windows) ou/opt/tableau/connectors(Linux) - Conectores localizados em
My Tableau Repository/Connectors - (Opcional) Conectores no caminho dev especificado por
-DConnectPluginsPath
Problemas conhecidos (Tableau Server somente)
Ao tentar se conectar a um conector baseado em WDC 3.0 no Tableau Server, os usuários podem ver a mensagem de erro "O Tableau Server (versão <número da versão>) encontrou um erro ao trabalhar com esta planilha".
Esse erro ocorre porque o conector baseado no Conector de dados da Web 3.0 com o qual a pasta de trabalho foi criada não é compatível com um Tableau Server de vários nós. Não há solução alternativa ou resolução neste momento. Para obter mais informações, consulte o artigo da base de conhecimento Ao criar um site usando conectores baseados em WDC 3.0, você recebe HTTP 503 junto com o erro "encontrou um erro"(O link abre em nova janela).
Consulte também
- Configurar fontes de dados – Adicione mais dados a esta fonte de dados ou prepare os dados antes de analisá-los.
- Criar gráficos e analisar dados – Inicie a análise de dados.
- Tableau Connector SDK(O link abre em nova janela) - Encontre informações e ferramentas para construir e testar seu próprio conector personalizado.
- Usar o conector criado por parceiro no Tableau Exchange - Encontre e instale um conector do Tableau Exchange.