Ändern der Bridge-Clienteinstellungen

Es gibt mehrere Bridge-Clienteinstellungen, die der Site-Administrator konfigurieren kann, um die Funktionsweise eines Clients zu ändern.

Windows-Client

Für Windows-Clients ist der Standardspeicherort der Konfigurationsdatei C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt. Der Client muss neu gestartet werden, damit die an der Konfigurationsdatei vorgenommenen Änderungen wirksam werden.

Bridge für Linux für Container

Die Datei TabBridgeClientConfiguration.txt wird mit Standardkonfigurationen generiert, wenn Sie den Bridge-Client zum ersten Mal ausführen.

Um Änderungen an den Konfigurationseinstellungen vorzunehmen, bearbeiten Sie die Datei TabBridgeClientConfiguration.txt und erstellen Sie einen neuen Docker-Container mit der aktualisierten Datei. Weitere Informationen zum Erstellen und Aktualisieren eines Containers finden Sie unter Containerisieren einer Anwendung.

Bridge-Legacy-Zeitpläne

In einigen Fällen kann ein Datenquellenbesitzer für einige der in diesem Thema beschriebenen Aufgaben verantwortlich sein, wenn er seinen eigenen Client für die Ausführung von Bridge-Legacy-Zeiplänen verwendet.

Bridge-Client-Einstellungen

serviceConnectionSettings

Konfiguration: serviceConnectionSettings

Optionen:

serviceUrlTableau-Site-URL.

Nicht konfigurierbar.

proxyServerProxyserver und -port.

Konfigurierbar

Beispiel

Der Client muss neu gestartet werden, damit die an der Konfigurationsdatei vorgenommenen Änderungen wirksam werden.

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

connection

Konfiguration: connection

Optionen:

connectTimeoutDie Wartezeit des Bridge-Clients beim Versuch, eine Verbindung zu Tableau Cloud herzustellen.

Standardwert: 1 Minute

Konfigurierbar.

operationTimeoutDie Wartezeit des Bridge-Clients für jeden Server-API-Aufruf (z. B. VizPortal) nach erfolgreicher Verbindung mit Tableau Cloud.

Standardwert: 15 Minuten

Konfigurierbar.

maxAttemptsToRedirectHttpRequestsEin API-Aufruf an einen Server kann von POD zu POD umgeleitet werden. Diese Zahl gibt die maximale Anzahl von Umleitungen pro Server-API-Aufruf an. Standardwert: 20

Konfigurierbar.

Beispiel

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

connectionPool

Konfiguration: connectionPool

Optionen:

sizeGilt für Bridge-Aktualisierungszeitpläne.

Die Anzahl der zum Zeitpunkt der Anmeldung generierten Aktualisierungstoken. Der Bridge-Client verwendet Aktualisierungstoken, wenn eine Verbindung zu Tableau Cloud gebraucht wird. Aktualisierungsaufträge werden gleichzeitig verarbeitet, und jeder Auftrag benötigt ein Token.

Standardwert: 10

Mindestwert: 1

Maximalwert: 100.

Konfigurierbar.

Beispiel

Standardmäßig kann jeder Client in einem Pool für bis zu 10 Aktualisierungsaufträge gleichzeitig einen Lastenausgleich durchführen. Wenn die Anzahl der Aktualisierungsaufträge, die zu einem bestimmten Zeitpunkt ausgeführt werden, die Kapazität Ihres Clientpools übersteigt oder Sie über die Hardwareressourcen verfügen, um dies zu unterstützen, sollten Sie die Kapazität jedes Clients erhöhen.

Unter Windows: Für eine Änderung des size-Wertes ist es erforderlich, dass die Verknüpfung des Clients aufgehoben wird. Durch das Aufheben der Verknüpfung wird die Zuordnung zwischen der Site und dem Client entfernt. Für Datenquellen, die mithilfe von Bridge-Legacy-Zeitplänen aktualisiert werden, bedeutet das, dass durch das Aufheben der Client-Verknüpfung Zuordnungen zu diesen Datenquellen, seinen Zeitplänen und Verbindungsinformationen vom Client entfernt werden. Während der Größenänderung des Bridge-Pools empfiehlt es sich, dass Sie auf das Bridge-Symbol in der Windows-Systemleiste klicken und sich die aufgelisteten Datenquellen notieren, um den Neuplanungsprozess zu vereinfachen.

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

dataSourceRefreshSettings

Konfiguration: dataSourceRefreshSettings

Optionen:

