Ändra Bridge-klientinställningar

Det finns flera Bridge-klientinställningar som webbplatsadministratören kan konfigurera för att ändra hur en klient körs.

Windows-klienter

För Windows-klienter är standardplatsen för konfigurationsfilen C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt. Klienten måste startas om för att eventuella ändringar i konfigurationsfilen ska träda i kraft.

Bridge för Linux för behållare

Filen TabBridgeClientConfiguration.txt genereras med standardkonfigurationer första gången du kör Bridge-klienten.

Om du vill göra ändringar i konfigurationsinställningarna redigerar du filen TabBridgeClientConfiguration.txt och skapar en ny Docker-behållare med den uppdaterade filen. Mer information om hur du skapar och uppdaterar en behållare finns i Containerize an application (på engelska).

Äldre Bridge-scheman

I vissa fall kan en datakällas ägare vara ansvarig för några av de uppgifter som beskrivs i det här ämnet, om hen underhåller sin egen klient för att köra äldre Bridge-scheman.

Inställningar för Bridge-klienten

serviceConnectionSettings

Konfiguration: serviceConnectionSettings

Alternativ:

serviceUrlTableau-platsens URL.

Kan inte konfigureras.

proxyServerProxyserver och port.

Kan konfigureras

Exempel

Klienten måste startas om för att eventuella ändringar i konfigurationsfilen ska träda i kraft.

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

connection

Konfiguration: connection

Alternativ:

connectTimeoutVäntetiden för Bridge-klienten när du försöker ansluta till Tableau Cloud.

Standardvärde: 1 minut

Kan konfigureras.

operationTimeoutVäntetiden för Bridge-klienten för varje servers (såsom VizPortal) API-anrop efter framgångsrik anslutning till Tableau Cloud.

Standardvärde: 15 minuter

Kan konfigureras.

maxAttemptsToRedirectHttpRequestsEtt API-anrop till en server kan omdirigeras från POD till POD. Detta nummer anger det maximala antalet omdirigeringar per server-API-anrop. Standardvärde: 20

Kan konfigureras.

Exempel

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

connectionPool

Konfiguration: connectionPool

Alternativ:

sizeGäller för Bridge-uppdateringsscheman.

Antalet uppdateringstoken som genererades vid inloggningstillfället. Bridge-klienten använder uppdateringstoken när en anslutning till Tableau Cloud behövs. Uppdateringsjobb bearbetas samtidigt och varje jobb behöver en token.

Standardvärde: 10

Minsta värde: 1

Maximalt värde: 100

Kan konfigureras.

Exempel

Som standard kan varje klient i en pool belastningsutjämna upp till 10 uppdateringsjobb åt gången. Om antalet uppdateringsjobb som körs vid en given tidpunkt överstiger kapaciteten hos din klientpool eller om du har hårdvaruresurser för att stödja den, överväg då att öka varje klients kapacitet.

Om du i Windows ändrar värdet size måste klienten kopplas bort. Avlänkning tar bort kopplingen mellan platsen och klienten. Det innebär att avlänkning av klienten för datakällor som uppdateras med hjälp av äldre Bridge-scheman gör att kopplingarna till sådana datakällor, dess scheman och all anslutningsinformation från klienten tas bort. Som en del av att ändra storleken på Bridge-poolen rekommenderar vi att du klickar på Bridge-ikonen i Windows-systemfältet och noterar de datakällor som anges för att underlätta schemaomläggningen.

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

dataSourceRefreshSettings

Konfiguration: dataSourceRefreshSettings

Alternativ:

shutdownTimeoutInSecondsKan inte konfigureras.
downloadDataSourcesIntervalTidsintervallet för att temporärt ladda ner namnen på livedatakällor och extraktionsdatakällor som är tilldelade klienten för äldre Bridge-scheman.

Standardvärde: 30 minuter.

Kan konfigureras.

checkRefreshDataSourcesIntervalTidsintervallet för Bridge-klienten att kontrollera datakällor som är tilldelade till klienten för att fastställa om en uppdatering behövs för äldre Bridge-scheman.

Standardvärde: 5 sekunder

Kan konfigureras.

extractRefreshTimeoutUpprätthåller en tidsgräns för uppdateringar som utförs av klienten. Tidsgränsen är den längsta tillåtna tiden för ett enskilt extrakt att slutföra en uppdatering innan det avbryts av klienten. Om en uppdatering av extrakt avbryts som ett resultat av att tidsgränsen har uppnåtts, ser du ett meddelande i klienten och en e-postvarning skickas till datakällans ägare.

Standardvärde: 24 timmar.

För virtuella anslutningar är standardtidsgränsen för extraktuppdateringar 2 timmar och styrs av Tableau Cloud. Tidsgränsen kan inte påverkas av Bridge-klienten.

Kan konfigureras.

maxRemoteJobConcurrencyGäller för Bridge-uppdateringsscheman. Maximalt antal fjärruppdateringar av jobb som tillåts av klienten. Värdet för den här konfigurationen måste vara detsamma eller mindre än connectionPool. Justera det maximala värdet till din dators kapacitet baserat på processor och RAM. Kräver omstart av klienten.

Standardvärde: 10

Minst: 1

Maximalt : värdet på connectionPool

Kan konfigureras.

