Guida di Tableau Prep

Supportato solo in Tableau Prep Builder.

Puoi eseguire il flusso dalla riga di comando per aggiornare l’output del flusso anziché eseguirlo da Tableau Prep Builder. Puoi eseguire un flusso alla volta utilizzando questo metodo. Questa opzione è disponibile su computer Windows e Mac in cui è installato Tableau Prep Builder.

Nota: se utilizzi la gestione delle licenze basata sull’accesso (LBLM), assicurati di aprire periodicamente Tableau Prep. In caso contrario, il lease può scadere, impedendo il completamento dei flussi eseguiti tramite la riga di comando. Puoi anche contattare l’amministratore per impostare la durata massima del lease. Per maggiori informazioni, consulta Gestione delle licenze basata sull’accesso(Il collegamento viene aperto in una nuova finestra).

Limitazioni dei connettori:

• Connettori JDBC o ODBC: i flussi che includono questi connettori possono essere eseguiti dalla riga di comando a partire dalla versione 2019.2.3.
• Connettori cloud: i flussi che includono connettori cloud come Google BigQuery non possono essere eseguiti dalla riga di comando. In alternativa, esegui il flusso manualmente o pianificalo in Tableau Server o Tableau Cloud utilizzando Tableau Prep Conductor. Per ulteriori informazioni, vedi Mantenere aggiornati i dati relativi ai flussi.
• Autenticazione Single Sign-On: l’esecuzione di flussi dalla riga di comando non è supportata se si utilizza l’autenticazione Single Sign-On. È invece possibile eseguire i flussi da Tableau Prep Builder.
• Autenticazione a più fattori: l’interfaccia a riga di comando di Tableau Prep non supporta Tableau con l’autenticazione a più fattori (MFA). Per maggiori informazioni, consulta questo articolo(Il collegamento viene aperto in una nuova finestra) nella Knowledge Base di Tableau.

Per i computer Windows è anche possibile pianificare questo processo utilizzando Utilità di pianificazione di Windows. Per ulteriori informazioni, consulta Utilità di pianificazione(Il collegamento viene aperto in una nuova finestra) nella guida online di Microsoft.

Quando esegui i flussi dalla riga di comando,Tableau Prep Builder aggiorna tutti gli output per il flusso utilizzando le impostazioni per i passaggi di output specificati in Tableau Prep Builder. Per informazioni su come specificare le posizioni di output, consulta Creare file di estrazione dati e origini dati pubblicate(Il collegamento viene aperto in una nuova finestra). Per informazioni sull’impostazione delle opzioni di scrittura (versione 2020.2.1 e successive), consulta Configurare le opzioni di scrittura.

Prima di eseguire il flusso

Per eseguire il flusso dalla riga di comando, sono necessari privilegi di amministratore nel computer in cui viene eseguito il flusso, oltre alle seguenti informazioni:

• Il percorso in cui è installato Tableau Prep Builder.

• Se ti connetti a database e pubblichi file di output in un server o un database (versione 2020.3.1 e successive), crea un file .json delle credenziali che include tutte le credenziali richieste.

• Il percorso in cui si trova il file di flusso di Tableau (.tfl).

Requisiti del file .json delle credenziali

Nota: le credenziali .json non sono richieste se il flusso si collega e invia l’output a file locali, file archiviati in una condivisione di rete o file di input che utilizzano l’autenticazione Windows (SSPI). Per ulteriori informazioni sull’autenticazione di Windows, consulta SSPI Model(Il collegamento viene aperto in una nuova finestra) nella guida online di Microsoft.

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. Ad esempio, il nome del database per le connessioni remote e il nome del progetto per i file di output provengono dal flusso, mentre il nome del server e le credenziali di accesso provengono dal file .json delle credenziali.

• Se pensi di riutilizzare il file, inseriscilo in una cartella in cui non verrà sovrascritto dal processo di installazione di Tableau Prep Builder.
• Se esegui un flusso che include uno dei seguenti elementi, devi includere un file .json che includa le credenziali necessarie per la connessione.
  • Si connette a file di database o origini dati pubblicate.
  • L’output viene pubblicato in un server o in un database (versione 2020.3.1 e successive).
  • Il flusso include passaggi di script per Rserve o TabPy. Il file .json deve includere le credenziali necessarie per connettersi a questi servizi. Per maggiori informazioni, fai riferimento ai requisiti della matrice per la tua versione di seguito.
