變更 Bridge 用戶端設定

網站管理員可以對多個 Bridge 用戶端設定進行設定,以變更用戶端的執行方式。

Windows 用戶端

對於 Windows 用戶端,設定檔的預設位置是 C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt。必須重新啟動用戶端以便對設定檔所做的任何變更生效。

為容器設計,適用於 Linux 的 Bridge

TabBridgeClientConfiguration.txt 檔案會在第一次執行 Bridge 用戶端時使用預設設定產生。

若要變更設定設定,請編輯 TabBridgeClientConfiguration.txt 檔案,並使用更新的檔案建立新的 Docker 容器。有關如何建立與更新容器的更多資訊,請參閱 容器化應用程式

舊版排程

在某些情況下,如果資料來源擁有者維護自己的用戶端以執行 Bridge(舊版)排程,則其可能有責任處理本主題中描述的某些工作。

serviceConnectionSettings

設定:serviceConnectionSettings

選項:

serviceUrlTableau 站台 URL。

不可設定

proxyServerProxy 伺服器與連接埠。

可設定

範例

必須重新啟動用戶端以便對設定檔所做的任何變更生效。

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

connection

設定:connection

選項:

connectTimeoutBridge 用戶端在嘗試連線到 Tableau Cloud 時的等待時間。

預設值: 1 分鐘

可設定

operationTimeout成功連線到 Tableau Cloud 後,Bridge 用戶端等待每個伺服器(例如 VizPortal)API 呼叫的時間。

預設值: 15 分鐘

可設定

maxAttemptsToRedirectHttpRequests對伺服器的 API 呼叫可以從 POD 重新導向 POD。此數字指定每次伺服器 API 呼叫的最大重新導向次數。預設值:20

可設定

範例

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

connectionPool

設定:connectionPool

選項:

size適用於線上排程。

登入時產生的重新整理權杖數。需要到 Tableau Cloud 的連線時,Bridge 用戶端會使用重新整理權杖。重新整理作業是同時處理的,每個作業都需要一個權杖。

預設值:10

最小值:1

最大值:100。

可設定

範例

在預設情況下,每個用戶端可以同時附載平衡 10 個重新整理作業。如果在給定時間內的重新整理作業超過用戶端集區的容量或您的硬體資源可以支援,請考慮增加每個用戶端的容量。

在 Windows 上,變更 size 值需要取消連結用戶端。取消連結會移除站台與用戶端之間的關聯。即,如果是使用 Bridge(舊版)排程進行重新整理的資料來源,取消連結用戶端會移除與這些資料來源、其排程的關聯以及用戶端中的任何連線資訊。修改 Bridge 集區大小時,建議按一下 Windows 系統匣中的 Bridge 圖示,並記下列出的資料來源,以協助重新排程流程。

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

dataSourceRefreshSettings

設定:dataSourceRefreshSettings

選項:

shutdownTimeoutInSeconds不可設定
downloadDataSourcesInterval臨時下載分配給舊版排程用戶端的即時資料來源名稱與擷取資料來源的時間間隔。

預設值: 30 分鐘

可設定

checkRefreshDataSourcesIntervalBridge 用戶端檢查分配給用戶端的資料來源以確定舊版計劃是否需要重新整理的時間間隔。

預設值:5 秒

可設定

extractRefreshTimeout對用戶端執行的重新整理強制執行時間限制。逾時限制是單一擷取在被用戶端取消之前完成一次重新整理可允許使用的最長時間。如果因為達到逾時限制而取消擷取重新整理,您將在用戶端中看到訊息,同時會向資料來源擁有者傳送電子郵件通知。

預設值:24 小時。

對於虛擬連線,預設擷取重新整理逾時限制為 2 小時,並且由 Tableau Cloud 控制。該時間限制不能由 Bridge 用戶端控制。

可設定

maxRemoteJobConcurrency適用於線上排程。用戶端允許的最大遠端重新整理作業數。此設定的值必須小於或等於 connectionPool。將最大值調整為電腦的容量,比如 CPU 和 RAM。需要重新啟動用戶端。

預設值:10

最小值:1

最大值:conectionPool 的值

可設定

JSONLogForExtractRefresh設定為 true 後,用戶端會產生一個 JSON 格式的額外記錄檔。該記錄捕獲資料擷取重新整理的指標,包括舊版與遠端重新整理,每個擷取一行。