JSONLogForExtractRefreshNär det är satt till sant genererar klienten ytterligare en loggfil i JSON-format. Loggen registrerar mätvärdena från extraktuppdateringar, både för äldre Bridge-uppdateringar och fjärruppdateringar, med en rad per extrakt.

Formatet på JSON-loggfilen kan läsas av Tableau Desktop och användas som en datakälla för att skapa livevisualiseringar. Mer information finns i avsnittet JSON-fil.

Ett exempel på loggfilen är: ExtractRefreshMetrics_<timestamp>.json
Om du ändrar värdet på det här konfigurationsalternativet måste Bridge-klienten startas om.

Konfigurationsalternativen loggerSettings gäller för JSON-loggfilen.

Standardvärde: falskt

Kan konfigureras.

dataSourcesGäller för äldre Bridge-schemauppdateringar. Ej redigerbara av användaren.
Tillhandahåller en lista över mappade lokala filplatser för filbaserade datakällor.

Kan inte konfigureras

Exempel

För att förhindra missbruk av extrakt eller uppdateringar kan du genomdriva en tidsgräns med hjälp av extractRefreshTimeout, som även kallas en timeout-gräns, för uppdateringar som utförs av en klient. Tidsgränsen är den längsta tillåtna tiden för ett enskilt extrakt att slutföra en uppdatering innan det avbryts av klienten.

Obs! För extrakt från virtuella anslutningar är standardgränsen för extractRefreshTimeout 2 timmar och detta kan inte påverkas via Bridge-klienten. Som ett alternativ kan du ändra den virtuella anslutningen så att den uppdateras inom standardgränsen på 2 timmar eller byta till en publicerad datakälla.

Som standard är tidsgränsen för en klient satt till 24 timmar. Du kan ändra tidsgränsen för en klient genom konfigurationsfilen Bridge. Om en uppdatering av extrakt avbryts som ett resultat av att tidsgränsen har uppnåtts, ser du ett meddelande i klienten och en e-postvarning skickas till datakällans ägare.

Klienten måste startas om för att eventuella ändringar i konfigurationsfilen ska träda i kraft.

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

loggerSettings

Konfiguration: loggerSettings

Alternativ:

maxLogFileSizeInMBMaximal storlek på loggfilerna i MB. När en loggfil överskrider storleksgränsen skapas en ny loggfil.

Standardvärde: 25 MB.

Kan konfigureras.

maxBackupLogFileCountMaximalt antal tillåtna Bridge-loggfiler. När antalet loggfiler överskrider gränsen raderas den äldsta loggfilen.

Standard är 40.

Kan konfigureras.

remoteRequestLogFileLifeSpanFör varje Bridge-uppdateringsjobb som skickas till klienten skapas en ny uppsättning loggfiler:

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

Som standard är den maximala tid som loggfilerna finns kvar i loggkatalogen innan de tas bort 8 timmar, om antalet loggfiler överstiger maxBackupLogFileCount. I annat fall förblir dessa loggfiler obegränsade medan antalet loggfiler är mindre än eller lika med maxBackupLogFileCount.

<process_id> representerar process-ID:er i Windows.

Standardvärde: 8 timmar

Kan konfigureras.

Exempel

Klienten skapar aktivitetsloggar som en del av den normala driften. Du kan använda dessa loggar för att övervaka uppdateringar, felsöka problem med Bridge eller om Tableau Support begär loggar från dig för att hjälpa till att lösa ett problem.

Du kan hantera storleken på Bridge-loggfiler eller öka den tid loggfiler finns kvar innan de tas bort i filen TabBridgeClientConfiguration.txt.

Obs! Loggfiler med namnet tabprotosrv* skiljer sig från andra Bridge-loggfiler. Maximal storlek är 1 MB och maximalt antal tillåtna loggfiler är 8 192. Dessa värden kan inte heller konfigureras.

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

dataSyncRestartInterval

Konfiguration: dataSyncRestartInterval

Anger omstartsintervall för datasynkroniseringen.

Kan konfigureras.

internetConnectionMonitorInterval

Konfiguration: internetConnectionMonitorInterval

Intervall med vilket Bridge kan pinga internet för att avgöra om det finns en giltig anslutning.

Standardvärde: 30 sekunder

Kan konfigureras.

secureStorageMonitorInterval

Konfiguration: secureStorageMonitorInterval

Intervall för Bridge för att fastställa säker lagring.

Kan inte konfigureras.

cleanUpTempDirOnStartUp

Konfiguration: cleanUpTempDirOnStartUp

Fastställer om de tillfälliga filerna ska tas bort när Bridge-klienten startar.

Standardvärde: sant

Kan konfigureras.

JSONLogForLiveQuery

Konfiguration: JSONLogForLiveQuery

När det är satt till sant genererar klienten ytterligare en loggfil i JSON-format. Loggen registrerar mätvärdena för livefrågan med en rad per extrakt.

Formatet på JSON-loggfilen kan läsas av Tableau Desktop och användas som en datakälla för att skapa livevisualiseringar. Mer information finns i avsnittet JSON-fil.

Om du ändrar värdet på det här konfigurationsalternativet måste Bridge-klienten startas om.

Standardvärde: sant

Kan konfigureras.

Exempel

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

Standardkonfigurationsfil

Om du vill kopiera standardkonfigurationsfilen klickar du på ikonen Kopiera till urklipp i det övre högra hörnet.

{
	"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
}
Tack för din feedback!Din feedback har skickats in. Tack!