Risoluzione dei problemi di Tableau Prep Builder

In questo articolo vengono elencati i problemi che possono verificarsi quando si utilizza Tableau Prep Builder e suggerimenti per risolverli.

Durante la risoluzione dei problemi del flusso, sia che tu stia eseguendo il debug autonomamente o contattando l’assistenza, in genere devi raccogliere i file di log e i file di dump degli arresti anomali per l’analisi, oltre a documentare le fasi necessarie per riprodurre l’errore. Indicare esattamente le fasi eseguite prima che si verificasse l’errore, così come fornire il file di flusso, è il modo migliore per aiutare lo sviluppatore o il team di assistenza a diagnosticare il problema.

Raccolta dei file di log e di dump degli arresti anomali

I file di log di Tableau Prep sono archiviati nella cartella Repository personale di Tableau Prep. Per impostazione predefinita, il percorso è:

Windows: C:\Users\<username>\Documents\My Tableau Prep Repository\Logs.

MacOS: /users/<username>/Documents/My Tableau Prep Repository/Logs

Per diagnosticare correttamente il problema, devi raccogliere tutti i file di log. Se esegui Tableau Prep Builder, si tratta di tutto il contenuto della cartella “Repository personale di Tableau Prep/Log”. Se esegui Tableau Prep dalla riga di comando, includi i file di log da “Repository personale di Tableau Prep/Repository della riga di comando/Log”.

Questa tabella descrive i diversi file di log generati.

Nome file di log	Processo che genera il file di log	Descrizione
app.log	Tableau Prep.exe	File di log dell’interfaccia utente. Prodotto dal codice JavaScript in esecuzione nel processo Electron.
backendProcessManager.log	Tableau Prep.exe	Prodotto dal codice JavaScript che avvia e monitora il processo Java.
preprestapi.log	Java.exe	File di log prodotto dal codice Java. Le voci del log riguardanti l’utilizzo dell’API REST, la compilazione, la gestione della cache e l’avvio e l’arresto del processo tabminerva (già prepservice) devono trovarsi qui.
log.txt	prepservice.exe tabminerva.exe	Questo log è prodotto dal codice C++. Include tutte le interazioni con le risorse tecnologiche condivise di Tableau, tra cui le connessioni ai database, le query, l’esecuzione, la memorizzazione nella cache esterna, la pipeline delle query, i protocolli e altro ancora.
tdeserver.txt	tdeserver64.exe	Questo è il file di log creato dal precedente motore dati Tableau. Tableau Prep utilizza ancora il motore dati Tableau.
tabprotosrv.txt	tabprotosrv.exe	Log del server del protocollo. Qualsiasi elemento in cui utilizzi un driver di database ospitato genera linee di log in questo file.
hyperd.log	hyperd.exe	Log Hyper. Le query e gli errori correlati alle query sono qui.

Abilitare la registrazione delle query

A partire da Tableau Prep Builder versione 2026.2, puoi attivare l’impostazione Abilita registrazione query nel menu Guida > Impostazioni e prestazioni senza dover riavviare l’applicazione. Quando è attivata, questa impostazione genera un file di query XML per ogni query eseguita da Tableau Prep Builder. Questa funzionalità può essere utile per diagnosticare problemi del flusso. I log vengono generati e archiviati nella cartella Query.

Menu della Guida in Tableau Prep che mostra le opzioni del menu Impostazioni e prestazioni.

Puoi trovare questi log di query nelle directory seguenti:

Windows: C:\Users\<username>\Documents\My Tableau Prep Repository\Query

MacOS: /users/<username>/Documents/My Tableau Prep Repository/Query

Esecuzione di LogShark

LogShark è un’utilità della riga di comando open source gratuita che puoi utilizzare per estrarre informazioni dai file di registro di Prep per risolvere i problemi e ottenere informazioni su errori e utilizzo. Usando il plug-in LogShark Prep.twbx, puoi generare cartelle di lavoro con un errore e una dashboard di flusso per aiutarti ad analizzare e visualizzare i problemi di Prep.