Tableau Desktop 可讀取 JSON 記錄檔格式,並可作為資料來源以建立即時視覺效果。有關詳情,請參閱 JSON 檔

記錄檔範例是: ExtractRefreshMetrics_<timestamp>.json
變更此設定選項的值需要重新啟動該 Bridge 用戶端。

loggerSettings 設定選項適用於 JSON 記錄檔。

預設值:false

可設定

dataSources適用於舊版排程重新整理作業。使用者不可編輯。
為基於檔案的資料來源提供對應的本機檔案位置清單。

不可設定

範例

為了控管資料擷取或重新整理的濫用,可以使用 extractRefreshTimeout(也稱為逾時限制)對用戶端執行的重新整理強制執行時間限制。逾時限制是單一擷取在被用戶端取消之前完成一次重新整理可允許使用的最長時間。

附註:對於虛擬連線的擷取,extractRefreshTimeout 預設為 2 小時,且無法由 Bridge 用戶端控制。作為替代方案,您可以修改虛擬連線,以在預設的 2 小時窗格內重新整理或切換到已發佈資料來源。

預設情況下,用戶端的逾時限制設定為 24 小時。您可以透過 Bridge 設定檔變更用戶端的逾時限制。如果因為達到逾時限制而取消擷取重新整理,您將在用戶端中看到訊息,同時會向資料來源擁有者傳送電子郵件通知。

必須重新啟動用戶端以便對設定檔所做的任何變更生效。

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

loggerSettings

設定:loggerSettings

選項:

maxLogFileSizeInMB記錄檔大小上限(以 MB 為單位)。記錄檔超過該大小上限後,會建立新記錄檔。

預設值:25 MB。

可設定

maxBackupLogFileCount允許的 Bridge 記錄檔數上限。記錄檔數量超過上限後,將刪除最舊的記錄檔。

預設值為 40。

可設定

remoteRequestLogFileLifeSpan對於每個傳送到用戶端的 Bridge 重新整理作業,都會建立一組新的記錄檔:

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

預設情況下,如果記錄檔數量超過 maxBackupLogFileCount,記錄檔在刪除前保留在「Logs」資料夾中的最長時間為 8 小時。否則,這些記錄檔將無限期保留,而記錄檔的數量小於或等於 maxBackupLogFileCount

<process_id>表示 Windows 處理程序 ID。

預設值:8 小時

可設定

範例

用戶端在其正常操作過程中會建立活動記錄。您可以使用這些記錄檢視重新整理,使用 Bridge 疑難排解問題,或 Tableau 支援要求您提供記錄以幫助解決問題。

您可以管理 Bridge 記錄檔的大小或增加記錄檔在 TabBridgeClientConfiguration.txt 檔中刪除之前的保留時間。

附註:名為 tabprotosrv* 的記錄檔與其他 Bridge 記錄檔不同。其大小上限為 1 MB,允許的記錄檔案數上限為 8192。這些值也是不可設定。

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

dataSyncRestartInterval

設定:dataSyncRestartInterval

設定資料同步的重啟間隔。

可設定

internetConnectionMonitorInterval

設定:internetConnectionMonitorInterval

Bridge ping 網際網路以確定是否存在有效連線的時間間隔。

預設值:30 秒

可設定

secureStorageMonitorInterval

設定:secureStorageMonitorInterval

Bridge 決定安全儲存空間的間隔。

不可設定

cleanUpTempDirOnStartUp

設定:cleanUpTempDirOnStartUp

確定是否在 Bridge 用戶端啟動時刪除臨時文件。

預設值:true

可設定

JSONLogForLiveQuery

設定:JSONLogForLiveQuery

設定為 true 後,用戶端會產生一個 JSON 格式的額外記錄檔。記錄捕獲即時查詢請求的指標,每次擷取一行

Tableau Desktop 可讀取 JSON 記錄檔格式,並可作為資料來源以建立即時視覺效果。有關詳情,請參閱 JSON 檔。

變更此設定選項的值需要重新啟動該 Bridge 用戶端。

預設值:true

可設定

範例

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

預設設定檔

若要複製預設設定檔,請按一下右上角的複製到剪貼簿圖示。

{
	"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
}
感謝您的意見反應!已成功提交您的意見回饋。謝謝!