Solucionar problemas no Tableau Prep Builder

Este artigo lista os problemas que pode encontrar ao usar o Tableau Prep Builder, além de sugestões de como solucioná-los.

Erros comuns ao usar a linha de comando para executar fluxos

É possível executar fluxos a partir da linha de comando para atualizar os arquivos de saída programaticamente em vez de abrir o Tableau Prep Builder para executar cada fluxo manualmente. Embora este processo ajude a criar eficiência no processo do fluxo, se a sintaxe estiver incorreta ou você não tiver as credenciais das conexões ou das localizações de saída, você encontrará erros ao executar este processo.

A seguinte tabela descreve os erros comuns e como resolvê-los. Para obter informações sobre como executar fluxos a partir da linha de comando, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando(Link opens in a new window).

Erro Causa Como corrigir
"Missing arguments” ("Faltam argumentos”) Um dos argumentos de linha de comando exigidos está faltando. Use o comando “tableau-prep-cli -help” para visualizar uma lista de argumentos para a linha de comando.
"Unable to read the connections file.” ("Não foi possível ler o arquivo de conexões”) Há erros na sintaxe ou no formato do arquivo credentials.json nas conexões de entrada. Verifique a sintaxe das conexões de entrada no arquivo .json. Para obter mais informações e exemplos, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando(Link opens in a new window).

"There are errors in the flow. Unable to run the flow.

Check that the credentials .json file includes all required credentials. Open the flow in Tableau Prep Builder to view error details.”

Faltam credenciais no arquivo credentials.json para as conexões de entrada ou o fluxo contém erros.

Verifique se o arquivo .json tem as credenciais para todas as conexões e abra o arquivo do fluxo no Tableau Prep Builder para visualizar se há algum erro no fluxo.

Se o fluxo tem erros, será necessário corrigi-los e publicar o fluxo novamente no Tableau Server, depois tente executar o processo novamente.

"Could not find match for <hostname of inputConnections >” ("Não foi possível uma correspondência para <hostname of inputConnections>”) Falta uma entrada para o nome de host (nome do servidor) no arquivo credentials.json.

Garanta que o arquivo credentials.json inclua as credenciais corretas para o nome de host (nome do servidor).

Para obter mais informações e exemplos, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando(Link opens in a new window)

"We don't have credentials of all connections in tfl/tflx file. The following connection(s) were not found: <hostname of inputConnections>” ("Não existem credenciais para todas as conexões no arquivo tfl/tflx. As seguintes conexões não foram encontradas: <hostname of inputConnections>”) Faltam credenciais no arquivo credentials.json ou elas estão incorretas para o nome de host (nome do servidor) mostrado na mensagem de erro.

Garanta que o arquivo credentials.json inclua as credenciais corretas para o nome de host (nome do servidor) listado na mensagem de erro.

Para obter mais informações e exemplos, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando.

"Error signing in server <serverUrl> as a user <userName>. Please check the credentials.” ("Erro ao fazer logon no servidor <serverUrl> como o usuário <userName>. Verifique as credenciais.”) O arquivo credentials.json tem as credenciais incorretas para o Tableau Server.

Garanta que o arquivo credentials.json inclua todas as credenciais e elementos corretos para a conexão de saída.

Para obter mais informações e exemplos, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando

"Could not sign in successfully as <userName> to server <serverUrl>(<contentUrl>)” ("Não foi possível fazer logon com sucesso como <userName> no servidor <serverUrl>(<contentUrl>)”) O arquivo credentials.json tem as credenciais incorretas para o Tableau Server.

Garanta que o arquivo credentials.json inclua todas as credenciais e elementos corretos para a conexão de saída.

Para obter mais informações e exemplos, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando

"We don't have credentials for Tableau Server to publish extract for one or more output nodes in tfl/tflx file.” ("Não temos as credenciais do Tableau Server para publicar a extração de um ou mais nós de saída no arquivo tfl/tflx.”) O arquivo credentials.json não foi passado como argumento na linha de comando ou faltam as credenciais da conexão de saída.

Garanta que o caminho para o arquivo credentials.json esteja incluído na linha de comando e verifique se ele inclui todas as credenciais e elementos corretos para a conexão de saída.

Para obter mais informações e exemplos, consulte Atualizar arquivos de saída de fluxo a partir da linha de comando

"Loom rest api server not started” ("O próximo servidor da API REST não iniciou.”) A configuração da instalação ou do ambiente está incorreta.

Garanta que o Tableau Prep Builder esteja instalado corretamente e que você esteja executando o comando como Administrador.

Para obter informações sobre como instalar o Tableau Prep Builder, consulte Instalar o Tableau Desktop ou o Tableau Prep Builder usando a interface do usuário(Link opens in a new window).

"Error. Flow file does not exist.” ("Erro. O arquivo de fluxo não existe.”) O caminho para o arquivo de fluxo está incorreto. Garanta que o caminho correto para o arquivo de fluxo esteja incluído na linha de comando.
"Error. Connections file does not exist.” ("Erro. O arquivo de conexões não existe.”) O caminho para o arquivo credentials.json está incorreto. Verifique se o caminho correto para o arquivo credentials.json está incluído na linha de comando.
“Não foi possível encontrar correspondência para <mapr01:5181>,<mapr02:5181>,<mapr03:5181>” Você deve especificar uma ID de porta específica ao conectar a Apache Drill usando ZooKeeper. Inclua um arquivo credentials.json na linha de comando que especifique a "porta": 31010 para as credenciais de entrada.

Erro: "These features were found that prevent this version of the application from using this file"

Se abrir um fluxo criado na versão 2018.2.1 ou posteriores em uma versão anterior do Tableau Prep Builder, você poderá ver o erro a seguir:

Flows that include features that are not supported in earlier releases will result in this incompatibility error. (Fluxos que incluem recursos não suportados em versões anteriores resultarão neste erro de incompatibilidade.) Para resolver o erro, abra o fluxo na versão posterior e salve uma cópia dele sem os recursos indicados. No exemplo acima, remova o filtro de nulos do campo onde ele foi aplicado.

Depois abra a cópia com o recurso removido na versão anterior do Tableau Prep Builder.

Erro: "Failed to parse response from Tableau Server" ao publicar a saída do Tableau Prep

Para publicar com sucesso a saída do Tableau Prep Builder no Tableau Server, a REST API deve estar habilitada no Tableau Server. Se a REST API não estiver habilitada, você verá o erro a seguir:

Failed to parse response from Tableau server due to:javax.xml.bind.UnmarshalException - with linked exception: [org.xml.sax.SAXParseException; lineNumber: 1; columnNumber: 10; DOCTYPE is disallowed when the feature "http://apache.org/xml/features/disallow-doctype-decl" set to true.]

Para obter informações sobre como habilitar a REST API no Tableau Server, consulte Requisitos da REST API(Link opens in a new window) na Ajuda da REST API.

Para obter mais informações sobre como publicar a saída do Tableau Prep Builder, consulte Criar e publicar extrações de dados e fontes de dados.

Erro: "You are using Server version: null..." ao fazer logon em um Tableau Server habilitado para SSL usando o Tableau Prep

Ao fazer logon em um Tableau Server habilitado para SSL a partir do Tableau Prep Builder, é necessário ter um certificado raiz instalado no computador com o Tableau Prep. Se o certificado não estiver instalado, você poderá ver o erro a seguir:

Você está usando a versão do Server: null, mas a versão mínima compatível é: 10.0. Atualize para uma versão compatível

Caso veja esse erro, trabalhe com o departamento de TI ou com o administrador de sistema para instalar o certificado raiz solicitado no computador que executa o Tableau Prep Builder. Para obter mais informações, consulte Requisitos de sistema(Link opens in a new window) no Guia de implantação do Tableau Desktop e Tableau Prep Builder.

Outros artigos nesta seção

Agradecemos seu feedback! Ocorreu um erro ao enviar o feedback. Tente novamente ou envie-nos uma mensagem.