Per informazioni sull’installazione e l’esecuzione di LogShark, vedere Configurazione del computer per LogShark.

Creazione di file di dump di arresto anomalo

Oltre ai file di log, devi raccogliere i file di dump di arresto anomalo. Tutto ciò che non è presente nei file di log potrebbe essere descritto in dettaglio qui ed essere utile per la risoluzione dei problemi relativi all’avvio dell’applicazione, alle eccezioni o ai problemi durante l’esecuzione di query su .hyper.

Quando si creano file di dump di arresto anomalo, è utile crearli per i processi seguenti.

Processo	Descrizione
tabminerva.exe (già prepservice.exe)	Processo nativo che ospita il resto della logica di business di Tableau Prep. È anche il processo che contiene la tecnologia nativa condivisa di Tableau, inclusi i connettori di database.
hyperd.exe	Processo del database hyper. Ogni volta che una query genera un errore. I file di dump di arresto anomalo di hyper possono essere utili quando si verifica un errore, perché gran parte delle operazioni eseguite da Tableau Prep comporta l’esecuzione di query su hyper.

Per creare file di dump di arresto anomalo, procedi come segue, a seconda del tuo sistema operativo.

Windows

Apri Gestione attività.
Fai clic con il pulsante destro del mouse sull’intestazione colonna e seleziona Process name (Nome processo) e Command Line (Riga di comando). In questo modo vengono visualizzati i diversi processi e puoi selezionare quello che desideri utilizzare per creare un file di dump di arresto anomalo.
Fai clic con il pulsante destro del mouse sul processo tabminerva.exe (già prepservice.exe).
Seleziona Crea file di dump.
Si aprirà una finestra di dialogo che mostrerà la posizione del file di dump di arresto anomalo nel sistema.

MacOS

In MacOS sono disponibili due tipi di file diagnostici utili per la risoluzione dei problemi di Tableau Prep:

Report di arresto anomalo: registra lo stack delle chiamate al momento dell’arresto anomalo, in modo simile a una traccia dello stack.
File principale: uno snapshot completo della memoria del processo al momento dell’arresto.

In entrambi i casi è necessario terminare il processo di Tableau Prep. Dopo aver raccolto questi file dovrai riavviare Tableau Prep.

Prerequisito: per la raccolta di file principali è richiesto l’accesso come amministratore.

Fase 1. Creare un report di arresto anomalo

Apri il terminale.
Esegui il comando: pgrep tabminerva | xargs kill -SEGV
Questo comando termina il processo tabminerva.exe inviando un segnale di errore di segmentazione, che fa sì che MacOS generi automaticamente un report di arresto anomalo.
Trova il report di arresto anomalo salvato in: ~/Library/Logs/DiagnosticReports/
Il nome file ha il formato tabminerva_AAAA-MM-GG-HHMMSS_nomecomputer.crash o tabminerva_AAAA-MM-GG-HHMMSS_nomecomputer.ips

Quando invii questo file all’assistenza o al team di sviluppo Tableau, assicurati di precisare di aver inviato intenzionalmente un segnale di errore di segmentazione per generare il report. Questo distingue la tua operazione da un vero e proprio arresto anomalo.

Fase 2: Creare un file principale

Per creare il file principale, utilizza una delle seguenti opzioni:

Creare un file principale e terminare la sessione di Tableau Prep

Apri il terminale.
Esegui il comando sudo chmod 1777 /cores per concedere l’accesso in scrittura alla directory del file principale.
Esegui il comando ulimit -c unlimited per rimuovere il limite relativo alle dimensioni del file principale per la sessione corrente del terminale.
Esegui il comando pgrep tabminerva | xargs kill -SEGV per terminare il processo e generare il file principale.
Trova il file principale in /cores/, denominato core.<process_id>.

Creare un file principale mantenendo Tableau Prep in esecuzione

