Guida di Tableau Prep

Esegui il comando come amministratore dalla directory in cui si trova il file .exe oppure specifica il percorso completo del file .exe nel computer. Non eseguire il programma da una directory condivisa. Per un elenco delle opzioni supportate del programma di installazione, consulta Opzioni del programma di installazione(Il collegamento viene aperto in una nuova finestra). Per un elenco delle proprietà supportate del programma di installazione, consulta Proprietà del programma di installazione(Il collegamento viene aperto in una nuova finestra).

• tableau_<product_installer_name>.exe è il programma di installazione di Tableau per il prodotto e la versione in corso di installazione.

• option1, option2 e così via consentono di specificare il modo in cui vuoi che venga eseguito il processo di installazione.

• PROPERTY1, PROPERTY2 e così via consentono di specificare le impostazioni di configurazione che il programma di installazione deve eseguire durante il processo di installazione.

Esempio:

tableauPrepBuilder-64bit-2026-2-0.exe /quiet /norestart ACCEPTEULA=1 CRASHDUMP="0" SENDTELEMETRY="0"

Questo comando consente di installare Tableau versione 2026.2 in modalità non interattiva (non visualizza i prompt, l’interfaccia utente o la finestra di dialogo della licenza). Termina l’installazione senza riavvio, accetta il Contratto di licenza con l’utente finale (EULA) e disattiva la segnalazione di errori e i report di utilizzo.

Attiva il prodotto utilizzando il codice prodotto fornito. Termina con il codice 0 in caso di esito positivo. In caso contrario, termina con un codice di errore. Accetta anche il trattino singolo (-activate).

Per attivare il prodotto durante l’installazione, aggiungi una singola riga di comando che includa l’opzione di installazione ACTIVATE_KEY "<codice>" e immetti il codice prodotto racchiuso tra virgolette.

Registra il prodotto. Accetta anche il trattino singolo (-register). Per registrare Tableau dalla riga di comando, devi precompilare i valori di registro (Windows) o .plist (Mac) su ogni computer che eseguirà Tableau Prep Builder.

Per Windows, puoi registrare il prodotto durante l’installazione aggiungendo un’unica riga di comando che includa l’opzione REGISTER="1" del programma di installazione.

Per maggiori informazioni, consulta Registrare Tableau Desktop e Tableau Prep Builder(Il collegamento viene aperto in una nuova finestra).

Aggiorna le licenze con la data di scadenza del periodo di manutenzione corrente e interrompe la visualizzazione dei messaggi relativi alla scadenza. Termina con il codice 0 in caso di esito positivo. Accetta anche il trattino singolo (-refresh).

Windows: esegui tableau.exe con l’opzione --refresh e un codice prodotto.

MacOS: esegui l’opzione -refresh sull’oggetto Tableau nel percorso /Applications.

Disattiva il codice prodotto fornito in modo che possa essere riutilizzato. Accetta anche il trattino singolo (-return).

Windows: esegui tableau.exe con l’opzione -return e un codice prodotto.

MacOS: esegui l’opzione -return sull’oggetto Tableau nel percorso /Applications.

Carica le impostazioni di configurazione dell’applicazione dal file specificato. Può essere specificato più volte per supportare configurazioni a più livelli, ad esempio quando disponi di una configurazione del server proxy globale utilizzata da tutti e di una configurazione di database specifica utilizzata per un flusso.

Esempio di file .json:

{
 "connection-sources":[
  {
	"endpoint":"prod-db-server.company.com",
	"username":"service_account_admin",
	"password":"secure_password_123"
	}
 ]
}

Comando di esempio:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --settings-file "C:\ProgramData\Tableau\global-proxy-config.json" --settings-file "C:\Users\jsmith\AppData\Roaming\Tableau\db-config.json"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --settings-file "/Library/Tableau/global-proxy-config.json" --settings-file "/Users/jsmith/Library/Application Support/Tableau/db-config.json"

Imposta la directory del repository. Per impostazione predefinita, durante l’installazione Tableau Prep crea nella cartella Documenti una cartella denominata Repository personale di Tableau Prep. Questa cartella include le cartelle per flussi, origini dati, connessioni, nonché file di log e una cache temporanea. In ambienti server o di automazione, puoi utilizzare questo comando per specificare un percorso di repository alternativo e indirizzare l’esecuzione del flusso verso di esso.

