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.
Ao solucionar problemas com seu fluxo, seja para depuração ou para entrar em contato com o suporte, geralmente, você precisará coletar os arquivos de registro e os arquivos de despejo com falhas para análise, bem como documentar as etapas necessárias para reproduzir o erro. Fornecer as etapas exatas que você executou antes que o erro ocorresse, bem como fornecer o arquivo de fluxo, é a melhor maneira de ajudar o desenvolvedor ou a equipe de suporte a diagnosticar o problema.
Coletando arquivos de log e de despejo com falhas
Os arquivos de registro do Tableau Prep são armazenados na pasta Meu repositório do Tableau Prep. Por padrão, o local é:
Windows: C:\Users\<username>\Documents\My Tableau Prep Repository\Logs.
MacOS: /users/<username>/Documents/My Tableau Prep Repository/Logs
Para diagnosticar corretamente o problema, você precisará coletar todos os arquivos de registro. Se você estiver executando o Tableau Prep Builder, isso é tudo na pasta “My Tableau Prep Repository/Logs”. Se você estiver executando o Tableau Prep a partir da linha de comando, inclua os arquivos de log de “My Tableau Prep Repository/Command Line Repository/Logs”.
Essa tabela descreve os diferentes arquivos de log gerados.
| Nome do arquivo de log | Processo que gera o arquivo de log | Descrição |
|---|---|---|
| app.log | Tableau Prep.exe | Arquivo de log da interface do usuário. É produzido pelo código JavaScript em execução no processo Electron. |
| backendProcessManager.log | Tableau Prep.exe | É produzido pelo código JavaScript que é iniciado e monitora o processo Java. |
preprestapi.log | Java.exe | Este é o arquivo de log produzido pelo código Java. As entradas de registro relacionadas ao uso da API REST, compilação, gerenciamento de cache e inicialização e desligamento do processo tabminerva (anteriormente prepservice) devem estar aqui. |
| log.txt | prepservice.exe tabminerva.exe | Esse log é produzido pelo código C++. Esse registro inclui toda a interação com a pilha de tecnologia compartilhada do Tableau, incluindo conexões a bancos de dados, consultas, execução, cache externo, pipeline de consulta, protocolos e muito mais. |
| tdeserver.txt | tdeserver64.exe | Este é o arquivo de log criado pelo antigo Tableau Data Engine. O Tableau Prep ainda usa o Tableau Data Engine. |
| tabprotosrv.txt | tabprotosrv.exe | O log do servidor de protocolo. Qualquer coisa em que você use um driver de banco de dados hospedado produzirá linhas de log nesse arquivo. |
| hyperd.log | hyperd.exe | O log hyper. Consultas e erros relacionados a consultas estão aqui. |
Habilitar o log de consultas
A partir do Tableau Prep Builder versão 2026.2, você pode ativar a configuração Habilitar registro de consultas no menu Configurações e desempenho do > Ajuda sem precisar reiniciar o aplicativo. Quando ativada, essa configuração gera um arquivo de consulta XML para cada consulta executada pelo Tableau Prep Builder. Isso pode ser útil ao diagnosticar problemas com seu fluxo. Os logs são gerados e armazenados na pasta Consulta.
Você pode encontrar esses registros de consulta nos seguintes diretórios:
Windows: C:\Users\<username>\Documents\My Tableau Prep Repository\Query
MacOS: /users/<username>/Documents/My Tableau Prep Repository/Query
Executar o LogShark
LogShark é um utilitário de linha de comando de código aberto gratuito que você pode usar para extrair informações de arquivos de log do Prep para solucionar problemas e obter informações sobre erros e uso. Usando o plugin do Prep.twbx LogShark, você pode gerar pastas de trabalho com um painel de erro e fluxo para ajudar a analisar e visualizar problemas de preparação.
Para obter informações sobre como instalar e executar o LogShark, consulte Configure seu computador para o LogShark.
Criar arquivos de despejo de falhas
Além dos arquivos de log, você também deseja coletar arquivos de despejo de falha. Tudo o que não estiver nos arquivos de log pode ser detalhado aqui e pode ajudar na solução de problemas de inicialização do aplicativo, exceções ou problemas ao consultar o .hyper.
Ao criar arquivos de despejo de falha, é útil criá-los para os processos a seguir.
| Processo | Descrição |
|---|---|
| tabminerva.exe (anteriormente prepservice.exe) | Esse é o processo nativo que hospeda o restante da lógica de negócios do Tableau Prep. Também é o processo que contém a tecnologia nativa compartilhada do Tableau, incluindo conectores de banco de dados. |
| hyperd.exe | Este é o processo de banco de dados hyper. Sempre que uma consulta falhar. Os despejos de falha do hyper podem ser úteis quando ocorre uma falha porque grande parte do que o Tableau Prep faz envolve consultas ao hyper. |
Para criar arquivos de despejo com falhas, faça o seguinte, dependendo do seu sistema operacional.
Windows
Abrir o Gerenciador de tarefas.
Clique com o botão direito do mouse no cabeçalho da coluna e selecione Nome do processo e Linha de comando. Isso mostra os diferentes processos e permite que você selecione aquele que deseja usar para criar um arquivo de despejo com falhas.
Clique com o botão direito do mouse no processo tabminerva.exe (anteriormente prepservice.exe).
Selecione Criar arquivo de despejo.
Uma caixa de diálogo será aberta e mostrará a localização do arquivo de despejo com falhas em seu sistema.
MacOS
No MacOS, há dois tipos de arquivos de diagnóstico úteis para solucionar problemas do Tableau Prep:
Relatório de falhas — registra a pilha de chamadas no momento da falha, semelhante a um rastreamento de pilha.
Arquivo principal — um instantâneo completo da memória do processo no momento do fechamento.
Ambos exigem o encerramento do processo do Tableau Prep. Você precisará reiniciar o Tableau Prep após coletar esses arquivos.
Pré-requisito: é preciso ter acesso de administrador para a coleta de arquivos principais.
Etapa 1: criar um relatório de falhas
Abra o Terminal.
Execute o comando:
pgrep tabminerva | xargs kill -SEGVIsso encerra o processo tabminerva.exe enviando um sinal de falha de segmentação, o que faz com que o MacOS gere um relatório de falha automaticamente.
Encontre o relatório de falhas salvo em:
~/Library/Logs/DiagnosticReports/O nome do arquivo segue o formato tabminerva_YYYY-MM-DD-HHMMSS_machinename.crash ou tabminerva_YYYY-MM-DD-HHMMSS_machinename.ips
Ao enviar esse arquivo para o suporte ou para a equipe de desenvolvimento do Tableau, certifique-se de declarar que você enviou intencionalmente um sinal de falha de segmentação para gerar o relatório. Isso o distingue de uma falha genuína.
Etapa 2: criar um arquivo principal
Utilize uma das seguintes opções para criar seu arquivo principal.
Criar um arquivo principal e encerrar a sessão do Tableau Prep
Abra o Terminal.
Execute o comando
sudo chmod 1777 /corespara conceder acesso de gravação ao diretório do arquivo principal.Execute o comando
ulimit -c unlimitedpara remover o limite no tamanho do arquivo principal para a sessão atual do terminal.Execute o comando
pgrep tabminerva | xargs kill -SEGVpara encerrar o processo e gerar o arquivo principal.Localize o arquivo principal em
/cores/com o nomecore.<process_id>.
Criar um arquivo principal e mantenha o Tableau Prep em execução
Essa opção usa um utilitário gcore para capturar um despejo central de um processo em execução sem encerrá-lo. Esse processo requer que a ferramenta de linha de comando Xcode seja instalada. Para verificar se você tem essa opção instalada, abra o Terminal e execute Bash xcode-select --install.
Abra o Terminal.
Execute o comando:
sudo gcore -o /tmp/tabminerva.core $(pgrep tabminerva)Isso salva o arquivo principal em
/tmp/tabminerva.core. O Tableau Prep continua funcionando normalmente.
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 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.
Para obter uma lista de todas as opções de linha de comando com suporte no Tableau Prep, consulte Referência de linha de comando do Tableau Prep(O link abre em nova janela).
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(O link abre em nova janela).
| 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(O link abre em nova janela). |
"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(O link abre em nova janela) |
| "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(O link abre em nova janela). |
| "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. |
Erros comuns do Tableau Prep
A tabela a seguir descreve alguns erros comuns que você pode encontrar ao usar o Tableau Prep juntamente com soluções para testar.
| Erro | Causa | Como corrigir | Artigo de conhecimento |
|---|---|---|---|
Não foi posspível se conectar ao Tableau Server. Verifique se o servidor está em execução e se a URL está correta. tableauErrorCode=0xD5A9A6F9; tableauStatusCode=UNAUTHENTICATED; exceptionName=VizportalAuthenticationException | Um proxy ou firewall está impedindo que o navegador incorporado do Tableau Prep Builder conclua o handshake de logon do Tableau Cloud. | Trabalhe com o setor de TI para usar URLs do Tableau Cloud na lista de permissões por meio do proxy. Saia e entre novamente no Tableau Prep Builder. Se um script de configuração de proxy automático estiver em vigor, verifique se ele manipula a autenticação sem solicitar credenciais. | Não é possível fazer logon no Tableau Online via Tableau Prep Builder em um ambiente de proxy necessário para autenticação(O link abre em nova janela) |
O certificado SSL necessário pode estar ausente ou não corresponder ao certificado do Tableau Server para [serverhostname]. Também visto como “Não foi possível localizar o caminho de certificado solicitado para a ID de fluxo” ao executar fluxos no servidor. | Arquivo de cadeia de certificados SSL ausente no Tableau Server ou o arquivo de cadeia não está instalado na máquina que executa o Tableau Prep Builder. Em alguns casos, o problema é causado por um balanceador de carga AWS usando uma política TLS incompatível. | Certifique-se de que o arquivo da cadeia de certificados SSL esteja carregado no Tableau Server. Instale o certificado na máquina que executa o Prep Builder (se clicar duas vezes e selecionar “Instalar certificado”, retorna “O arquivo é inválido para uso como o seguinte: Certificado de segurança”, o próprio arquivo de certificado pode estar malformado. Trabalhe com o setor de TI para exportar um arquivo de cadeia válido. Se estiver com um balanceador de carga AWS desatualizado, faça o downgrade da política para ELBSecurityPolicy-TLS-1-2-2017-01. | Erro - O certificado SSL necessário pode estar ausente ou não corresponder ao certificado do Tableau Server - Fazer logon por meio do Tableau Prep(O link abre em nova janela) |
O Tableau Prep Builder parou de executar porque um processo subjacente parou inesperadamente. Se o problema continuar, tente reinstalar o produto. | Isso pode ser desencadeado por vários fatores: configuração de VPN/rede (confirmada com o bloqueio da comunicação localhost da Cato Network VPN), interferência antivírus ou um arquivo de porta corrompido ao abrir um arquivo .tfl específico. Observação: o Tableau Prep Builder nunca deve ser instalado em um nó do Tableau Server. Essa é uma causa conhecida deste erro. | Reinstalar, verificar exclusões de AV, verificar a comunicação IPv4/IPv6 com localhost Se for específico de VPN, teste com uma VPN alternativa para isolar; fale com a equipe de rede para verificar se há blocos do localhost Se vinculado a um arquivo .tfl específico, colete logs do Prep e despejos de IPS para investigar falhas no processo tabminerva Verifique se o Tableau Prep Builder não está instalado em algum nó do Tableau Server. | Erro: o Tableau Prep parou de executar porque um processo subjacente parou inesperadamente ao iniciar o Tableau Prep(O link abre em nova janela) |
| Falha na avaliação do processador Aql: “Cancelado” — falha no fluxo após uma etapa de dinamização | Problema conhecido ao alterar o valor de uma coluna dinamizada após a etapa de dinamização. | Nota: esta correção aplica-se às versões 2022.2 e posteriores. Atualize para uma versão inclusa nessa correção. Como solução alternativa em versões mais antigas, evite modificar valores de coluna dinamizados nas etapas posteriores à dinamização. | Erro: erro do sistema - Erro na comunicação com a fonte de dados (LoomDataSource) ao alterar o valor de uma coluna dinamizada após a etapa de dinamização(O link abre em nova janela) |
| Não é possível publicar a fonte de dados” — o fluxo é executado com êxito localmente ou ao gerar para um arquivo .hyper, mas falha ao publicar no Tableau Cloud. | O fluxo falha devido ao tamanho do arquivo temporário exceder os limites do Tableau Cloud. Também observado quando um fluxo falha com erros de SQL relacionados à memória (por exemplo, grandes operações JOIN) que só aparecem no Tableau Cloud, não localmente. | Alterne a saída para um arquivo .hyper local para confirmar se o problema é específico da nuvem. Reduza a complexidade do fluxo, entre em fluxos menores, remova colunas não utilizadas ou use conexões em tempo real. | N/A |
| O Prep Builder não abre no Windows; os logs de depuração mostram um erro relacionado a um caminho relativo da pasta temporária. | A variável de ambiente Windows TEMP é definida como um caminho relativo (por exemplo, O Tableau Prep Builder exige um caminho absoluto. | Verifique se a variável de ambiente Windows TEMP está definida como um caminho absoluto (por exemplo, Remove quaisquer entradas duplicadas da variável TEMP. | N/A |