Guida di Tableau Server su Windows

Puoi utilizzare i comandi tsm sites per esportare un sito esistente e importarlo in un nuovo sito (noti anche come migrazione del sito) e per importare il nuovo sito. Un comando unlock è disponibile nel caso in cui un errore lasci un sito bloccato.

I comandi tsm sites utilizzeranno l’archivio file locale per bloccare i dati di esportazione e importazione. Se è in esecuzione un cluster di Tableau con più nodi, devi eseguire i comandi tsm sites su un sistema Tableau Server nel quale è in esecuzione il processo Motore dati. Per informazioni sul processo Motore dati e sui processi che lo richiedono, consulta Processi di Tableau Server.

Nota: durante la migrazione di siti tra istanze di Tableau Server, il sito di destinazione deve trovarsi in una versione di Tableau Server uguale o successiva alla versione di Tableau Server per il sito di origine. Sia il sito di origine che quello di destinazione devono provenire da versioni supportate di Tableau Server.

Per i passaggi completi per la migrazione di un sito, vedi Esportare o importare un sito.

tsm sites export

Esporta un sito specifico di Tableau Server in un file .zip. Puoi esportare un sito per archiviarne le impostazioni in un momento specifico o per completare il primo passaggio del processo di migrazione del sito.

Nota: i comandi tsm sites import e tsm sites export possono lasciare un sito in uno stato bloccato se si verifica un errore. Per sbloccare un sito, utilizza il comando tsm sites unlock.

Riepilogo

tsm sites export --site-id <source-siteID> --file <export-file> [options] [global options]

Opzioni

-f,--file <file-esportazione>

Obbligatorio.

Specifica il nome del file in cui Tableau Server salva tutte le informazioni del sito.

Questo file viene generato nella directory definita nella variabile TSM basefilepath.site_export.exports. Per impostazione predefinita:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports

Per maggiori informazioni sui percorsi dei file e su come modificarli, consulta Percorsi dei file di tsm.

-id,--site-id <IDsito-origine>

Obbligatorio.

L’ID del sito che stai esportando. Puoi ottenere l’ID del sito dall’URL all’accesso al sito da un browser Web. Per informazioni sull’individuazione dell’ID del sito, vedi Preparare i siti di origine e di destinazione.

-ow,--overwrite

Facoltativo.

Sovrascrive un file di esportazione con lo stesso nome già esistente.

--request-timeout <timeout in secondi>

Facoltativo.

Attende il tempo specificato per il completamento del comando. Il valore predefinito è 43200 (720 minuti).

tsm sites import

Questo comando utilizza il file .zip creato utilizzando tsm sites export per generare un insieme di file .csv che mostrano come le impostazioni del sito di origine esportate verranno mappate al nuovo sito di destinazione.

Per impostazione predefinita, il file .zip viene generato e salvato nella directory siteexports in

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports

Prima di utilizzare questo comando, devi copiare il file .zip nella directory prevista da Tableau. Questo percorso è definito nella variabile TSM basefilepath.site_import.exports. Per impostazione predefinita, la directory di importazione è:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports

Per maggiori informazioni sui percorsi dei file e su come modificarli, consulta Percorsi dei file di tsm.

Nota: i comandi tsm sites import e tsm sites export possono lasciare un sito in uno stato bloccato se si verifica un errore. Per sbloccare un sito, utilizza il comando tsm sites unlock.

Riepilogo

tsm sites import --file <export-file.zip> --site-id <target-siteID> [options] [global options]

Opzioni

-f,--file <file-esportazione.zip>

Obbligatorio.

Nome del file .zip creato dal processo tsm sites export e che devi copiare nella directory di importazione. Per impostazione predefinita:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports

-id,--site-id <target-siteID>

Obbligatorio.

L’ID del nuovo sito di importazione (sito di destinazione). Per informazioni sull’individuazione dell’ID del sito, vedi Preparare i siti di origine e di destinazione.

-c,--continue-on-ignorable-errors

Facoltativo.

Continua l’importazione del sito se si verificano errori che possono essere ignorati. Questi errori possono indicare problemi relativi all’importazione di una cartella di lavoro o di un’origine dati di specifici.

-k,--no-verify

Facoltativo.

Salta la verifica dei file di mapping.

-m, --override-schedule-mapper <file-mapping.csv>

Facoltativo.

Pianifica il file di mapping per sovrascrivere il mapping normale per nome.

--request-timeout <timeout in secondi>

Facoltativo.

Attende il tempo specificato per il completamento del comando. Il valore predefinito è 7200 (120 minuti).

tsm sites import-verified

Specifica la directory che contiene i file di mapping con estensione .csv del sito esportato per importarli nel nuovo sito. Questo è il passaggio finale del processo di migrazione del sito.

Riepilogo

tsm sites import-verified --import-job-dir <importjob-directory> --site-id <target-siteID> [options] [global options]

Opzioni

-id,--site-id <target-siteID>

Obbligatorio.

L’ID del nuovo sito di importazione (sito di destinazione). Per informazioni sull’individuazione dell’ID del sito, vedi Preparare i siti di origine e di destinazione.

-w, --import-job-dir <directory-importjob>

Obbligatorio.

Il padre della directory mappings contenente i file .csv dal sito esportato (origine). Il nome di questa directory padre include l’ID di importazione insieme alla data e ora. Ad esempio:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_ff00_20180102022014457

--request-timeout <timeout in secondi>

Facoltativo.

Attende il tempo specificato per il completamento del comando. Il valore predefinito è 7200 (120 minuti).

tsm sites unlock

Utilizza questo comando per sbloccare un sito.

Opzioni

-id,--site-id <target-siteID>

Obbligatorio.

L’ID del sito da sbloccare. Per informazioni sull’individuazione dell’ID del sito, vedi Preparare i siti di origine e di destinazione.

-d, --desired-state <stato in cui lasciare sbloccato il sito>

Facoltativo.

Lo stato in cui il sito deve essere lasciato dopo che è stato sbloccato. Le opzioni sono “attivo” e “sospeso”. Se non specificato, il valore predefinito è “attivo”.

Ad esempio:

tsm sites unlock -id mysite -d suspended

--request-timeout <timeout in secondi>

Facoltativo.

Attende il tempo specificato per il completamento del comando. Il valore predefinito è 300 (5 minuti).

Opzioni globali

-h, --help

Facoltativo.

Mostra il comando guida.

-p, --password <password>

Obbligatorio, insieme a -u o --username se non è attiva nessuna sessione.

Specifica la password per l’utente specificato in -u o --username.

Se la password include spazi o caratteri speciali, inseriscila tra virgolette:

--password "my password"

-s, --server https://<hostname>:8850

Facoltativo.

Utilizza l’indirizzo specificato per Tableau Services Manager. L’URL deve iniziare con https, includere la porta 8850 e usare il nome del server, non l’indirizzo IP. Ad esempio, https://<tsm_hostname>:8850. Se non viene specificato nessun server, si presume https://<localhost | dnsname>:8850.

--trust-admin-controller-cert

Facoltativo.

Utilizza questo flag per considerare attendibile il certificato autofirmato nel controller TSM. Per ulteriori informazioni sull’attendibilità del certificato e le connessioni dell’interfaccia della riga di comando, consulta Connettere i client TSM.

-u, --username <utente>

Obbligatorio se non è attiva nessuna sessione, insieme a -p o --password.

Specifica un account utente. Se non includi questa opzione, il comando viene eseguito utilizzando le credenziali con cui hai effettuato l’accesso.