De Bridge client-instellingen wijzigen

De sitebeheerder kan verschillende Bridge-clientinstellingen configureren om de manier waarop een client wordt uitgevoerd te wijzigen.

Windows-client

Voor Windows-clients is C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt de standaardlocatie van het configuratiebestand. De client moet opnieuw worden opgestart om eventuele wijzigingen in het configuratiebestand door te voeren.

Bridge voor Linux voor containers

Het bestand TabBridgeClientConfiguration.txt wordt gegenereerd met standaardconfiguraties wanneer u de Bridge-client voor het eerst uitvoert.

Als u wijzigingen wilt aanbrengen in de configuratie-instellingen, bewerkt u het bestand TabBridgeClientConfiguration.txt en maakt u een nieuwe Docker-container met het bijgewerkte bestand. Zie Een toepassing in containers plaatsen (in het Engels) voor meer informatie over het maken en bijwerken van een container.

Verouderde Bridge-planningen

In bepaalde gevallen kan de eigenaar van een databron verantwoordelijk zijn voor een aantal taken die in dit onderwerp worden besproken, als deze eigenaar zelf de eigen client onderhoudt om verouderde Bridge-planningen uit te voeren.

Instellingen voor de Bridge-client

serviceConnectionInstellingen

Configuratie: serviceConnectionSettings

Opties:

serviceUrlURL van Tableau-site.

Niet configureerbaar.

proxyServerProxyserver en poort.

Configureerbaar

Voorbeeld

De client moet opnieuw worden opgestart om eventuele wijzigingen in het configuratiebestand door te voeren.

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

connection

Configuratie: connection

Opties:

connectTimeoutDe wachttijd van de Bridge-client bij verbindingspogingen met Tableau Cloud.

De standaardwaarde: 1 minuut

Configureerbaar.

operationTimeoutDe wachttijd van de Bridge-client voor elke API-aanroep naar de server (zoals VizPortal) nadat een verbinding tot stand is gebracht met Tableau Cloud.

De standaardwaarde: 15 minuten

Configureerbaar.

maxAttemptsToRedirectHttpRequestsEen API-oproep naar een server kan van POD naar POD worden omgeleid. Dit aantal verwijst naar het maximumaantal omleidingen per API-aanroep naar de server. Standaardwaarde: 20

Configureerbaar.

Voorbeeld

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

connectionPool

Configuratie: connectionPool

Opties:

sizeVan toepassing op Bridge-vernieuwingsplanningen.

Het aantal vernieuwingstokens dat wordt gegenereerd op het moment van inloggen. De Bridge-client gebruikt vernieuwingstokens wanneer een verbinding met Tableau Cloud nodig is. Vernieuwingsjobs worden gelijktijdig verwerkt en voor elke job is een token nodig.

Standaardwaarde: 10

Minimale waarde: 1

Maximale waarde: 100.

Configureerbaar.

Voorbeeld

Standaard kan elke client in een pool maximaal 10 vernieuwingsjobs tegelijk uitvoeren. Als het aantal vernieuwingsjobs dat op een bepaald moment wordt uitgevoerd de capaciteit van uw clientpool overschrijdt of als u over voldoende hardwarebronnen beschikt, kunt u overwegen om de capaciteit van elke client te vergroten.

In Windows dient u de koppeling met de client te verwijderen om de waarde size aan te passen. Door de koppeling te verbreken, wordt de koppeling tussen de site en de client verwijderd. Het verwijderen van de koppeling met de client voor databronnen die worden vernieuwd met behulp van verouderde Bridge-planningen betekent dus dat alle koppelingen met die databronnen, de bijbehorende planningen en alle verbindingsinformatie van de client ook worden verwijderd. Bij het wijzigen van de grootte van de Bridge-pool raden wij u aan om op het Bridge-pictogram in het systeemvak van Windows te klikken en de vermelde databronnen te noteren. Dit maakt het opnieuw plannen gemakkelijker.

"connection" : {
	"connectTimeout" : "00:01:00",
	"operationTimeout" : "00:15:00",
	"maxAttemptsToRedirectHttpRequests" : 20
	},
"connectionPool" : {
	"size" : 10
}

dataSourceRefreshInstellingen

Configuratie: dataSourceRefreshSettings

Opties:

shutdownTimeoutInSecondsNiet configureerbaar.
downloadDataSourcesIntervalHet tijdsinterval voor het tijdelijk downloaden van de namen van livedatabronnen en extractdatabronnen die aan de client zijn toegewezen voor verouderde Bridge-planningen.

De standaardwaarde: 30 minuten.

Configureerbaar.

checkRefreshDataSourcesIntervalHet tijdsinterval voor de Bridge-client om databronnen te controleren die aan de client zijn toegewezen om vast te stellen of een vernieuwing nodig is voor verouderde Bridge-planningen.

Standaardwaarde: 5 seconden

Configureerbaar.

extractRefreshTimeoutDwingt een tijdslimiet af voor vernieuwingen die door de client worden uitgevoerd. De time-outlimiet is de langst toegestane tijd voor één extract om een vernieuwing te voltooien voordat deze wordt geannuleerd door de client. Als een extractvernieuwing wordt geannuleerd omdat de time-outlimiet is bereikt, ziet u een bericht in de client en wordt er een e-mailwaarschuwing naar de eigenaar van de databron verzonden.

Standaardwaarde: 24 uur.

Voor virtuele verbindingen is de standaard time-outlimiet voor extractvernieuwing 2 uur en deze limiet wordt bepaald door Tableau Cloud. De tijdslimiet kan niet worden beheerd door de Bridge-client.

Configureerbaar.

maxRemoteJobConcurrencyVan toepassing op Bridge-vernieuwingsplanningen. Maximumaantal externe vernieuwingsjobs dat door de client is toegestaan. De waarde voor deze configuratie moet gelijk zijn aan of kleiner zijn dan connectionPool. Stel de maximale waarde af op de mogelijkheden van uw machine, zoals CPU en RAM. Vereist een herstart van de client.

Standaardwaarde: 10

Minimum: 1

Maximum: de waarde voor connectionPool

Configureerbaar.

JSONLogForExtractRefreshWanneer deze optie op waar is ingesteld, genereert de client een extra logbestand in de JSON-indeling. In het logbestand worden de statistieken voor extractvernieuwingen vastgelegd, voor zowel verouderde als externe Bridge-vernieuwingen, met één regel per extract.

De indeling van het JSON-logbestand kan door Tableau Desktop worden gelezen en kan worden gebruikt als databron voor het maken van live visualisaties. Zie JSON-bestand voor meer informatie.

Een voorbeeld van het logbestand is: ExtractRefreshMetrics_<timestamp>.json
Als u de waarde van deze configuratieoptie wilt wijzigen, moet u de Bridge-client opnieuw opstarten.

De configuratieopties voor loggerSettings zijn van toepassing op het JSON-logbestand.

Standaardwaarde: onwaar

Configureerbaar.

dataSourcesIs van toepassing op verouderde geplande Bridge-vernieuwingstaken. Kan niet door de gebruiker worden bewerkt.
Verschaft een lijst met toegewezen lokale bestandslocaties voor op bestanden gebaseerde databronnen.

Niet configureerbaar

Voorbeeld

Om misbruik van uittreksels of vernieuwingen te beheren, kunt u voor vernieuwingen die door een client worden uitgevoerd een tijdslimiet afdwingen met behulp van extractRefreshTimeout, ook wel een time-outlimiet genoemd. De time-outlimiet is de langst toegestane tijd voor één extract om een vernieuwing te voltooien voordat deze wordt geannuleerd door de client.

Opmerking: Voor extracten van virtuele verbindingen is de standaardwaarde voor extractRefreshTimeout 2 uur. Deze waarde kan niet worden beheerd door de Bridge-client. Als alternatief kunt u de virtuele verbinding aanpassen, zodat deze binnen het standaardvenster van 2 uur wordt vernieuwd. U kunt ook overschakelen naar een gepubliceerde databron.

Standaard is de time-outlimiet voor een client ingesteld op 24 uur. U kunt de time-outlimiet voor een client wijzigen via het Bridge-configuratiebestand. Als een extractvernieuwing wordt geannuleerd omdat de time-outlimiet is bereikt, ziet u een bericht in de client en wordt er een e-mailwaarschuwing naar de eigenaar van de databron verzonden.

De client moet opnieuw worden opgestart om eventuele wijzigingen in het configuratiebestand door te voeren.

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

loggerSettings

Configuratie: loggerSettings

Opties:

maxLogFileSizeInMBMaximale grootte van de logbestanden, uitgedrukt in MB. Wanneer een logbestand de maximale bestandsgrootte overschrijdt, wordt er een nieuw logbestand gemaakt.

Standaardwaarde: 25 MB.

Configureerbaar.

maxBackupLogFileCountMaximumaantal toegestane Bridge-logbestanden. Wanneer het aantal logbestanden de limiet overschrijdt, wordt het oudste logbestand verwijderd.

De standaardwaarde is 40.

Configureerbaar.

remoteRequestLogFileLifeSpanVoor elke Bridge-vernieuwingsjob die naar de client wordt verzonden, wordt een nieuwe set logbestanden gemaakt:

tabbridgeclijob_<process_id, and if the data source is JDBC-based: fjprotocolserver_<process_id>, and stdout_jprotocolserver_<process_id>.

Standaard bedraagt de maximale tijd dat de logbestanden in de map Logboekbestanden blijven staan voordat ze worden verwijderd acht uur als het aantal logbestanden groter is dan maxBackupLogFileCount. Anders blijven deze logbestanden voor onbepaalde tijd bestaan zolang het aantal logbestanden kleiner is dan of gelijk is aan maxBackupLogFileCount.

<process_id> vertegenwoordigt de Windows-proces-ID.

Standaardwaarde: 8 uur

Configureerbaar.

Voorbeeld

De client neemt activiteiten standaard op in een logboek. U kunt deze logboeken gebruiken om vernieuwingen te monitoren, problemen met Bridge op te lossen of om een probleem op te lossen als de Tableau-ondersteuning u om de logboeken vraagt.

In het bestand TabBridgeClientConfiguration.txt kunt u de grootte van Bridge-logbestanden beheren of logbestanden langer laten bewaren voordat ze worden verwijderd.

Let op: Logbestanden met de naam tabprotosrv* verschillen van andere Bridge-logbestanden. De maximale grootte is 1 MB en het maximumaantal toegestane logbestanden is 8192. Deze waarden kunnen bovendien niet worden geconfigureerd.

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

dataSyncRestartInterval

Configuratie: dataSyncRestartInterval

Hiermee stelt u het interval voor opnieuw starten van de datasynchronisatie in.

Configureerbaar.

internetConnectionMonitorInterval

Configuratie: internetConnectionMonitorInterval

Interval waarmee Bridge internet pingt om te bepalen of er sprake is van een geldige verbinding.

Standaardwaarde: 30 seconden

Configureerbaar.

secureStorageMonitorInterval

Configuratie: secureStorageMonitorInterval

Interval waarmee Bridge veilige opslag bepaalt.

Niet configureerbaar.

cleanUpTempDirOnStartUp

Configuratie: cleanUpTempDirOnStartUp

Bepaalt of de tijdelijke bestanden moeten worden verwijderd wanneer de Bridge-client wordt gestart.

Standaardwaarde: waar

Configureerbaar.

JSONLogForLiveQuery

Configuratie: JSONLogForLiveQuery

Wanneer deze optie op waar is ingesteld, genereert de client een extra logbestand in de JSON-indeling. In het logboek worden de statistieken van live query-aanvragen vastgelegd, met één regel per extract

De indeling van het JSON-logbestand kan door Tableau Desktop worden gelezen en kan worden gebruikt als databron voor het maken van live visualisaties. Zie JSON-bestand voor meer informatie.

Als u de waarde van deze configuratieoptie wilt wijzigen, moet u de Bridge-client opnieuw opstarten.

Standaardwaarde: waar

Configureerbaar.

Voorbeeld

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

Bestand met standaardconfiguratie

Klik op het pictogram Kopiëren naar klembord in de rechterbovenhoek om het bestand met de standaardconfiguratie te kopiëren.

{
	"serviceConnectionSettings" : {
		"serviceUrl" : "https://online.tableau.com/",
		"connection" : {
			"connectTimeout" : "00:01:00",
			"operationTimeout" : "00:15:00",
			"maxAttemptsToRedirectHttpRequests" : 20
		},
		"connectionPool" : {
			"size" : 10
		}
	},
	"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
}
Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.