• Le credenziali specificate nel flusso e le credenziali incluse nel file .json devono corrispondere. In caso contrario, il flusso non verrà eseguito.
• Quando si esegue il processo, il nome dell’host, la porta e il nome utente vengono utilizzati per trovare la connessione corrispondente nel file di flusso di Tableau (.tfl) e vengono aggiornati prima dell’esecuzione del processo. L’ID porta e l’ID sito sono opzionali se le connessioni non richiedono queste informazioni.

• Se esegui la connessione a un’origine dati pubblicata, includi nelle connessioni di input hostname, contentUrl e la porta (80 per http e 443 per https). Il parametro "hostname" è necessario per individuare la connessione corrispondente nel file di flusso di Tableau (.tfl), mentre il parametro contentUrl e la porta vengono utilizzati per stabilire la connessione al server.

• Se ti connetti a Tableau Cloud, includi la porta (80 o 443) nelle connessioni di input per il pod a cui ti stai connettendo e nell’URL delle connessioni del server assicurati di includere il prefisso del pod corrispondente insieme a online.tableau.com. Per maggiori informazioni su Tableau Cloud, consulta Connessioni di Tableau Bridge a Tableau Cloud(Il collegamento viene aperto in una nuova finestra) nella Guida di Tableau Cloud.
• (versione 2021.4.1 e successive) Se includi parametri nel flusso, puoi creare e includere un file .json di override dei parametri nella riga di comando per modificare i valori dei parametri rispetto ai valori predefiniti correnti. Per maggiori informazioni, consulta Eseguire flussi che includono valori di parametri.

A seconda della versione di Tableau Prep Builder in uso, le informazioni sulle credenziali potrebbero essere formattate in modo diverso. Fai clic sulla scheda seguente per visualizzare il formato delle credenziali per la versione di Tableau Prep Builder in uso.

{
    "Parameter 1": Value 1,
    "Number Parameter": 40,
    "Boolean Parameter": True
}				

 "\[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

/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

{
 "tableauServerConnections":[
   {
    "serverUrl":"https://my.server",
    "contentUrl": "mysite",
    "port":443,
    "username": "jsmith",
    "password": "passw0rd$"
   }
 ]
}				

{
 "tableauServerConnections":[
   {
    "serverUrl":"https://my.server",
    "contentUrl": "mysite",
    "port":443,
    "username": "jsmith",
    "password": "passw0rd$"
   }
],
 "databaseConnections":[
   {
    "hostname":"example123.redshift.amazonaws.com",
    "port":"5439",
    "username":"jsmith",
    "password":"p@s$w0rd!"
   }
 ]
}

{
 "extensions": [
    {
	  "extensionName": "rSupport",
	  "regular": {
		"host": "localhost",
		"port": "9000",
		"username": "jsmith"
	},
	"sensitive": {	
	  "password": "pwd"	
	}
   },
   {
	"extensionName": "pythonSupport",
	"regular": {
	  "host": "localhost",
	  "port": "9000"
	},
	"sensitive": {
	}
   }
 ],										
 "databaseConnections":[
   {
    "hostname":"example123.redshift.amazonaws.com",
    "port": "5439",
    "username": "jsmith",
    "password": "p@s$w0rd!"
   },
   {
    "hostname":"mysql.mydb.tsi.lan",
    "port": "3306",
    "username": "jsmith",
    "password": "mspa$$w0rd"
   }
 ]
}			

{
 "databaseConnections":[
{
  "hostname":"example123.redshift.amazonaws.com",
  "port": "5439",
  "username": "jsmith",
  "password": "p@s$w0rd!"
 },
 {
   "hostname":"mysql.mydb.tsi.lan",
   "port": "3306",
   "username": "jsmith",
   "password": "mspa$$w0rd"
  }
 ]
}			

