Ajuda do Tableau Server no Windows

Os conectores de dados da Web (WDCs) são páginas da Web para conectar-se a dados acessíveis por HTTP para fontes de dados que ainda não têm um conector no Tableau. Os WDCs permitem a conexão dos usuários a quase todos os dados acessíveis pela Web e a criação de extrações para as pastas de trabalho. As fontes de dados para o WDC podem incluir serviços da Web internos, dados JSON, REST APIs e outras fontes disponíveis por HTTP ou HTTPS. Os usuários podem criar seus próprios WDC ou usar os conectores criados por outros.

Para obter informações sobre como usar o WDC no Tableau Desktop, consulte Conector de dados da Web(O link abre em nova janela) na documentação do Tableau Desktop.

Para obter informações sobre como criar um WDC, consulte a documentação do conector de dados da Web no Github.

Antes de executar os conectores no Tableau Server

Como medida de segurança, o Tableau Server não executará os WDCs a menos que você aprove o conector, conforme explicado neste tópico.

Observação:é preciso ser um administrador do sistema para aprovar os WDCs para uso no Tableau Server.

Os WDCs precisam da sua aprovação porque contêm código executável e normalmente fazem solicitações a sites de terceiros. Antes de um usuário poder usar o WDC com o Tableau Server, será necessário adicionar o domínio e a porta usados pelo conector a uma lista segura, bem como incluir os domínios que um conector pode enviar e receber solicitações de uma lista segura secundária (lista autorizada secundária). Antes de fazer isso, recomendamos que avalie e teste o conector, para que saiba o que ele faz e a quais sites se conectam. Para obter mais informações, consulte Teste e verificação dos conectores de dados da Web.

Ao adicionar um conector a listas seguras, você configura o Tableau Server para permitir conexões a uma URL em especial, onde o conector está hospedado e de uma URL que pode ser consultada pelo conector. Este é a única maneira de permitir que o Tableau Server execute os WDCs. Os conectores podem ser hospedados em um servidor dentro do firewall da sua empresa ou em um domínio externo. A importação de WDCs não é suportada pelo Tableau Server.

Gerenciar conectores em uma lista segura

Para adicionar um WDC à lista segura, use o comando tsm data-access web-data-connectors add. Este comando e os comandos relacionados descritos abaixo permitem que as seguintes tarefas sejam executadas:

• Adicionar WDCs à lista segura e à lista segura secundária.

• Permitir ou proíbir todos os WDCs ou atualizações do WDC.

• Remover um ou mais conectores da lista de segurança.

• Listar todos os WDCs na lista de segura e lista segura secundária.

A atualização de listas seguras do WDC requer uma reinicialização do servidor

Após executar qualquer comando que faça alterações nos WDCs, é necessário aplicar as alterações pendentes usando o comando tsm pending-changes apply.

Se as alterações pendentes exigirem uma reinicialização do servidor, o comando pending-changes apply exibirá um prompt para que você saiba que ocorrerá uma reinicialização. Esse prompt será exibido mesmo que o servidor esteja parado, porém, nesse caso, não há reinicialização. Cancele o prompt com a opção --ignore-prompt, mas isso não altera o comportamento de reinicialização. Se as alterações não exigirem uma reinicialização, elas serão aplicadas sem um prompt. Para obter mais informações, consulte tsm pending-changes apply.

Adicionar conectores à lista segura e à lista segura secundária

Para adicionar um conector à lista segura e à lista segura secundária, use o comando tsm data-access web-data-connectors add, fornecendo o nome, a URL da lista segura e as URLs da lista segura secundária. Você também pode gerenciar os WDCs usando Entidade de web-data-connector-settings. Após executar o comando, é necessário aplicar as alterações pendentes usando o comando tsm pending-changes apply. Um prompt avisa que o comando reiniciará o Tableau Server. Se o Tableau Server estiver em execução no momento, ele será reiniciado; caso contrário, ele ficará no estado interrompido sem reinicialização.

tsm data-access web-data-connectors add --name "USGS Earthquakes" --url https://tableau.github.io:443/webdataconnector/Examples/html/earthquakeUSGS.html --secondary https://tableau.github.io/.*,https://earthquake.usgs.gov/.*,https://maxcdn.bootstrapcdn.com/.*,https://ajax.googleapis.com/.*,https://connectors.tableau.com/.*

Observações sobre formatação:

