---
schema_version: "1"
id: 11a3f86573d6c1f3a065dcc7ce79aa2f6b41a7f75e4b8e724ff1944bf4a4cdc1
title: Modificare le impostazioni del client Bridge
collection: tableau
version: next
locale: it-it
portal_url: https://docs.salesforce.com/tableau/next/it-it/online/to_sync_change_computer_site.md
canonical_url: https://help.tableau.com/v0.0/online/it-it/to_sync_change_computer_site.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 49fd1c57aec11ec5f5b0a39dcd2ae854fab0b0bee04fb7ef9af7acafc700a4bb
description: Change Tableau Bridge client settings using the configuration file.
---
[Passa al contenuto principale](#main-content)

# Modificare le impostazioni del client Bridge

Esistono diverse impostazioni del client Bridge che l’amministratore del sito può configurare per modificare la modalità di esecuzione di un client.

## Client Windows

Per i client Windows, il percorso predefinito del file di configurazione è `C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt`.È necessario riavviare il client per rendere effettive le modifiche apportate al file di configurazione.

## Bridge per Linux per contenitori

Il file `TabBridgeClientConfiguration.txt` viene generato con le configurazioni predefinite la prima volta che esegui il client Bridge.

Per apportare modifiche alle impostazioni di configurazione, modifica il file `TabBridgeClientConfiguration.txt` e crea un nuovo contenitore Docker con il file aggiornato.Per maggiori informazioni su come creare e aggiornare un contenitore, consulta [Inserire un’applicazione in un contenitore](https://docs.docker.com/get-started/02_our_app/) (in inglese).

## Pianificazioni Bridge legacy

In alcuni casi, il proprietario di un’origine dati potrebbe essere responsabile di alcune delle attività descritte in questo argomento se gestisce il proprio client per eseguire le pianificazioni Bridge legacy.

## Impostazioni del client Bridge

### serviceConnectionSettings

Configurazione: `serviceConnectionSettings`

Opzioni:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>serviceUrl</code></td><td>URL del sito Tableau.<p><i>Non configurabile</i>.</p></td></tr><tr><td><code>proxyServer</code></td><td>Server proxy e porta.<p><i>Configurabile</i></p></td></tr></tbody></table>

#### Esempio

È necessario riavviare il client per rendere effettive le modifiche apportate al file di configurazione.

```
"serviceConnectionSettings" : {
	"serviceUrl" : "https://online.tableau.com",
	"proxyServer" : {
	"serverName" : "http://localhost",
	"serverPort" : 8888
	}
```

### connection

Configurazione: `connection`

Opzioni:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>connectTimeout</code></td><td>Tempo di attesa del client Bridge durante il tentativo di connessione a Tableau Cloud.<p>Valore predefinito: 1 minuto</p><p><i>Configurabile.</i></p></td></tr><tr><td><code>operationTimeout</code></td><td>Tempo di attesa del client Bridge per ogni chiamata API al server (come VizPortal) dopo aver eseguito correttamente la connessione a Tableau Cloud.<p>Valore predefinito: 15 minuti</p><p><i>Configurabile</i>.</p></td></tr><tr><td><code>maxAttemptsToRedirectHttpRequests</code></td><td>Una chiamata API a un server può essere reindirizzata da POD a POD.Questo numero specifica il numero massimo di reindirizzamenti per chiamata API al server.Valore predefinito: 20<p><i>Configurabile</i>.</p></td></tr></tbody></table>

#### Esempio

```
"connection" : {
	"connectTimeout" : "00:01:00",
	"operationTimeout" : "00:15:00",
	"maxAttemptsToRedirectHttpRequests" : 20
	}
```

### dataSourceRefreshSettings

Configurazione: `dataSourceRefreshSettings`

Opzioni:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>shutdownTimeoutInSeconds</code></td><td><i>Non configurabile</i>.</td></tr><tr><td><code>downloadDataSourcesInterval</code></td><td>Intervallo di tempo per il download temporaneo dei nomi delle origini dati live e delle origini dati di estrazione assegnate al client per le pianificazioni Bridge legacy.<p>Valore predefinito: 30 minuti.<br></p><p><i>Configurabile</i>.<br></p></td></tr><tr><td><code>checkRefreshDataSourcesInterval</code></td><td>Intervallo di tempo necessario al client Bridge per controllare le origini dati assegnate al client e stabilire se è necessario un aggiornamento per le pianificazioni Bridge legacy.<p>Valore predefinito: 5 secondi</p><p><i>Configurabile</i>.</p></td></tr><tr><td><code>extractRefreshTimeout</code></td><td>Applica un limite di tempo per gli aggiornamenti eseguiti dal client.Il limite di timeout è il tempo massimo per il completamento di un’unica estrazione prima che venga annullata dal client.Se l’aggiornamento di un’estrazione viene annullato in seguito al raggiungimento del limite di timeout, verrà visualizzato un messaggio nel client e il proprietario dell’origine dati riceverà un avviso e-mail.<p>Valore predefinito: 24 ore.</p><p>Per le connessioni virtuali, il limite di timeout predefinito per l’aggiornamento delle estrazioni è di due ore ed è controllato da Tableau Cloud. Il limite di tempo non può essere controllato dal client Bridge.</p><p><i>Configurabile</i>.</p></td></tr><tr><td><code>maxRemoteJobConcurrency</code></td><td>Specifica il numero massimo di processi di aggiornamento remoto simultanei (estrazioni PDS) consentiti per un singolo client.<p>Valore predefinito: 10</p><p>Minimo: 1</p><p>Massimo: 90</p><p><i>Configurabile</i>.</p><p>Per applicare questa impostazione:</p><ol><li value="1"><p>Scollega il client.</p></li><li value="2"><p>Ricollega il client ed esegui l’accesso.</p></li><li value="3"><p>Assegna il client a un pool denominato.</p></li></ol><p><b>Nota:</b> per gli utenti Windows, se dopo aver modificato questa impostazione l’applicazione visualizza un messaggio di errore fuorviante che richiede un’azione diversa, cancella manualmente le credenziali di Bridge dall’Archiviazione sicura di Windows.</p></td></tr><tr><td><code>JSONLogForExtractRefresh</code></td><td>Se impostata su true, il client genera un file di log aggiuntivo in formato JSON.Il log acquisisce le metriche degli aggiornamenti delle estrazioni, sia per gli aggiornamenti Bridge legacy che remoti, con una riga per estrazione.<p>Il formato del file di log JSON è leggibile da <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> e può essere utilizzato come origine dati per creare visualizzazioni live.Per maggiori informazioni, consulta <a href="https://help.tableau.com/current/pro/desktop/it-it/examples_json.htm">File JSON</a>.</p><p>Un esempio del file di log è: <code>
							ExtractRefreshMetrics_&lt;timestamp&gt;.json</code><br>La modifica del valore di questa opzione di configurazione richiede il riavvio del client Bridge.</p><p>Le opzioni di configurazione di <code>loggerSettings </code>si applicano al file di log JSON.</p><p>Valore predefinito: false</p><p><i>Configurabile</i>.</p></td></tr><tr><td><code>dataSources</code></td><td>Si applica ai processi di aggiornamento delle pianificazioni Bridge legacy.Non modificabile dall’utente.<br>Fornisce un elenco di posizioni di file locali mappati per origini dati basate su file.<p><i>Non configurabile</i></p></td></tr></tbody></table>

#### Esempio

Per gestire l’utilizzo improprio delle estrazioni o degli aggiornamenti, puoi applicare un limite di tempo utilizzando `extractRefreshTimeout`, anche denominato limite di timeout, per gli aggiornamenti eseguiti da un client.Il limite di timeout è il tempo massimo per il completamento di un’unica estrazione prima che venga annullata dal client.

**Nota**: per le estrazioni di connessioni virtuali, l’impostazione predefinita per `extractRefreshTimeout` è di due ore e non può essere controllata dal client Bridge.In alternativa, puoi modificare la connessione virtuale per aggiornarla entro la finestra predefinita di due ore o passare a un’origine dati pubblicata.

Per impostazione predefinita, il limite di timeout per un client è impostato su 24 ore.È possibile modificare il limite di timeout per un client tramite il file di configurazione di Bridge.Se l’aggiornamento di un’estrazione viene annullato in seguito al raggiungimento del limite di timeout, verrà visualizzato un messaggio nel client e il proprietario dell’origine dati riceverà un avviso e-mail.

È necessario riavviare il client per rendere effettive le modifiche apportate al file di configurazione.

```
"dataSourceRefreshSettings" : {
	"shutdownTimeoutInSeconds" : "00:00:30",
	"downloadDataSourcesInterval" : "00:30:00",
	"checkRefreshDataSourcesInterval" : "00:00:05",
	"extractRefreshTimeout" : "24:00:00",
	"maxRemoteJobConcurrency" : 10,
	"JSONLogForExtractRefresh" : false,
	"dataSources" : [
	]
}
```

### loggerSettings

Configurazione: `loggerSettings`

Opzioni:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>maxLogFileSizeInMB</code></td><td>Dimensione massima dei file di log in MB.Quando un file di log supera il limite per le dimensioni, ne viene creato uno nuovo.<p>Valore predefinito: 25 MB.</p><p><i>Configurabile</i>.</p></td></tr><tr><td><code>maxBackupLogFileCount</code></td><td>Numero massimo di file di log di Bridge consentiti.Quando il numero di file di log supera il limite, il file meno recente viene eliminato.<p>Il valore predefinito è 40.<br></p><p><i>Configurabile</i>.<br></p></td></tr><tr><td><code>remoteRequestLogFileLifeSpan</code></td><td>Per ogni processo di aggiornamento Bridge inviato al client, viene creato un nuovo insieme di file di log:<p><code>tabbridgeclijob_&lt;process_id, and if the data source is JDBC-based: fjprotocolserver_&lt;process_id&gt;, and stdout_jprotocolserver_&lt;process_id&gt;</code>.</p><p>Per impostazione predefinita, il tempo massimo per cui i file di log rimangono nella cartella Logs prima di essere eliminati è di otto ore se il numero di file di log supera il valore di <code>maxBackupLogFileCount</code>.In alternativa, questi file di log vengono conservati a tempo indeterminato, purché il numero di file non superi il valore di <code>maxBackupLogFileCount</code>.</p><p><code>&lt;process_id&gt;</code> rappresenta l’ID del processo Windows.</p><p>Valore predefinito: 8 ore</p><p><i>Configurabile</i>.</p></td></tr></tbody></table>

#### Esempio

Il client crea log delle attività durante il normale funzionamento.Puoi utilizzare questi log per il monitoraggio degli aggiornamenti, la risoluzione dei problemi di Bridge o se l’assistenza di Tableau richiede i log per aiutare a risolvere un problema.

Puoi gestire le dimensioni dei file di log di Bridge o aumentare il periodo di conservazione dei file di log prima che vengano eliminati nel file TabBridgeClientConfiguration.txt.

Nota: i file di log denominati tabprotosrv\* sono diversi dagli altri file di log di Bridge.La dimensione massima è 1 MB e il numero massimo di file di log consentiti è 8.192.Questi valori, inoltre, non sono configurabili.

```
"loggerSettings" : {
	"maxLogFileSizeInMB" : 25,
	"maxBackupLogFileCount" : 40,
	"remoteRequestLogFileLifeSpan" : "00:00:00"
}
```

### dataSyncRestartInterval

Configurazione: `dataSyncRestartInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>Imposta l’intervallo di riavvio della sincronizzazione dati.</p><p><i>Configurabile</i>.</p></td></tr></tbody></table>

### internetConnectionMonitorInterval

Configurazione: `internetConnectionMonitorInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>Intervallo necessario a Bridge per eseguire il ping di Internet e determinare se esiste una connessione valida.</p><p>Valore predefinito: 30 secondi</p><p><i>Configurabile</i>.</p></td></tr></tbody></table>

### secureStorageMonitorInterval

Configurazione: `secureStorageMonitorInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td>Intervallo per consentire a Bridge di determinare l’archiviazione sicura.<p><i>Non configurabile</i>.</p></td></tr></tbody></table>

#### cleanUpTempDirOnStartUp

Configurazione: `cleanUpTempDirOnStartUp`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>Determina se rimuovere i file temporanei all’avvio del client Bridge.</p><p>Valore predefinito: true</p><p><i>Configurabile</i>.</p></td></tr></tbody></table>

#### JSONLogForLiveQuery

Configurazione: `JSONLogForLiveQuery`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td>Se impostata su true, il client genera un file di log aggiuntivo in formato JSON.Il log acquisisce le metriche della richiesta di query live, con una riga per estrazione.<p>Il formato del file di log JSON è leggibile da <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> e può essere utilizzato come origine dati per creare visualizzazioni live.Per maggiori informazioni, consulta File JSON.</p><p>La modifica del valore di questa opzione di configurazione richiede il riavvio del client Bridge.</p><p>Valore predefinito: true</p><p><i>Configurabile</i>.</p></td></tr></tbody></table>

#### Esempio

```
"dataSyncRestartInterval" : "24:00:00",
"internetConnectionMonitorInterval" : "00:00:30",
"secureStorageMonitorInterval" : "00:00:30",
"cleanUpTempDirOnStartUp" : true,,
"JSONLogForLiveQuery" : true
}
```

## File di configurazione predefinito

Per copiare il file di configurazione predefinito, fai clic sull’icona **Copia negli Appunti** nell’angolo in alto a destra.

```
{
	"serviceConnectionSettings" : {
		"serviceUrl" : "https://online.tableau.com/",
		"connection" : {
			"connectTimeout" : "00:01:00",
			"operationTimeout" : "00:15:00",
			"maxAttemptsToRedirectHttpRequests" : 20
		},
	},
	"dataSourceRefreshSettings" : {
		"shutdownTimeoutInSeconds" : "00:00:30",
		"downloadDataSourcesInterval" : "00:30:00",
		"checkRefreshDataSourcesInterval" : "00:00:05",
		"extractRefreshTimeout" : "24:00:00",
		"maxRemoteJobConcurrency" : 10,
		"JSONLogForExtractRefresh" : false,
		"dataSources" : [
		]
	},
	"loggerSettings" : {
	"maxLogFileSizeInMB" : 25,
		"maxBackupLogFileCount" : 40,
		"remoteRequestLogFileLifeSpan" : "08:00:00"
	},
	"dataSyncRestartInterval" : "24:00:00",
	"internetConnectionMonitorInterval" : "00:00:30",
	"secureStorageMonitorInterval" : "00:00:30",
	"cleanUpTempDirOnStartUp" : true,
	"JSONLogForLiveQuery" : true
}
```

## Altri articoli in questa sezione