shutdownTimeoutInSecondsNicht konfigurierbar.
downloadDataSourcesIntervalDas Zeitintervall für das temporäre Herunterladen der Namen von Live-Datenquellen und Extraktdatenquellen, die dem Client für Brindge-Legacy-Zeitpläne zugewiesen sind.

Standardwert: 30 Minuten.

Konfigurierbar.

checkRefreshDataSourcesIntervalDas Zeitintervall, in dem der Bridge-Client die dem Client zugewiesenen Datenquellen überprüft, um festzustellen, ob eine Aktualisierung für Bridge-Legacy-Zeitpläne erforderlich ist.

Standardwert: 5 Sekunden

Konfigurierbar.

extractRefreshTimeoutErzwingt ein Zeitlimit für vom Client durchgeführte Aktualisierungen. Das Zeitüberschreitungslimit ist die längste verfügbare Zeit für einen einzelnen Extrakt, um eine Aktualisierung abzuschließen, bevor sie vom Client abgebrochen wird. Wenn eine Extraktaktualisierung wegen Erreichen der Zeitüberschreitung abgebrochen wird, wird Ihnen im Client eine Meldung angezeigt, und es wird eine E-Mail-Benachrichtigung an den Eigentümer der Datenquelle gesendet.

Standardwert: 24 Stunden.

Für virtuelle Verbindungen beträgt das standardmäßige Zeitüberschreitungslimit für eine Extraktaktualisierung 2 Stunden und wird von Tableau Cloud gesteuert. Vom Bridge-Client kann dieses Zeitlimit nicht gesteuert werden.

Konfigurierbar.

maxRemoteJobConcurrencyGilt für Bridge-Aktualisierungszeitpläne. Maximale Anzahl der vom Client zugelassenen Remote-Aktualisierungsaufträge. Der Wert für diese Konfiguration muss gleich oder kleiner als „connectionPool“ sein. Passen Sie den maximalen Wert an die Fähigkeiten Ihres Computers (wie CPU und RAM) an. Erfordert einen Neustart des Clients.

Standardwert: 10

Minimum: 1

Maximum: Der Wert für connectionPool

Konfigurierbar.

JSONLogForExtractRefreshWenn der Wert auf „true“ gesetzt ist, generiert der Client eine zusätzliche Protokolldatei im JSON-Format. Das Protokoll erfasst die Metriken der Extraktaktualisierungen sowohl für Bridge-Legacy- als auch Remote-Aktualisierungen mit einer Zeile pro Extrakt.

Das Format der JSON-Protokolldatei ist von Tableau Desktop lesbar und kann als Datenquelle zum Erstellen von Live-Visualisierungen verwendet werden. Weitere Informationen finden Sie unter JSON-Datei.

Ein Beispiel für die Protokolldatei ist: ExtractRefreshMetrics_<timestamp>.json
Zum Ändern des Werts dieser Konfigurationsoption ist ein Neustart des Bridge-Clients erforderlich.

Die loggerSettings-Konfigurationsoptionen gelten für die JSON-Protokolldatei.

Standardwert: false

Konfigurierbar.

dataSourcesGilt für Bridge-Legacy-Zeitplan-Aktualisierungsaufträge. Nicht vom Benutzer bearbeitbar.
Stellt eine Liste zugeordneter lokaler Dateispeicherorte für dateibasierte Datenquellen bereit.

Nicht konfigurierbar

Beispiel

Um den missbräuchliche Nutzung von Extrakten oder Aktualisierungen zu verhindern, können Sie mithilfe von extractRefreshTimeout ein Zeitlimit für Extrakte und Aktualisierungen erzwingen, die von einem Client durchgeführt werden. Das Zeitüberschreitungslimit ist die längste verfügbare Zeit für einen einzelnen Extrakt, um eine Aktualisierung abzuschließen, bevor sie vom Client abgebrochen wird.

Hinweis: Für Extrakte von virtuellen Verbindungen beträgt der Standardwert für extractRefreshTimeout 2 Stunden, was vom Bridge-Client auch nicht gesteuert werden kann. Alternativ können Sie die virtuelle Verbindung so ändern, dass sie innerhalb des standardmäßigen 2-Stunden-Fensters aktualisiert wird, oder zu einer veröffentlichten Datenquelle wechseln.

