---
schema_version: "1"
id: 71f3a66de250cff2de1769f8349dcd8e112deb032a98186908bfcded8db13b74
title: 更改 Bridge 客户端设置
collection: tableau
version: current
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/current/zh-cn/online/to_sync_change_computer_site.md
canonical_url: https://help.tableau.com/current/online/zh-cn/to_sync_change_computer_site.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 785cac7016faa31bbf64d263b308219fdbdfdf1bcc9e25e4a222ef5962151f1d
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>代理服务器和端口。<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 后每个服务器（例如 VizPortal）API 调用的 Bridge 客户端等待时间。<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-cn/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
}
```

## 此部分中的其他文章