Questa opzione utilizza l’utilità gcore per acquisire un dump principale di un processo in esecuzione senza terminarlo. Questo processo richiede l’installazione dello strumento da riga di comando Xcode. Per verificare se questa opzione è installata, apri il terminale ed esegui Bash xcode-select --install.

Apri il terminale.
Esegui il comando: sudo gcore -o /tmp/tabminerva.core $(pgrep tabminerva)
In questo modo il file di base viene salvato in /tmp/tabminerva.core. Tableau Prep continua a funzionare normalmente.

Errori comuni quando si usa la riga di comando per eseguire i flussi

Puoi eseguire i flussi dalla riga di comando per aggiornare i file di output anziché aprire Tableau Prep Builder per eseguire manualmente ciascun flusso. Mentre questo processo aiuta a costruire l’efficienza nel processo di flusso, se la sintassi non è corretta, o se mancano le credenziali per le connessioni o le posizioni di output, si riceveranno errori durante l’esecuzione di questo processo.

Per un elenco di tutte le opzioni della riga di comando supportate in Tableau Prep, consulta Riferimento della riga di comando di Tableau Prep(Il collegamento viene aperto in una nuova finestra).

La seguente tabella descrive gli errori più comuni e come risolverli. Per informazioni su come eseguire i flussi dalla riga di comando, consulta Aggiornare i file di output del flusso dalla riga di comando(Il collegamento viene aperto in una nuova finestra).

Errore	Causa	Come risolvere il problema
"Argomenti mancanti"	Manca uno degli argomenti richiesti dalla riga di comando.	Usare "tableau-prep-cli -help" per un elenco degli argomenti per la riga di comando.
"Impossibile leggere il file delle connessioni."	Ci sono errori nella sintassi o nel formato del file credentials.json per le connessioni di input.	Controllare la sintassi delle connessioni di input nel file .json. Per ulteriori informazioni ed esempi, consulta Aggiornare i file di output del flusso dalla riga di comando(Il collegamento viene aperto in una nuova finestra)
"Ci sono errori nel flusso. Impossibile eseguire il flusso. Verificare che il file .json delle credenziali includa tutte le credenziali richieste. Per visualizzare i dettagli di errore, apri il flusso in Tableau Prep Builder.	Nel file credentials.json mancano le credenziali per le connessioni di input o il flusso presenta errori.	Verifica che il file .json disponga delle credenziali per tutte le connessioni e aprire il file di flusso in Tableau Prep Builder per verificare se vi sono errori nel flusso. Se il flusso presenta degli errori, è necessario correggerli e ripubblicare il flusso su Tableau Server, quindi provare ad eseguire nuovamente il processo.
"Impossibile trovare una corrispondenza per <hostname of inputConnections >"	Nel file credentials.json manca una voce per il nome host (nome del server).	Assicurarsi che il file credentials.json includa le credenziali corrette per il nome host (nome del server). Per ulteriori informazioni ed esempi, consulta Aggiornare i file di output del flusso dalla riga di comando(Il collegamento viene aperto in una nuova finestra)
"Non disponiamo delle credenziali di tutte le connessioni nel file tfl/tflx. I seguenti collegamenti non sono stati trovati: <hostname of inputConnections>"	Il file credentials.json è mancante o ha credenziali errate per il nome host (nome del server) mostrato nel messaggio di errore.	Assicurarsi che il file credentials.json includa le credenziali corrette per il nome host (nome del server) mostrato nel messaggio di errore. Per ulteriori informazioni ed esempi, consulta Aggiornare i file di output del flusso dalla riga di comando
"Errore di accesso al server <serverUrl> come utente <userName>. Controllare le credenziali."	Le credenziali del file credentials.json sono errate per Tableau Server.	Assicurati che il file credentials.json includa tutte le credenziali e gli elementi corretti per la connessione di output. Per ulteriori informazioni ed esempi, consulta Aggiornare i file di output del flusso dalla riga di comando
"Impossibile accedere correttamente come <userName> al server <serverUrl>(<contentUrl>)"	Le credenziali del file credentials.json sono errate per Tableau Server.	Assicurati che il file credentials.json includa tutte le credenziali e gli elementi corretti per la connessione di output. Per ulteriori informazioni ed esempi, consulta Aggiornare i file di output del flusso dalla riga di comando
"Non disponiamo delle credenziali di Tableau Server per pubblicare l’estratto di uno o più nodi di output in un file tfl/tflx."	Il file credentials.json non è stato passato come argomento da riga di comando o mancano le credenziali per la connessione di output.	Assicurarsi che il percorso del file credentials.json sia incluso nella riga di comando e verificare che il file credentials.json includa tutte le credenziali e gli elementi corretti per la connessione di output. Per ulteriori informazioni ed esempi, consulta Aggiornare i file di output del flusso dalla riga di comando
"Server api Loom rest non avviato"	L’installazione o la configurazione dell’ambiente non è corretta.	Verifica che Tableau Prep Builder sia installato correttamente e di star eseguendo il comando come amministratore. Per informazioni su come installare Tableau Prep Builder, vedi Installare Tableau Desktop o Tableau Prep Builder dall’Interfaccia utente(Il collegamento viene aperto in una nuova finestra).
"Errore. Il file di flusso non esiste."	Il percorso del file di flusso non è corretto.	Assicurarsi che il percorso corretto del file di flusso sia incluso nella riga di comando.
"Errore. Il file delle connessioni non esiste."	Il percorso del file credentials.json non è corretto.	Assicurati che il percorso corretto del file credentials.json sia incluso nella riga di comando.
"Impossibile trovare una corrispondenza per <mapr01:5181>,<mapr02:5181>,<mapr03:5181>"	È necessario specificare un ID porta specifico durante la connessione ad Apache Drill utilizzando ZooKeeper.	Includi un file credentials.json nella riga di comando che specifica "porta": 31010 per le credenziali di input.

