更改 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。

不可配置

proxyServer代理服务器和端口。

可配置

示例

必须重新启动客户端以使对配置文件所做的任何更改生效。

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

connection

配置:connection

选项:

connectTimeoutBridge 客户端在尝试连接到 Tableau Cloud 时的等待时间。

默认值:1 分钟

可配置。

operationTimeout成功连接到 Tableau Cloud 后每个服务器(例如 VizPortal)API 调用的 Bridge 客户端等待时间。

默认值:15 分钟

可配置

maxAttemptsToRedirectHttpRequests对服务器的 API 调用可以从 POD 重定向到 POD。此数字指定每次服务器 API 调用的最大重定向次数。默认值:20

可配置

示例

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

connectionPool

配置:connectionPool

选项:

size适用于 Online 计划。

登录时生成的刷新令牌数。需要与 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适用于 Online 计划。客户端允许的最大远程刷新作业数。此配置的值必须等于或小于 connectionPool。将最大值调整为您的计算机的能力,例如 CPU 和 RAM。需要重新启动客户端。

默认值:10

最小值:1

最大值:conectionPool 的值

可配置

JSONLogForExtractRefresh设置为 true 时,客户端会生成一个 JSON 格式的附加日志文件。该日志捕获数据提取刷新的指标,包括旧版刷新和远程刷新,每个数据提取一行。

JSON 日志文件的格式是 Tableau Desktop 可读的,并可用作创建实时可视化项的数据源。有关详细信息,请参见 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 格式的附加日志文件。日志捕获实时查询请求的指标,每个数据提取

JSON 日志文件的格式是 Tableau Desktop 可读的,并可用作创建实时可视化项的数据源。有关详细信息,请参见 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
}
感谢您的反馈!您的反馈已成功提交。谢谢!