{ 
  "inputConnections":[
    {
     "hostname":"https://my.server",
     "contentUrl": "mysite",
     "port":443,								
     "username": "jsmith",
     "password": "passw0rd$"
    }
 ],
  "outputConnections":[
    {
     "serverUrl":"https://my.server",
     "contentUrl":"mysite",
     "username":"jsmith",
     "password":"passw0rd$"
    }
 ]
}

{ 
  "inputConnections":[
    {
     "hostname":"mysql.example.lan",
     "port":1234,
     "username": "jsmith",				
     "password": "passw0rd"
  },
    {
     "hostname":"Oracle.example.lan",
     "port":5678,
     "username": "jsmith",				
     "password": "passw0rd" 
  }
], 
  "outputConnections":[
    {
     "serverUrl":"http://my.server",
     "contentUrl":"mysite",
     "username":"jsmith",
     "password":"passw0rd$"
    } 
  ]
}

{ 
  "inputConnections":[
    {
     "hostname":"mysql.example.lan",
     "port":1234,
     "username": "jsmith",				
     "password": "passw0rd"
  }
], 
  "extensions":[
    {
     "extensionName":"rSupport",
     "credentials":{
     "password":"pwd",
    }
  },
   {
	"extensionName" : "pythonSupport",
	"credentials": {
	"password": "pwd"
	}
   } 
  ]
}

Suggerimenti per la creazione del file delle credenziali

Per evitare errori durante l’esecuzione del flusso, assicurati che il file delle credenziali segua queste linee guida:

• Se utilizzi Tableau Prep Builder dalla versione 2018.2.2 alla 2018.3.1, includi sempre gli array "inputConnections" e "outputConnections", anche se il flusso non dispone di connessioni remote per gli input o gli output. Lascia vuote tali matrici.

  Se utilizzi Tableau Prep Builder dalla versione 2018.3.2 e successive, non è necessario includere la matrice vuota.

  • Nessuna connessione di input remota? Includi questa sintassi nella parte superiore del file .json

    {
     "inputConnections":[
      ],

  • Nessuna connessione di output remota? Includi questa sintassi nella parte inferiore del file .json

  "outputConnections":[
    ]
  }

• Nessun ID porta per la connessione di input o la porta è specificata come parte del nome del server.

  Se non è presente alcun ID porta per la connessione, non includere il riferimento "port":xxxx, nel file .json, né "port": "". Se l’ID porta è incluso nel nome del server, includi l’ID porta nel nome host. Ad esempio: "hostname": "mssql.example.lan,1234"

• Quando fai riferimento a "serverUrl":, non includere "/" alla fine dell’indirizzo. Ad esempio, utilizza "serverUrl": "http://server" e non "serverUrl": "http://server/".

• Se si hanno più connessioni di input o di output, è necessario includere le credenziali per ciascuna di esse nel file.

• Se stai effettuando la connessione a delle origini dati pubblicate, assicurati di includere i parametri "hostname" e "contentUrl" nelle connessioni di input.

Esegui il flusso

Importante: gli esempi seguenti includono la modifica del nome per "Tableau Prep" versione 2019.1.2 in "Tableau Prep Builder". Se utilizzi una versione precedente del prodotto, utilizza invece "Tableau Prep".

1. Apri il prompt dei comandi o il prompt dei comandi del terminale (MacOS) come amministratore.

2. Esegui uno di questi comandi utilizzando la sintassi illustrata di seguito.

   • Il flusso si collega a file locali o file archiviati in una condivisione di rete e pubblica in file locali, file archiviati in una condivisione di rete o utilizza l’autenticazione Windows:

     Nota: se ci si connette a file archiviati in una condivisione di rete o si producono output in tali file, è necessario utilizzare il formato UNC per il percorso: \\server\path\file name. Non può essere protetto da password.

     Windows

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

     Mac

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

   • Il flusso si collega a database o pubblica in un server:

     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"

     Mac

     /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

   • Il file di flusso o il file delle credenziali è archiviato in una condivisione di rete (usa il formato UNC per il percorso: \\server\path\file name):

     Windows

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

     Mac: associa la condivisione di rete a /Volumes nel Finder in modo che sia persistente, quindi utilizza /Volumes/.../[your file] per specificare il percorso:

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