Errori comuni di Tableau Prep

La tabella seguente descrive alcuni errori comuni che possono verificarsi quando utilizzi Tableau Prep e alcune soluzioni da provare.

Errore	Causa	Come risolvere il problema	Articolo della Knowledge Base
Impossibile connettersi a Tableau Server. Verifica che il server sia in esecuzione e che l’URL sia corretto. `tableauErrorCode=0xD5A9A6F9; tableauStatusCode=UNAUTHENTICATED; exceptionName=VizportalAuthenticationException`	Un proxy o un firewall impedisce al browser incorporato di Tableau Prep Builder di completare l’handshake di accesso a Tableau Cloud.	Collabora con il reparto IT per inserire nell’elenco consentiti gli URL di Tableau Cloud attraverso il proxy. Disconnettiti e accedi di nuovo da Tableau Prep Builder. Se è presente uno script di configurazione automatica del proxy, verifica che gestisca l’autenticazione senza richiedere le credenziali.	Impossibile accedere a Tableau Online da Tableau Prep Builder in un ambiente proxy che richiede l’autenticazione (in inglese)(Il collegamento viene aperto in una nuova finestra)
Il certificato SSL necessario potrebbe essere mancante o non corrispondere al certificato di Tableau Server per [nomehostserver]. Viene visualizzato anche nella forma “Unable to find requested certificate path for flow ID” (Impossibile trovare il percorso del certificato richiesto per l’ID flusso) durante l’esecuzione di flussi sul server.	File della catena di certificati SSL mancante in Tableau Server o non installato sul computer che esegue Tableau Prep Builder. In alcuni casi, il problema è causato da un servizio di bilanciamento del carico AWS che utilizza un criterio TLS incompatibile.	Assicurati che il file della catena di certificati SSL sia caricato in Tableau Server. Installa il certificato sul computer in cui è in esecuzione Prep Builder (se facendo doppio clic e selezionando “Install Certificate” (Installa certificato) viene restituito il messaggio “The file is invalid for use as the following: Security Certificate” (Il file non è valido per l’utilizzo seguente: certificato di sicurezza), il file di certificato stesso potrebbe essere danneggiato. Collabora con il reparto IT per esportare un file di catena valido. Se ti trovi dietro un servizio di bilanciamento del carico AWS, esegui il downgrade del criterio a ELBSecurityPolicy-TLS-1-2-2017-01.	Errore: il certificato SSL richiesto potrebbe essere mancante o non corrispondere al certificato di Tableau Server. Accesso da Tableau Prep (in inglese)(Il collegamento viene aperto in una nuova finestra)
L’esecuzione di Tableau Prep Builder è stata arrestata perché un processo sottostante si è arrestato in modo imprevisto. Se il problema persiste, provare a reinstallare il prodotto.	Questo problema può essere causato da più fattori: configurazione della VPN o della rete (problema confermato con la VPN di Cato Network, che blocca la comunicazione localhost), interferenza del software antivirus o un file di porta danneggiato quando si apre un file .tfl specifico. Nota: Tableau Prep Builder non deve mai essere installato su un nodo di Tableau Server. Questa è una causa nota di questo errore.	Reinstalla, controlla le esclusioni del software antivirus, verifica la comunicazione localhost IPv4/IPv6 Se il problema è specifico della VPN, prova una VPN alternativa per isolarlo o coinvolgi il team addetto alla rete per verificare la presenza di blocchi localhost Se è correlato a un file .tfl specifico, raccogli i log di Prep e i dump IPS per esaminare gli arresti anomali del processo tabminerva Assicurati che Tableau Prep Builder non sia installato su alcun nodo di Tableau Server.	Errore: l’esecuzione di Tableau Prep è stata interrotta perché un processo sottostante si è arrestato in modo imprevisto all’avvio di Tableau Prep (in inglese)(Il collegamento viene aperto in una nuova finestra)
AqlProcessor evaluation failed: Canceled (Valutazione AqlProcessor non riuscita: annullata). Flusso non riuscito dopo una fase di pivot	Problema noto quando si modifica il valore di una colonna trasformata tramite pivot dopo una fase di pivot.	Nota: questa correzione si applica alle versioni 2022.2 e successive. Esegui l’aggiornamento a una versione coperta dalla correzione. Come soluzione alternativa per le versioni precedenti, evita di modificare i valori delle colonne trasformate tramite pivot nelle fasi a valle del pivot.	Errore: errore di sistema: si è verificato un errore durante la comunicazione con l’origine dati (LoomDataSource) quando si modifica il valore di una colonna trasformata tramite pivot dopo la fase di pivot (in inglese)(Il collegamento viene aperto in una nuova finestra)
Impossibile pubblicare l’origine dati: il flusso viene eseguito correttamente in locale o durante l’output in un file .hyper, ma non riesce quando viene pubblicato in Tableau Cloud.	Il flusso non riesce a causa delle dimensioni del file temporaneo, che superano i limiti di Tableau Cloud. Il problema si verifica anche quando un flusso non riesce con errori SQL relativi alla memoria (ad esempio, in caso di operazioni JOIN di grandi dimensioni) che emergono solo in Tableau Cloud, non in locale.	Passa l’output a un file .hyper locale per verificare che il problema sia specifico del cloud. Riduci la complessità del flusso, suddividilo in flussi più piccoli, rimuovi le colonne inutilizzate o utilizza connessioni live.	Non applicabile
Prep Builder non si apre in Windows. I log di debug mostrano un errore relativo a un percorso di cartella temporanea relativo.	La variabile di ambiente TEMP di Windows è impostata su un percorso relativo (ad esempio, `%USERPROFILE%\AppData\Local\Temp`) o contiene una voce di percorso duplicata. Tableau Prep Builder richiede un percorso assoluto.	Verifica che la variabile di ambiente TEMP di Windows sia impostata su un percorso assoluto (ad esempio, `C:\Users[username]\AppData\Local\Temp`) Rimuovi eventuali voci duplicate dalla variabile TEMP.	Non applicabile

Altri articoli in questa sezione

Torna in alto

Grazie per il tuo feedback.

Il tuo feedback è stato inviato. Grazie!

Guida di Tableau Prep