Esempio:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --repository-location "D:\Tableau_Data\My_Prep_Repo"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --repository-location "/Users/jsmith/Documents/My Tableau Prep Repository"

Directory utilizzata per l’archiviazione dei dati dell’applicazione Electron.

Mentre --repository-location gestisce le risorse aziendali (log e dati), --user-data-directory gestisce il motore interno dell’applicazione.

In qualità di amministratore, utilizza questo flag se esegui Tableau Prep Builder in un ambiente a concorrenza elevata, in cui più processi richiedono stati dell’applicazione isolati, oppure per la risoluzione dei problemi relativi a errori persistenti di blocco della sessione su un server headless.

Nota: quando esegui il comando, viene creata automaticamente la cartella specificata in --user-data-directory. Tuttavia, l’account utente che esegue lo script deve disporre delle autorizzazioni di scrittura per la directory padre.

Esempio:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --user-data-directory "D:\Tableau_Data\Prep_AppData"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --user-data-directory "/Users/jsmith/Library/Application Support/Tableau Prep"

Apre il file di flusso .tfl specificato. Utilizza le virgolette doppie se il percorso del file include spazi.

Esempio:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" -tfl "C:\Users\jsmith\Documents\My Flows\Clean_Sales_Data.tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder -tfl "/Users/jsmith/Documents/My Flows/Clean_Sales_Data.tfl"

Apre il file di flusso compresso .tflx specificato.

Esempio:

Windows:"C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --tflx "C:\Users\jsmith\Desktop\Quarterly_Report.tflx"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --tflx "/Users/jsmith/Desktop/Quarterly_Report.tflx"

Percorso del file .json contenente le credenziali per le origini dati e i server.

Tableau Prep Builder utilizza le informazioni contenute nel file di flusso e dal file .json delle credenziali per eseguire il flusso quando disponi di connessioni remote. Per maggiori informazioni, consulta Requisiti del file .json delle credenziali(Il collegamento viene aperto in una nuova finestra).

Se ti connetti a un database Snowflake, assicurati di includere eventuali parametri specifici come Role, Warehouse e, in alcuni casi, i token OAuth o l’autenticazione tramite browser esterno.

File di impostazioni .json di esempio - Snowflake:

{
 "connection-sources":[
  {
	"endpoint":"company_account.snowflakecomputing.com",
	"username":"SVC_TABLEAU_PREP",
	"password":"EncryptedPassword123",
	"attributes":{
	 "warehouse": "DATA_LOAD_WH",
	 "role": "TRANSFORM_ROLE"
	}
  }
 ]
}						

Esempio:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -c "path\to\[your credential file name].json" -t "path\to\[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

Percorso di un file .json che sostituisce i valori dei parametri predefiniti nel flusso. Questo è un file separato dal file credentials.json e include i nomi e i valori dei parametri.

Per maggiori informazioni, consulta “Eseguire flussi che includono valori di parametri” in Requisiti del file .json delle credenziali(Il collegamento viene aperto in una nuova finestra).

Esempio:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl" -p|--parameters parameters.override.json

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl -p|--parameters parameters.override.json

Se Tableau Prep Conductor non è abilitato nel server per la pianificazione delle esecuzioni del flusso, puoi utilizzare questo comando per eseguire il flusso utilizzando l’aggiornamento incrementale. Per maggiori informazioni, consulta Eseguire il flusso con l’aggiornamento incrementale abilitato.

Esempio:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --incrementalRefresh -t "path\to\[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --incrementalRefresh -t path/to/[your flow file name].tfl

Abilita la modalità di debug. Genera nella cartella del repository log dettagliati utili per la risoluzione dei problemi. I file di log vengono archiviati in: My Tableau Prep Builder Repository\Command Line Repository\Logs

Esempio:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --debug -t "[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --debug -t “[your flow file name]”.tfl

Disabilita la convalida del certificato SSL (utile per alcuni ambienti server interni). Quando esegui questa opzione su MacOS, potrebbe essere visualizzata una finestra di dialogo che richiede utente e password del portachiavi.

A partire da Tableau Prep Builder versione 2019.3.2, puoi inserire questo parametro aggiuntivo per disabilitare la finestra di dialogo del keychain.

Esempio:

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -dsv -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

Visualizza il menu della Guida relativo alle opzioni della riga di comando.