• Certifique-se de usar aspas retas ("e '), não aspas "inteligentes", em torno do nome do WDC. Use aspas duplas (") se o nome contiver um espaço.
• Para muitos WDCs, a porta especificada para a opção --url é 443 ou 80, mas é possível verificar o valor para o seu conector ao analisar os detalhes da fonte de dados no Tableau Server. Você deverá especificar o número da porta como parte da URL, se o WDC estiver utilizando SSL (HTTPS). Por exemplo, para usar a porta padrão para HTTPS, a URL pode parecer com o seguinte: https://example.com:443/WDC/.
• Uma URL ou uma lista de URLs delimitada por vírgulas deve ser especificado para a opção --secondary, que indica os domínios que fornecem as bibliotecas e fontes que o WDC precisa acessar. Essa opção não pode ser omitida ou deixada em branco, a menos que o WDC não use nenhum domínio secundário. Se você não sabe se o WDC usa domínios secundários ou quais são os domínios secundários, talvez seja necessário entrar em contato com o desenvolvedor do WDC. Você também pode optar por usar URLs curinga http://.* e https://.* para permitir todos os domínios. No entanto, recomendamos fortemente que você use URLs mais específicas para aumentar a segurança.
• Para adicionar um domínio inteiro à lista segura secundária, termine a URL do domínio com uma expressão curinga. Use .* como o curinga para indicar o domínio inteiro, como no exemplo a seguir https://example.com/.*.

Permitir ou proibir todos os WDCs ou atualizações de WDCs

Para permitir ou proibir os WDCs ou as atualizações de extração de WDCs, use o comando tsm data-access web-data-connectors allow com as opções -t ou -r. Por padrão, atualizações de extrações WDCs e WDC são permitidas. Se você alterar esta configuração, é necessário executar o comando tsm pending-changes apply. Para obter mais informações sobre o comando e as opções globais, consulte tsm data-access web-data-connectors allow.

Remover um ou mais WDCs da lista segura

Para remover um ou mais WDCs da lista segura, use o comando tsm data-access web-data-connectors delete: Se você alterar esta configuração, é necessário executar o comando tsm pending-changes apply. Para obter mais informações, consulte tsm data-access web-data-connectors delete.

Listar todos os WDCs na lista segura

Para listar todos os WDCs na lista segura, use o comando tsm data-access web-data-connectors list: Para obter mais informações, consulte tsm data-access web-data-connectors list.

Atualização da extração para um conector

Quando um usuário cria uma pasta de trabalho que utiliza um WDC, o Tableau Server cria uma extração de dados retornados pelo conector. Se o usuário, em seguida, publicar a pasta de trabalho, o processo de publicação envia a pasta de trabalho e a extração dos dados para o servidor.

O Tableau pode atualizar uma extração que foi criada por um WDC, assim como pode atualizar qualquer extração. Se o conector exigir credenciais para fazer logon na fonte de dados baseada na Web, será necessário garantir que as credenciais sejam inseridas com a fonte de dados e que o WDC esteja na lista segura do servidor. O Tableau Server não pode atualizar a extração se o conector precisar de credenciais e elas não estão inseridas na fonte de dados. Isto é porque a atualização pode ocorrer conforme uma agenda ou em algum contexto em segundo plano, e o servidor pode não solicitar as credenciais.

Atualmente, não há como autenticar novamente uma fonte de dados a partir do Tableau Server diretamente. Se a fonte de dados tiver credenciais que expiram, ou foi publicada sem inserir as credenciais, a pasta de trabalho e a extração de dados precisam ser publicadas novamente com as novas credenciais inseridas.

Se o processo em segundo plano que executa a operação de atualização falhar, ele cria um alerta e uma entrada de registro que indica esse problema. Os usuários poderão ver que a data e hora da extração não é alterada.

Para desabilitar a atualização para todos os WDCs, use o comando tsm data-access web-data-connectors allow -r false.

Solução de problemas

Se o servidor tiver problemas com a adição de conectores a uma lista segura, examine os arquivos de registro. Não se esqueça de verificar os arquivos de registro no nó do servidor inicial e nos outros nós que executam o processo de gateway. Para obter mais informações sobre os arquivos de registro, Locais de arquivo de registro e registros do Tableau Server.

Se o problema for que o Tableau Server não consegue atualizar uma extração criada por um WDC, verifique se a configuração webdataconnector.refresh.enabled foi definida como true. Se estiver configurado para false, execute o seguinte comando para permitir atualizações de extração para todos os WDCs no servidor:

tsm data-access web-data-connectors allow -r true

Observação: a lista segura é a única maneira de permitir que o Tableau Server execute conectores de dados da Web. A importação dos conectores de dados da Web foi descontinuada a partir da versão 10.5.