Ä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:
serviceUrl | Tableau-Site-URL. Nicht konfigurierbar. |
proxyServer | Proxyserver 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:
connectTimeout | Die Wartezeit des Bridge-Clients beim Versuch, eine Verbindung zu Tableau Cloud herzustellen. Standardwert: 1 Minute Konfigurierbar. |
operationTimeout | Die Wartezeit des Bridge-Clients für jeden Server-API-Aufruf (z. B. VizPortal) nach erfolgreicher Verbindung mit Tableau Cloud. Standardwert: 15 Minuten Konfigurierbar. |
maxAttemptsToRedirectHttpRequests | Ein 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:
size | Gilt 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:
shutdownTimeoutInSeconds | Nicht konfigurierbar. |
downloadDataSourcesInterval | Das 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. |
checkRefreshDataSourcesInterval | Das 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. |
extractRefreshTimeout | Erzwingt 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. |
maxRemoteJobConcurrency | Gilt 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 Konfigurierbar. |
JSONLogForExtractRefresh | Wenn 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: Die Standardwert: false Konfigurierbar. |
dataSources | Gilt 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:
maxLogFileSizeInMB | Maximale Größe der Protokolldateien in MB. Wenn eine Protokolldatei diese Größe überschreitet, wird eine neue Protokolldatei erstellt. Standardwert: 25 MB. Konfigurierbar. |
maxBackupLogFileCount | Maximale Anzahl der zulässigen Bridge-Protokolldateien. Wenn die Anzahl der Protokolldateien diesen Grenzwert überschreitet, wird die älteste Protokolldatei gelöscht. Standard ist 40. Konfigurierbar. |
remoteRequestLogFileLifeSpan | Für jeden Bridge-Aktualisierungsauftrag, der an den Client gesendet wird, wird ein neuer Satz von Protokolldateien erstellt:
Wenn die Anzahl der Protokolldateien
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
}