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.
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.
LogShark richiede che i file di registro di Prep elaborati siano file compressi (zippati). Per trovare i file di registro di Prep, vai alla cartella Repository personale di Tableau Prep. La posizione è /Users/<username>/Documents/My Tableau Prep Repository.
Per informazioni sull’installazione e l’esecuzione di LogShark, vedere Configurazione del computer per LogShark.
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 a livello di programmazione anziché aprire Tableau Prep Builder per eseguire manualmente ogni 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.
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. |
Errore: "Sono state rilevate queste caratteristiche che impediscono alla versione dell’applicazione di usare il file"
Se apri un flusso creato con la versione 2018.2.1 o successiva in una versione precedente di Tableau Prep Builder, è possibile che venga visualizzato l’errore seguente:
I flussi che includono funzioni non supportate nelle versioni precedenti restituiranno questo errore di incompatibilità. Per risolvere l’errore, apri il flusso nella versione successiva e salva una copia del flusso senza le caratteristiche indicate. Nell’esempio precedente, rimuovere il filtro null dal campo in cui è applicato.
Apri quindi la copia con la funzionalità rimossa nella versione precedente di Tableau Prep Builder.
Errore: "Si sta usando la versione del server: null....." quando si accede a un server Tableau abilitato a SSL utilizzando Tableau Prep
Quando si accede a un server Tableau compatibile con SSL da Tableau Prep Builder, devi disporre di un certificato radice installato nel computer in cui è installato Tableau Prep Builder. Se il certificato non è installato, si può visualizzare il seguente errore:
Si sta usando la versione Server: null ma la versione minima compatibile è: 10.0. Aggiornare a una versione compatibile
Se viene visualizzato questo errore, contatta il reparto IT o l’amministratore di sistema per installare il certificato radice necessario nel computer in cui è installato Tableau Prep Builder. Per ulteriori informazioni, consultaRequisiti di sistema(Il collegamento viene aperto in una nuova finestra) nella Guida alla distribuzione di Tableau Desktop e Tableau Prep Builder.