---
schema_version: "1"
id: 9d11b3fbd251917fcb2b327598cbdb451c6be70dcc4eb02c46db2b79b3e73f80
title: 變更 Bridge 用戶端設定
collection: tableau
version: next
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/next/zh-tw/online/to_sync_change_computer_site.md
canonical_url: https://help.tableau.com/v0.0/online/zh-tw/to_sync_change_computer_site.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 02acc5442012b55b92246d1cfa2a1f20bd935d78a50745e91fd08b70c65fa3db
description: Change Tableau Bridge client settings using the configuration file.
---
[跳至主要內容](#main-content)

# 變更 Bridge 用戶端設定

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

## Windows 用戶端

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

## 為容器設計，適用於 Linux 的 Bridge

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

若要變更設定設定，請編輯 `TabBridgeClientConfiguration.txt` 檔案，並使用更新的檔案建立新的 Docker 容器。有關如何建立與更新容器的更多資訊，請參閱 [容器化應用程式](https://docs.docker.com/get-started/02_our_app/)。

## Bridge 舊版排程

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

## Bridge 用戶端設定

### serviceConnectionSettings

設定：`serviceConnectionSettings`

選項：

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>serviceUrl</code></td><td>Tableau 站台 URL。<p><i>不可設定</i>。</p></td></tr><tr><td><code>proxyServer</code></td><td>Proxy 伺服器與連接埠。<p><i>可設定</i></p></td></tr></tbody></table>

#### 範例

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

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

### connection

設定：`connection`

選項：

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>connectTimeout</code></td><td>Bridge 用戶端在嘗試連線到 Tableau Cloud 時的等待時間。<p>預設值: 1 分鐘</p><p><i>可設定。</i></p></td></tr><tr><td><code>operationTimeout</code></td><td>成功連線到 Tableau Cloud 後，Bridge 用戶端等待每個伺服器（例如 VizPortal）API 呼叫的時間。<p>預設值: 15 分鐘</p><p><i>可設定</i>。</p></td></tr><tr><td><code>maxAttemptsToRedirectHttpRequests</code></td><td>對伺服器的 API 呼叫可以從 POD 重新導向 POD。此數字指定每次伺服器 API 呼叫的最大重新導向次數。預設值：20<p><i>可設定</i>。</p></td></tr></tbody></table>

#### 範例

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

### dataSourceRefreshSettings

設定：`dataSourceRefreshSettings`

選項：

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>shutdownTimeoutInSeconds</code></td><td><i>不可設定</i>。</td></tr><tr><td><code>downloadDataSourcesInterval</code></td><td>臨時下載分配給 Bridge 舊版排程用戶端的即時資料來源名稱與擷取資料來源的時間間隔。<p>預設值: 30 分鐘<br></p><p><i>可設定</i>。<br></p></td></tr><tr><td><code>checkRefreshDataSourcesInterval</code></td><td>Bridge 用戶端檢查分配給用戶端的資料來源以確定 Bridge 舊版排程是否需要重新整理的時間間隔。<p>預設值：5 秒</p><p><i>可設定</i>。</p></td></tr><tr><td><code>extractRefreshTimeout</code></td><td>對用戶端執行的重新整理強制執行時間限制。逾時限制是單一擷取在被用戶端取消之前完成一次重新整理可允許使用的最長時間。如果因為達到逾時限制而取消擷取重新整理，您將在用戶端中看到訊息，同時會向資料來源擁有者傳送電子郵件通知。<p>預設值：24 小時。</p><p>對於虛擬連線，預設擷取重新整理逾時限制為 2 小時，並且由 Tableau Cloud 控制。該時間限制不能由 Bridge 用戶端控制。</p><p><i>可設定</i>。</p></td></tr><tr><td><code>maxRemoteJobConcurrency</code></td><td>指定單一用戶端允許的並行遠端重新整理作業（PDS 擷取）的最大數量。<p>預設值：10</p><p>最小值：1</p><p>最大：90</p><p><i>可設定</i>。</p><p>若要套用此設定：</p><ol><li value="1"><p>取消連結用戶端。</p></li><li value="2"><p>重新連結用戶端並登入。</p></li><li value="3"><p>將用戶端指派到具名集區。</p></li></ol><p><b>附註：</b>對於 Windows 使用者，若在變更此設定後應用程式報告錯誤，並要求執行不同的動作，請手動從 Windows 安全儲存空間清除 Bridge 認證。</p></td></tr><tr><td><code>JSONLogForExtractRefresh</code></td><td>設定為 true 後，用戶端會產生一個 JSON 格式的額外記錄檔。該記錄捕獲資料擷取重新整理的指標，包括 Bridge 舊版與遠端重新整理，每個擷取一行。<p>JSON 記錄檔的格式為 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 可讀，並可作為資料來源以建立即時視覺效果。有關詳情，請參閱 <a href="https://help.tableau.com/current/pro/desktop/zh-tw/examples_json.htm">JSON 檔</a>。</p><p>記錄檔範例是：<code>
							ExtractRefreshMetrics_&lt;timestamp&gt;.json</code><br>變更此設定選項的值需要重新啟動該 Bridge 用戶端。</p><p><code>loggerSettings </code> 設定選項適用於 JSON 記錄檔。</p><p>預設值：false</p><p><i>可設定</i>。</p></td></tr><tr><td><code>dataSources</code></td><td>套用於 Bridge 舊版排程重新整理作業。使用者不可編輯。<br>為基於檔案的資料來源提供對應的本機檔案位置清單。<p><i>不可設定</i></p></td></tr></tbody></table>

#### 範例

為了控管資料擷取或重新整理的濫用，可以使用 `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`

選項：

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>maxLogFileSizeInMB</code></td><td>記錄檔大小上限（以 MB 為單位）。記錄檔超過該大小上限後，會建立新記錄檔。<p>預設值：25 MB。</p><p><i>可設定</i>。</p></td></tr><tr><td><code>maxBackupLogFileCount</code></td><td>允許的 Bridge 記錄檔數上限。記錄檔數量超過上限後，將刪除最舊的記錄檔。<p>預設值為 40。<br></p><p><i>可設定</i>。<br></p></td></tr><tr><td><code>remoteRequestLogFileLifeSpan</code></td><td>對於每個傳送到用戶端的 Bridge 重新整理作業，都會建立一組新的記錄檔：<p><code>tabbridgeclijob_&lt;process_id, and if the data source is JDBC-based: fjprotocolserver_&lt;process_id&gt;, and stdout_jprotocolserver_&lt;process_id&gt;</code>。</p><p>預設情況下，如果記錄檔數量超過 <code>maxBackupLogFileCount</code>，記錄檔在刪除前保留在「Logs」資料夾中的最長時間為 8 小時。否則，這些記錄檔將無限期保留，而記錄檔的數量小於或等於 <code>maxBackupLogFileCount</code>。</p><p><code>&lt;process_id&gt;</code>表示 Windows 處理程序 ID。</p><p>預設值：8 小時</p><p><i>可設定</i>。</p></td></tr></tbody></table>

#### 範例

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

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

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

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

### dataSyncRestartInterval

設定：`dataSyncRestartInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>設定資料同步的重啟間隔。</p><p><i>可設定</i>。</p></td></tr></tbody></table>

### internetConnectionMonitorInterval

設定：`internetConnectionMonitorInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>Bridge ping 網際網路以確定是否存在有效連線的時間間隔。</p><p>預設值：30 秒</p><p><i>可設定</i>。</p></td></tr></tbody></table>

### secureStorageMonitorInterval

設定：`secureStorageMonitorInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td>Bridge 決定安全儲存空間的間隔。<p><i>不可設定</i>。</p></td></tr></tbody></table>

#### cleanUpTempDirOnStartUp

設定：`cleanUpTempDirOnStartUp`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>確定是否在 Bridge 用戶端啟動時刪除臨時文件。</p><p>預設值：true</p><p><i>可設定</i>。</p></td></tr></tbody></table>

#### JSONLogForLiveQuery

設定：`JSONLogForLiveQuery`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td>設定為 true 後，用戶端會產生一個 JSON 格式的額外記錄檔。記錄捕獲即時查詢請求的指標，每次擷取一行<p>JSON 記錄檔的格式為 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 可讀，並可作為資料來源以建立即時視覺效果。有關詳情，請參閱 JSON 檔。</p><p>變更此設定選項的值需要重新啟動該 Bridge 用戶端。</p><p>預設值：true</p><p><i>可設定</i>。</p></td></tr></tbody></table>

#### 範例

```
"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
		},
	},
	"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
}
```

## 此區段的其他文章