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.
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(Link opens in a new window).
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(Link opens in a new window) |
"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(Link opens in a new window) |
"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(Link opens in a new window). |
"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: "Non è stato possibile analizzare la risposta di Tableau Server durante la pubblicazione dell'output di Tableau Prep
Per pubblicare correttamente l'output da Tableau Prep Builder a Tableau Server, l'API REST deve essere abilitata su Tableau Server. Se l'API REST non è abilitata, verrà visualizzato il seguente errore:
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.]
Per informazioni sull'abilitazione dell'API REST su Tableau Server, vedi Requisiti API REST(Link opens in a new window) nella Guida di API REST.
Per informazioni sulla pubblicazione di output da Tableau Prep Builder, consulta Creare file di estrazione dati e origini dati pubblicate.
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(Link opens in a new window) nella Guida alla distribuzione di Tableau Desktop e Tableau Prep Builder.