---
schema_version: "1"
id: ccf6419b8ca40fcae307dcd23074a6955ace2dfaa55d694e31789df72f78a19d
title: Utilità a riga di comando per l’estrazione di dati di Tableau
collection: tableau
version: current
locale: it-it
portal_url: https://docs.salesforce.com/tableau/current/it-it/pro/desktop/extracting_TDE.md
canonical_url: https://help.tableau.com/current/pro/desktop/it-it/extracting_TDE.htm
source_site: help.tableau.com
content_type: documentation
content_hash: b441a24de48accb965fe74258c069bf8d7e8a36fa679ad1a26e8ef77100c1585
description: Automate extract refresh tasks using the Tableau Data Extract Command-Line Utility.
---
[Passa al contenuto principale](#main-content)

# Utilità a riga di comando per l’estrazione di dati di Tableau

Puoi automatizzare le attività di aggiornamento dell'estrazione utilizzando Tableau Data Extract Command-Line Utility. Si tratta di un’utilità della riga di comando fornita con Tableau Desktop, che ti consente di aggiornare origini dati di estrazioni pubblicate o aggiungervi dati da un file.

I requisiti per l’utilizzo di Tableau Data Extract Command-Line Utility includono quanto segue:

- È disponibile con Tableau Desktop su Windows e può essere eseguito solo su un sistema Windows.
- Non è disponibile con la versione di prova di Tableau Desktop.
- Puoi usarlo per l’estrazione di origine dati che non usano OAuth.
- Puoi usarlo per aggiornare solo l’origine dati a connessione singola. Non funziona per origine dati multiconnessione.

**Deprecato a ottobre 2022:** questa utilità non è disponibile nelle versioni successive a causa del requisito per l’[autenticazione a più fattori](https://help.tableau.com/current/online/it-it/to_security_mfa.htm) in Tableau Cloud. Per aggiornare i dati di origini dati o connessioni virtuali che Tableau Cloud non può raggiungere direttamente, utilizza Tableau Bridge. Per maggiori informazioni, consulta [Impostare una pianificazione di aggiornamento di Bridge](https://help.tableau.com/current/online/it-it/to_sync_schedule.htm).  
  
Per avviare processi di aggiornamento con uno script, utilizza tabcmd [refreshextracts](https://help.tableau.com/current/server/it-it/tabcmd_cmd.htm#refreshextracts-workbookname-or-datasourcename) o l’attività [Esegui aggiornamento estrazione](https://help.tableau.com/current/api/rest_api/it-it/REST/rest_api_ref.htm#run_extract_refresh_task) dell’API REST.

## Esegui l’utilità

1. Apri il prompt dei comandi come amministratore e passa alla directory bin di Tableau Desktop. Ad esempio:
    
    `cd C:\Program Files\Tableau\Tableau 2022.4\bin`
2. Utilizzare uno dei seguenti comandi, aggiungendo i parametri descritti nelle tabelle seguenti.
    
    - `tableau refreshextract`
    - `tableau addfiletoextract`

**Nota:** quando si utilizza l’utilità, specificare sempre `tableau` sulla riga di comando o negli script, mai in `tableau.exe`.

**Nota:** per la risoluzione dei problemi, controlla i log nel file tableaucom.txt nella cartella \\Repository personale di Tableau\\Logs.

**Nota:** in un ambiente a più siti, specifica il sito a cui si applica il comando.

## Sintassi e parametri per il comando refreshextract di tableau

Utilizzare `tableau refreshextract` per aggiornare un’estrazione su Tableau Server o Tableau Cloud. Aggiornare un’estrazione aggiorna un’estrazione esistente con tutte le modifiche apportate all’origine dati dall’ultimo aggiornamento.

Per consultare la guida per questo comando, digita il seguente comando nel prompt dei comandi di Windows:

`tableau help refreshextract`

### Uso dei parametri

- Tutte le opzioni hanno una forma completa che usi con due trattini (ad esempio, `--server`).
- Alcune opzioni hanno anche una forma abbreviata che usi con un trattino singolo (ad esempio,`-s`).
- Se il valore di un’opzione contiene spazi, racchiudilo tra virgolette.
- L’origine che viene aggiornata deve essere quella originale, non un’estrazione (`.hyper`).

### opzioni del comando refreshextract di tableau

<table><colgroup><col style="width: 25%;"><col style="width: 30%;"><col style="width: 45%;"></colgroup><tbody><tr><td><b>Forma abbreviata</b></td><td><b>Forma completa</b></td><td><b>Descrizione</b></td></tr><tr><td>&nbsp;</td><td><code>--source-username &lt;user name&gt;</code></td><td><p>Un nome utente valido per la connessione all’origine dati.</p><p>Utilizzare questa opzione con <code>--source-password</code>, o utilizzare</p><p><code>--original-file</code> invece delle opzioni nome utente e password.</p><p class="note"><b>Nota</b>: devi fornire il nome utente e la password quando si aggiorna un’estrazione pubblicata, anche se l’origine dati è stata originariamente pubblicata con credenziali incorporate.</p></td></tr><tr><td>&nbsp;</td><td><code>--source-password "&lt;password&gt;"</code></td><td><p>La password per l’utente dell’origine dati.</p></td></tr><tr><td>&nbsp;</td><td><p><code>--original-file &lt;path and file name&gt;</code></p><p>oppure</p><p><code>--original-file&nbsp;&lt;path and folder name&gt;</code></p></td><td><p>Percorso e nome del file dell’origine dati da aggiornare sul server. Ad esempio: <code>--original-file c:\folder\file.csv</code></p><p>Per aggiornare un’origine dati multi-file, passare il percorso a una cartella che contiene i file di dati. Ad esempio: <code>--original-file c:\folder</code>.</p><p>Se il file è su una condivisione di rete, utilizzare il formato UNC per il percorso: <code>\\server\path\filename.csv</code></p></td></tr><tr><td>&nbsp;</td><td><code>--force-full-refresh</code></td><td><p>Se l’origine dati è impostata per aggiornamenti incrementali, utilizzare questa opzione per forzare un aggiornamento completo dell’estrazione. Se questa opzione non è inclusa, verrà eseguito un aggiornamento incrementale. Non tutte le origini dati supportano l’aggiornamento incrementale.</p></td></tr><tr><td><code>-s &lt;server http address&gt;</code></td><td><code>--server  &lt;URL&gt;</code></td><td><p>L’URL di Tableau Server su cui vengono pubblicati i dati.</p><p>Per Tableau Cloud, specifica <code>https://online.tableau.com</code>.</p></td></tr><tr><td><code>-t &lt;site id&gt;</code></td><td><code>--site &lt;siteid&gt;</code></td><td><p>In un ambiente a più siti, specifica il sito a cui si applica il comando. Per Tableau Cloud, usa questo argomento se il nome utente è associato a più di un sito. Per Tableau Server, se non specifichi un sito, si assume il sito predefinito.</p><p>L’id del sito è indipendente dal nome del sito e viene indicato nell’URL quando visualizzi il sito in un browser. Ad esempio, se l’URL della pagina che appare dopo l’accesso a Tableau Cloud è</p><pre xml:space="preserve">https://online.tableau.com/t/vernazza/views</pre><p>L’id del sito è <i>vernazza</i>.</p></td></tr><tr><td>&nbsp;</td><td><code>--datasource &lt;datasource&gt;</code></td><td><p>Il nome dell’origine dati, come pubblicato su Tableau Server o Tableau Cloud.</p></td></tr><tr><td>&nbsp;</td><td><code>--project &lt;projectname&gt;</code></td><td><p>Il progetto a cui appartiene l’origine dati. Se questa opzione non è inclusa, si assume il progetto predefinito.</p><p>Se il progetto che desideri specificare è un progetto figlio annidato all’interno di una gerarchia di progetto, è necessario utilizzare questo parametro insieme al parametro <code>--parent-project-path</code>.</p></td></tr><tr><td>&nbsp;</td><td><code>--parent-project-path path/to/project</code></td><td><p>Se un progetto su cui viene pubblicata l’origine dati non si trova al livello superiore di una gerarchia di progetto, utilizza questo parametro insieme al parametro <code>--project</code> per specificare il percorso a un progetto annidato.</p><p>Utilizza il carattere barra&nbsp;(<code>/</code>) per delimitare i livelli di progetto nella gerarchia. Utilizza il carattere barra rovesciata (<code>\</code>) per evitare le istanze dei caratteri barra e barra rovesciata nei nomi di progetto.</p><p>Ad esempio, per un progetto chiamato Sandbox, nel progetto Social, sotto Marketing, di livello superiore:</p><p><code>--project Sandbox --parent-project-path Marketing/Social</code></p></td></tr><tr><td><code>-u &lt;user name&gt;</code></td><td><code>--username &lt;username&gt;</code></td><td><p>Utente valido di Tableau Server o Tableau Cloud.</p></td></tr><tr><td><code>-p "&lt;password&gt;"</code></td><td><code>--password  "&lt;password&gt;"</code></td><td><p>La password per l’utente Tableau Server o Tableau Cloud specificato.</p></td></tr><tr><td>&nbsp;</td><td><code>--proxy-username &lt;username&gt;</code></td><td><p>Il nome utente di un server proxy.</p></td></tr><tr><td>&nbsp;</td><td><code>--proxy-password "&lt;password&gt;"</code></td><td><p>La password di un server proxy.</p></td></tr><tr><td><code>-c "&lt;path and file name&gt;"</code></td><td><code>--config-file  "&lt;path and file name&gt;"</code></td><td><p>Informazioni sul percorso e sul nome file per un file che contiene le opzioni di configurazione del comando. Inserisci sempre il percorso tra virgolette doppie. Per ulteriori informazioni, consulta <a href="#Using" class="xref">Utilizzo di un file di configurazione</a> di seguito.</p></td></tr></tbody></table>

### Esempio del comando refreshextract di Tableau

Il seguente comando aggiorna un’estrazione denominata CurrentYrOverYrOverYrStats che è stata pubblicata su Tableau Server on-premises. Questo comando specifica quanto segue:

- Il nome dell’istanza di Tableau Server.
- Nome utente e password del server.
- Nome del progetto.
- Il nome dell’origine dati da aggiornare, insieme al nome utente e alla password dell’origine dati.

`C:\Program Files\Tableau\Tableau 2022.4\bin>tableau refreshextract --server https://our_server_name --username OurServerSignIn --password "OurServerPwd" --project "New Animations" --datasource "CurrentYrOverYrStats" --source-username OurDatabaseSignIn --source-password "OurDatabasePassword"   `

Il seguente comando aggiorna un’estrazione denominata CurrentYrOverYrOverYrStats che è stata pubblicata su Tableau Cloud. Questo comando specifica quanto segue:

- Utente e password di Tableau Cloud.
- Sito di Tableau Cloud e nomi dei progetti.
- L’origine dati, che in questo caso è ospitata da un fornitore di origine dati basato su cloud (ad esempio, Salesforce.com), e il nome utente e la password per accedere all’origine dati ospitata.

`C:\Program Files\Tableau\Tableau 2022.4\bin>tableau refreshextract --server https://online.tableau.com --username email@domain.com --password "OurServerPwd" --site vernazza --project "New Animations" --datasource "CurrentYrOverYrStats" --source-username database_user@hosted_datasource_provider.com --source-password "db_password"`

Per aggiornare un’estrazione dell’origine dati basata su file, fornire il percorso del file originale da cui è stato creata l’estrazione. Se il file è su una condivisione di rete, utilizzare il formato UNC invece di un drive mappato:

`C:\Program Files\Tableau\Tableau 2022.4\bin>tableau refreshextract --server https://online.tableau.com --username email@domain.com --password "OurServerPwd" --site vernazza --project "New Animations" --datasource "CurrentYrOverYrStats" --original-file "\\server\path\filename.csv"`

## Sintassi per tableau addfiletoextract

Usa `tableau addfiletoextract` per aggiungere il contenuto del file a un’estrazione pubblicata su Tableau Server o Tableau Cloud. Questo comando combina i due file.

Se desideri semplicemente aggiornare un’estrazione esistente con le ultime modifiche, utilizzare invece il comando `refreshextract`. Utilizzando `addfiletoextract` per aggiornare un’estrazione esistente, invece, i dati verranno duplicati.

Per consultare la guida per questo comando, digita il seguente comando nel prompt dei comandi di Windows:

`tableau help addfiletoextract`

Tutte le opzioni hanno una forma completa che usi con due trattini (ad esempio, `--server`). Alcune opzioni hanno anche una forma abbreviata che usi con un trattino singolo (ad esempio,`-s`). Se il valore di un’opzione contiene spazi, racchiudilo tra virgolette.

### opzioni del comando addfiletoextract di tableau

<table><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Forma abbreviata</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Forma completa</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>Descrizione</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--file &lt;path and file name&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Informazioni sul percorso e sul nome del file di dati contenente i dati da aggiungere. Il file può essere da Excel, Access, da un’estrazione di dati di Tableau o da un file di testo delimitato. Non può essere protetto da password. Usa il formato UNC se il file si trova su una condivisione di rete. Ad esempio, <code>\\server\path\filename.csv</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>-s &lt;server http address&gt;</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--server  &lt;URL&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>L’URL di Tableau Server su cui vengono pubblicati i dati.</p><p>Per Tableau Cloud, specifica <code>https://online.tableau.com</code>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>-t &lt;site id&gt;</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--site &lt;site id&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>In un ambiente a più siti, specifica il sito a cui si applica il comando. Per Tableau Cloud, devi includere questo argomento se il nome utente è associato a più di un sito. Per Tableau Server, se non specifichi un sito, si assume il sito predefinito.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--datasource &lt;datasource&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Il nome dell’origine dati, come pubblicato su Tableau Server o Tableau Cloud.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--project &lt;projectname&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Il progetto a cui appartiene l’origine dati. Se questa opzione non è inclusa, si assume il progetto predefinito.</p><p>Se il progetto che desideri specificare è un progetto figlio annidato all’interno di una gerarchia di progetto, è necessario utilizzare questo parametro insieme al parametro <code>--parent-project-path</code>.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--parent-project-path path/to/project</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Se un progetto su cui viene pubblicata l’origine dati non si trova al livello superiore di una gerarchia di progetto, utilizza questo parametro insieme al parametro <code>--project</code> per specificare il percorso a un progetto annidato.</p><p>Utilizza il carattere barra&nbsp;(<code>/</code>) per delimitare i livelli di progetto nella gerarchia. Utilizza il carattere barra rovesciata (<code>\</code>) per evitare le istanze dei caratteri barra e barra rovesciata nei nomi di progetto.</p><p>Ad esempio, per un progetto chiamato Sandbox, nel progetto Social, sotto Marketing, di livello superiore:</p><p><code>--project Sandbox --parent-project-path Marketing/Social</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>-u &lt;username&gt;</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--username &lt;username&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Utente valido di Tableau Server o Tableau Cloud.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>-p "&lt;password&gt;"</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--password  "&lt;password&gt;"</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>La password per l’utente Tableau Server o Tableau Cloud specificato.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--proxy-username &lt;username&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Il nome utente di un server proxy.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--proxy-password "&lt;password&gt;"</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>La password di un server proxy.</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>-c "&lt;path and filename&gt;"</code></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>--config-file "&lt;path and filename&gt;"</code></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>Informazioni sul percorso e sul nome file per un file che contiene le opzioni di configurazione del comando. Inserisci sempre il percorso tra virgolette doppie. Per ulteriori informazioni, consulta <a href="#Using" class="xref">Utilizzo di un file di configurazione</a> di seguito.</p></td></tr></tbody></table>

### Esempio del comando addfiletoextract di Tableau

`C:\Program Files\Tableau\Tableau 2022.4\bin>tableau addfiletoextract --server https://our_server_name --username OurServerSignIn --password "OurServerPwd" --project "New Animations" --datasource "CurrentYrOverYrStats" --file "C:\Users\user1\Documents\DataUploadFiles\AprMay.csv"`

`C:\Program Files\Tableau\Tableau 2022.4\bin>tableau addfiletoextract --server https://online.tableau.com --username email@domain.com --password "OurServerPwd" --site vernazza --project "New Animations" --datasource "CurrentYrOverYrStats" --file "C:\Users\user2\Documents\DataUploadFiles\AprMay.csv"`

## Utilizzo di un file di configurazione

Puoi utilizzare un editor di testo semplice, come Notepad o Text Edit, per creare un file di configurazione che può essere utilizzato con `tableau refreshextract` o `tableau addfiletoextract`. Un file di configurazione può essere utile se prevedi di aggiornare regolarmente la stessa origine dati nel tempo. Invece di dover digitare le stesse opzioni ogni volta che esegui un comando, specifichi il file di configurazione. Un file di configurazione ha anche il vantaggio di non esporre nomi utente e password sulla riga di comando.

### Creare il file di configurazione

Ad esempio, diciamo che hai creato un file chiamato config.txt e l’hai salvato nella cartella Documenti. E nel file sono state incluse le informazioni sui parametri mostrate di seguito.

Per un’estrazione pubblicata su Tableau Server:

`server=https://our_server_name   username=OurServerSignIn   password=OurServerPwd   project=New Animations   datasource=CurrentYrOverYrStats`

Per un’estrazione da un’origine dati ospitata, pubblicata su Tableau Cloud, dove il **server** si trova **https://online.tableau.com**:

`server=https://online.tableau.com   site=vernazza   username=email@domain.com   password=OurPassword   project=New Animations   datasource=CurrentYrOverYrStats   source-username=database_user@hosted_datasource_provider.com   source-password=db_password`

### Fai riferimento al file di configurazione dalla riga di comando

Dopo aver creato il file di configurazione, esegui il comando `tableau refreshextract` o il comando `tableau addfiletoextract`, indicando il file di configurazione come unica opzione utilizzata nella riga di comando e racchiudendo il percorso del file di configurazione tra virgolette doppie. La sintassi è la seguente:

`tableau refreshextract --config-file "<path>"`

Ad esempio, per aggiornare l’estrazione specificata nell’esempio nella sezione [Creare il file di configurazione](#Create), devi eseguire il seguente comando (assicurandoti di utilizzare la directory bin relativa alla tua versione di Tableau Desktop):

`C:\Program Files\Tableau\Tableau 2022.4\bin>tableau refreshextract --config-file "C:\Users\user1\Documents\config.txt"`

### Differenze di sintassi per i file di configurazione

La sintassi per specificare le opzioni all’interno di un file di configurazione differisce da quella usata sulla riga di comando nei seguenti modi:

- I nomi delle opzioni non iniziano con linee o trattini.
- Si usa un segno di uguale (senza spazi) per separare i nomi delle opzioni dai valori delle opzioni.
- Le virgolette non sono necessarie (o consentite) intorno ai valori, anche quando includono spazi (come per l’opzione `project` nell’esempio mostrato in precedenza).

## Usa l’utilità di pianificazione di Windows per aggiornare le estrazioni

Puoi utilizzare l’utilità di pianificazione di Windows, in combinazione con Tableau Data Extract Command-Line Utility, per automatizzare gli aggiornamenti regolari dell’Tableau Desktoporigine dati all’interno del firewall. Puoi configurare che un’attività si verifichi una volta al giorno, alla settimana, al mese o dopo un evento di sistema specifico. Ad esempio, eseguire l’attività all’avvio del computer.

Per ulteriori informazioni, vedi la pagina [Task Scheduler How To...](http://technet.microsoft.com/en-us/library/cc766428.aspx) nella libreria di Microsoft TechNet.