Per gli errori comuni e le risoluzioni, consulta Errori comuni quando si usa la riga di comando per eseguire i flussi.

Eseguire il flusso con l’aggiornamento incrementale abilitato

Supportato in Tableau Prep Builder versione 2020.2.1 e successive e sul Web nella versione 2020.4. L’aggiornamento incrementale non è attualmente supportato durante la scrittura dell’output di flusso in Microsoft Excel.

Se Tableau Prep Conductor non è abilitato nel server per la pianificazione delle esecuzioni del flusso, puoi eseguire il flusso utilizzando l’aggiornamento incrementale dalla riga di comando. È sufficiente includere il parametro --incrementalRefresh nella riga di comando come illustrato nell’esempio seguente.

Windows

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

Mac

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

Se nei passaggi di input del flusso è abilitato l’aggiornamento incrementale e i parametri di aggiornamento incrementale sono configurati correttamente, Tableau Prep Builder eseguirà queste operazioni:

• Tutti gli input del flusso in cui è abilitato l’aggiornamento incrementale eseguiranno tutti gli output corrispondenti utilizzando l’aggiornamento incrementale.
• Se l’aggiornamento incrementale non è abilitato per alcun input del flusso, tutti gli output verranno eseguiti utilizzando l’aggiornamento completo. Verrà visualizzato un messaggio con i dettagli relativi al metodo di aggiornamento.
• Se l’aggiornamento incrementale è abilitato per alcuni input nel flusso, gli output corrispondenti verranno eseguiti utilizzando l’aggiornamento incrementale. Gli altri output verranno eseguiti utilizzando l’aggiornamento completo e verrà visualizzato un messaggio con i dettagli relativi al metodo di aggiornamento.

Per maggiori informazioni sulla configurazione dei flussi per l’utilizzo dell’aggiornamento incrementale, consulta Aggiornare i dati del flusso tramite l’aggiornamento incrementale

Opzioni di comando

Se desideri visualizzare le opzioni di aiuto, includi -h nella riga di comando.

usage: tableau-prep-cli [-c <arg>] [-d]  [-h] [-t <arg>]

-c,--connections <arg>        Path to a file with all connection information

-d,--debug                    This option is for debugging

-dsv,--disableSslValidation   Disable SSL validation

-h,--help                     Print usage message

-inc,--incrementalRefresh     Run incremental refresh for all outputs that are configured to support it

-t,--tflFile <arg>            The Tableau Prep Builder flow file	

Esempi di sintassi

Le righe di comando riportate di seguito mostrano quattro diversi esempi di esecuzione di un flusso utilizzando i seguenti criteri:

• Versione di Tableau Prep Builder: 2022.1.1

  Importante: gli esempi seguenti includono la modifica del nome per Tableau Prep versione 2019.1.2 in Tableau Prep Builder. Se utilizzi una versione precedente del prodotto, utilizza invece "Tableau Prep".

• Nome di flusso: Flow1.tfl

• Posizione del flusso: C:\Users\mrossi\Documents\My Tableau Prep Builder Repository\Flows

• Nome del file di credenziali: Flow 1.json

• Posizione del file delle credenziali: C:\Users\mrossi\Desktop\Flow credentials

• Posizione del file delle credenziali archiviato in una condivisione di rete: \tsi.lan\files\Flow credentials

Il flusso si collega a file locali e pubblica in questi file

Windows

"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"

Mac

/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl

Il flusso si collega a file locali e pubblica in questi file utilizzando la forma abbreviata per l’aggiornamento incrementale

Windows

"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -inc -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"

Mac

/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -inc -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl

Il flusso si collega a database e pubblica in un server

Windows

"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -c "\C:\Users\jsmith\Desktop\Flow credentials\Flow1.json" -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"

Mac

/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -c /Users/jsmith/Desktop/Flow\ credentials/Flow1.json -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl

Il flusso pubblica in un server e il file delle credenziali viene archiviato in una condivisione di rete

Windows

"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -c "\\tsi.lan\files\Flow credentials\Flow1.json" -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"

Mac

/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -c /Volumes/files/Flow\ credentials/Flow1.json -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl