變更 Bridge 用戶端設定
網站管理員可以對多個 Bridge 用戶端設定進行設定,以變更用戶端的執行方式。
Windows 用戶端
對於 Windows 用戶端,設定檔的預設位置是 C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt
。必須重新啟動用戶端以便對設定檔所做的任何變更生效。
為容器設計,適用於 Linux 的 Bridge
TabBridgeClientConfiguration.txt
檔案會在第一次執行 Bridge 用戶端時使用預設設定產生。
若要變更設定設定,請編輯 TabBridgeClientConfiguration.txt
檔案,並使用更新的檔案建立新的 Docker 容器。有關如何建立與更新容器的更多資訊,請參閱 容器化應用程式。
Bridge 舊版排程
在某些情況下,如果資料來源擁有者維護自己的用戶端執行 Bridge 舊版排程,則他們有責任處理本主題中描述的某些工作。
Bridge 用戶端設定
serviceConnectionSettings
設定:serviceConnectionSettings
選項:
serviceUrl | Tableau 站台 URL。 不可設定。 |
proxyServer | Proxy 伺服器與連接埠。 可設定 |
範例
必須重新啟動用戶端以便對設定檔所做的任何變更生效。
"serviceConnectionSettings" : {
"serviceUrl" : "https://online.tableau.com",
"proxyServer" : {
"serverName" : "http://localhost",
"serverPort" : 8888
}
connection
設定:connection
選項:
connectTimeout | Bridge 用戶端在嘗試連線到 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 | 套用至 Bridge 重新整理排程。 登入時產生的重新整理權杖數。需要到 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 | 臨時下載分配給 Bridge 舊版排程用戶端的即時資料來源名稱與擷取資料來源的時間間隔。 預設值: 30 分鐘 可設定。 |
checkRefreshDataSourcesInterval | Bridge 用戶端檢查分配給用戶端的資料來源以確定 Bridge 舊版排程是否需要重新整理的時間間隔。 預設值:5 秒 可設定。 |
extractRefreshTimeout | 對用戶端執行的重新整理強制執行時間限制。逾時限制是單一擷取在被用戶端取消之前完成一次重新整理可允許使用的最長時間。如果因為達到逾時限制而取消擷取重新整理,您將在用戶端中看到訊息,同時會向資料來源擁有者傳送電子郵件通知。 預設值:24 小時。 對於虛擬連線,預設擷取重新整理逾時限制為 2 小時,並且由 Tableau Cloud 控制。該時間限制不能由 Bridge 用戶端控制。 可設定。 |
maxRemoteJobConcurrency | 套用至 Bridge 重新整理排程。用戶端允許的最大遠端重新整理作業數。此設定的值必須小於或等於 connectionPool。將最大值調整為電腦的容量,比如 CPU 和 RAM。需要重新啟動用戶端。 預設值:10 最小值:1 最大值: 可設定。 |
JSONLogForExtractRefresh | 設定為 true 後,用戶端會產生一個 JSON 格式的額外記錄檔。該記錄捕獲資料擷取重新整理的指標,包括 Bridge 舊版與遠端重新整理,每個擷取一行。 Tableau Desktop 可讀取 JSON 記錄檔格式,並可作為資料來源以建立即時視覺效果。有關詳情,請參閱 JSON 檔。 記錄檔範例是:
預設值:false 可設定。 |
dataSources | 套用於 Bridge 舊版排程重新整理作業。使用者不可編輯。 為基於檔案的資料來源提供對應的本機檔案位置清單。 不可設定 |
範例
為了控管資料擷取或重新整理的濫用,可以使用 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 重新整理作業,都會建立一組新的記錄檔:
預設情況下,如果記錄檔數量超過
預設值: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
}