Standardmäßig beträgt das Zeitüberschreitungslimit für einen Client 24 Stunden. Sie können das Zeitüberschreitungslimit für einen Client über die Bridge-Konfigurationsdatei ändern. Wenn eine Extraktaktualisierung wegen Erreichen der Zeitüberschreitung abgebrochen wird, wird Ihnen im Client eine Meldung angezeigt, und es wird eine E-Mail-Benachrichtigung an den Eigentümer der Datenquelle gesendet.

Der Client muss neu gestartet werden, damit die an der Konfigurationsdatei vorgenommenen Änderungen wirksam werden.

"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

Optionen:

maxLogFileSizeInMBMaximale Größe der Protokolldateien in MB. Wenn eine Protokolldatei diese Größe überschreitet, wird eine neue Protokolldatei erstellt.

Standardwert: 25 MB.

Konfigurierbar.

maxBackupLogFileCountMaximale Anzahl der zulässigen Bridge-Protokolldateien. Wenn die Anzahl der Protokolldateien diesen Grenzwert überschreitet, wird die älteste Protokolldatei gelöscht.

Standard ist 40.

Konfigurierbar.

remoteRequestLogFileLifeSpanFür jeden Bridge-Aktualisierungsauftrag, der an den Client gesendet wird, wird ein neuer Satz von Protokolldateien erstellt:

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

Wenn die Anzahl der Protokolldateien maxBackupLogFileCount überschreitet, bleiben die Protokolldateien standardmäßig für maximal 8 Stunden im „Logs“-Ordner aufbewahrt, bevor sie gelöscht werden. Andernfalls bleiben diese Protokolldateien auf unbestimmte Zeit erhalten, solange die Anzahl der Protokolldateien kleiner oder gleich maxBackupLogFileCount ist.

<process_id> stellt die Windows-Prozess-ID dar.

Standardwert: 8 Stunden

Konfigurierbar.

Beispiel

Der Client erstellt im Rahmen des normalen Betriebs Protokolle zu Aktivitäten. Sie können diese Protokolle verwenden, um Aktualisierungen zu überwachen, Probleme mit Bridge zu beheben oder um Protokolle für die Lösung eines Problems an den Tableau-Support zu übermitteln.

In der Datei "TabBridgeClientConfiguration.txt" können Sie die Größe der Bridge-Protokolldateien verwalten oder die Zeitdauer erhöhen, nach deren Ablauf Protokolldateien gelöscht werden.

Hinweis: Protokolldateien mit dem Namen „tabprotosrv*“ unterscheiden sich von anderen Bridge-Protokolldateien. Die maximale Größe beträgt 1 MB und die maximale Anzahl der zulässigen Protokolldateien 8.192. Diese Werte sind ebenfalls nicht konfigurierbar.

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

dataSyncRestartInterval

Konfiguration: dataSyncRestartInterval

Legt das Neustartintervall der Datensynchronisierung fest.

Konfigurierbar.

internetConnectionMonitorInterval

Konfiguration: internetConnectionMonitorInterval

Intervall, in dem Bridge mithilfe von Ping-Befehlen überprüft, ob eine gültige Verbindung besteht.

Standardwert: 30 Sekunden

Konfigurierbar.

secureStorageMonitorInterval

Konfiguration: secureStorageMonitorInterval

Intervall für Bridge zum Bestimmen einer sicheren Speichermöglichkeit.

Nicht konfigurierbar.

cleanUpTempDirOnStartUp

Konfiguration: cleanUpTempDirOnStartUp

Legt fest, ob die temporären Dateien entfernt werden sollen, wenn der Bridge-Client gestartet wird.

Standardwert: „true“

Konfigurierbar.

JSONLogForLiveQuery

Konfiguration: JSONLogForLiveQuery

Wenn der Wert auf „true“ gesetzt ist, generiert der Client eine zusätzliche Protokolldatei im JSON-Format. Das Protokoll erfasst die Metriken einer Live-Abfrageanforderung mit einer Zeile pro Extrakt.

Das Format der JSON-Protokolldatei ist von Tableau Desktop lesbar und kann als Datenquelle zum Erstellen von Live-Visualisierungen verwendet werden. Weitere Informationen finden Sie unter „JSON-Datei“.

Zum Ändern des Werts dieser Konfigurationsoption ist ein Neustart des Bridge-Clients erforderlich.

Standardwert: „true“

Konfigurierbar.

Beispiel

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

Standardkonfigurationsdatei

Um die Standardkonfigurationsdatei zu kopieren, klicken Sie auf das Symbol In Zwischenablage kopieren in der oberen rechten Ecke.

{
	"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
}
Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.