配置 、管理Bridge 客户端池
- 版本 :2022.1 及更高版本
本主题介绍站点管理员如何配置和管理 Bridge 客户端的池化。池化允许站点中的客户端对连接到私有网络数据的数据源或虚拟连接的数据新鲜度任务进行负载平衡。
配置池化
池的目的是在池中的可用客户端之间分摊(或平衡)数据新鲜度任务的负载,该池的访问范围限于您私有网络中的域。池映射到域,使您能够通过限制对私有网络中受保护域的访问,将池专用于使特定数据保持最新和维护安全。
尽管池中用于执行数据新鲜度任务的客户端是随机选择的,但如果出于任何原因客户端无法再执行任务,则系统会自动该任务重新路由到池中的另一个可用客户端来处理该任务。客户端池的支持或和管理无需您或用户进行额外干预。
池优化用于使连接到一个或多个私有网络上的数据的数据源或虚拟连接保持最新。池化支持不会扩展到使用 Bridge(旧版)计划的数据源。
通常会针对以下情况对池化进行优化。
Bridge 被用作关键服务。您的组织要求实时查询和计划刷新支持必须可用(即使在客户端变得不可用的情况下也是如此)。
客户端满负荷运行。您的现有站点流量超出客户端的当前容量。
Tableau Online 管理的基于文件的数据源的计划。从 Bridge 客户端版本 2021.4.3开始,Bridge 池为基于文件的数据源启用 Online 计划。
在多个私有网络上使数据保持最新。
虚拟连接。需要数据管理加载项。需要 Bridge 来刷新连接到私有网络数据的虚拟连接中的数据。有关虚拟连接的详细信息,请参见关于虚拟连接和数据策略。
在配置池化之前
在为站点配置客户端池之前,请查看以下内容:
客户端必须已安装并正在运行。
客户端配置为以服务方式运行。有关详细信息,请参见应用程序模式与服务模式。
在客户端中经过身份验证的用户是 Tableau Online 站点管理员。有关部署 Bridge 的详细信息,请参见计划 Bridge 部署。
为了使虚拟连接保持最新,请确保池中的所有客户端都运行 Bridge 2021.4(或更高版本)。
若要对基于文件的数据源进行负载平衡,请确保池中的所有客户端都运行 Bridge 2021.4.3(或更高版本)。
有关用户角色的注释
只有站点管理员或者具有“站点管理员”或“站点管理员 Creator”角色的用户才能配置和维护池化客户端。无论在客户端中进行身份验证的用户类型如何,只有站点管理员才能添加新池、将客户端添加到池、从池中移除客户端,并监视池中的客户端。
步骤 1:确保客户端可以连接到站点
为了使 Bridge 能够处理您的站点,您必须允许客户端向站点进行身份验证。
使用站点管理员凭据登录到 Tableau Online,并转到“设置”页面。
单击“身份验证”选项卡,并验证“连接的客户端”标题下的“允许客户端自动连接到此 Tableau Online 站点”复选框是否处于选中状态。有关此复选框的详细信息,请参见从连接的客户端中访问站点。
注意:如果启用,则必须启用连接的客户端选项以支持包含 Tableau 身份验证的多重身份验证。如果为站点禁用了已连接客户端,则 Bridge 只能支持 Tableau 用户名和密码身份验证。
步骤 2:配置池
需要 Bridge 2021.4(或更高版本)客户端的池有助于将实时查询和数据提取刷新作业路由到适当的私有网络。使用池访问分布在多个私有网络中的数据,为基于文件的数据源启用数据提取刷新,并支持虚拟连接的数据新鲜度任务。
在“Bridge”选项卡上的“池化”下,单击“添加新池”按钮。
在对话框的“池”文本框中输入新池名称,然后单击“保存”。
在您至少配置了一个池后,Tableau Online 会在发布过程中自动将某些数据源或虚拟连接与 Bridge 和客户端池相关联。
步骤 3:为池指定域
每个新池都需要通过私有网络允许列表指定一个域。Bridge 需要此信息才能代表 Tableau Online 访问专用网络中的数据。
使用允许列表,您必须指定要启用客户端访问权限的私有网络的域名或 IP 地址。
域名
您在允许列表中指定的域名是数据源连接或虚拟连接中使用的服务器名称。在某些情况下,您可以在 Tableau Online 的数据源页面的“连接”选项卡中找到列出的服务器名称。
例如,为了使“Starbucks”等数据源保持最新,您可以在允许列表中指定“mssql.myco.lan”和“oracle.myco.lan”或“*.myco.lan”。
若要使“Fitness Challenge”等数据源保持最新状态,请在允许列表中指定“fitness-challenge”。
在其他情况下,“连接”选项卡可能不会列出服务器名称。如果未列出服务器名称,请考虑与内容所有者合作确定数据的托管位置,并在获得该信息后在允许列表中指定服务器名称。作为临时替代方案,您可以跳到步骤 4:将客户端添加到池以指定客户端改为使用默认池。
IP 地址
您可以在允许列表中指定 IPv4 地址,而不是域名。如果在数据源连接或虚拟连接中使用 IPv4 地址,我们建议您在允许列表中指定 IPv4 地址。考虑与您的内容所有者合作以获取此信息。如果您没有该信息,作为临时替代方案,您可以跳到步骤 4:将客户端添加到池以指定客户端改为使用默认池。
注意:
出于安全考虑,允许列表默认为空以防止 Tableau 访问。这可确保站点管理员指定可以使用 Bridge 将哪些数据发送到 Tableau Online。
可以将一个或多个域分配给池。
如果您的站点在 Tableau 2021.4 之前设置为使用池化,则出于向后兼容性目的“默认池”会保留,但无法配置为访问特定私有网络。为减少此池的访问范围并启用更高级的调度功能,我们建议您创建新池并将其映射到特定域。
若要将域映射到池,请执行以下操作:
在“Bridge”选项卡上的“私有网络允许列表”下,单击“添加新域”按钮。
在“域”文本框中,使用允许列表注册表规则中描述的信息输入域的 URI。
在“域权限”下,确保选中“允许”单选按钮。
在“池”下选择池,该池的访问范围应限制为您在步骤 2 中指定的 URI。
为每个其他域重复步骤 1-4。
完成后单击“保存”。
允许列表注册表规则
指定要启用 Bridge 访问的域时,请使用以下规则。这允许 Bridge 代表 Tableau Online 访问您私有网络上的数据以执行数据新鲜度任务。域使 Bridge 能够连接到托管在该域中的数据库和文件数据。
注意:
在添加到允许列表、发布数据源或虚拟连接,或在配置刷新计划当时不会验证域。
由于未验证域名及其 IP 地址,因此将同一域添加到允许列表中导致重复。在这种情况下,如果一个池映射到域名,另一个池映射到 IP 地址,则数据源连接或虚拟连接中指定的格式决定了哪个池保持数据最新。
域必须可由 Bridge 访问。这意味着,池中的所有客户端都必须有权访问指定的域。
如果未指定域,Bridge 无法为针对 Online 计划配置的数据源或虚拟连接运行数据新鲜度任务。注意:针对 Bridge(旧版)计划配置的数据源将继续以相同方式运行。
方案 | 说明 | 示例 |
数据提取域名 | 可以是 FQDN 或 PQDN。不允许使用端口号。 | myco.com |
域名范围 | 使用可选的前导通配符 (*) 以包含所有子域。* 后面必须直接跟一个句点 (.)。 | *.myco.com |
确切的 IPv4 地址 | 使用 IPv4 文字(不允许使用缩写)。不允许使用 IPv6 地址。 | 255.255.0.1 |
阻止域 | 阻止 Bridge 与此域中主机连接。 | 在私有网络许可列表中添加或编辑域时,选择“阻止”单选按钮选项。 |
允许列表注册表示例
示例 1 - 数据库数据
假设您希望 Bridge 执行以下操作:
对位于 data.lan 和 sqlserver.myco.lan 中的数据执行数据新鲜度任务。
阻止位于 oracle.myco.lan 中的数据的数据新鲜度任务。
为了使 Bridge 能够支持这些方案,您可以将域映射到两个池(A 和 B)并阻止第三个域。
如果指定... | 并映射到池... | ...数据在位置中刷新 |
*.lan | 池 A | data.lan |
sqlserver.myco.lan | 池 B | sqlserver.myco.lan |
*.myco.lan 注意:尽管此域范围会阻止 oracle.myco.lan 上的数据新鲜度任务,但如果明确允许该域(例如 sqlserver.myco.lan),则被阻止的域范围可以解除对其中的特定域的阻止。 | (已阻止) | - |
示例 2 - 文件数据
假设您有位于 fileserv.myco.lan上的文件数据 C:\Shared\employees.csv。若要启用 Bridge 对此数据的访问,请将计算机的域映射到池。您可以为池指定以下域之一:
选项 #1:*.lan
选项 #2:*.myco.lan
选项 #3:fileserv.myco.lan
注意:主机计算机必须允许对“共享”文件夹的网络访问。
步骤 4:将客户端添加到池
按照以下步骤分配尚未分配到池的客户端。
注意:若要支持所有数据的数据新鲜度任务,请确保池中的客户端运行 Bridge 2021.4(或更高版本)。
在 “取消分配客户端”表的“Bridge”选项卡上,导航到要分配给池的客户端,然后单击“分配”。
在“池”下拉菜单中,选择要与客户端关联的池。
为要分配给池的每个未分配客户端重复步骤 2。
池化疑难解答
Bridge 刷新作业失败,并出现下列错误之一。
可能会在“作业”页面和“非数据提取后台任务”管理视图上看到以下错误。
“errorID=NO_POOLED_AGENTS_ASSIGNED”
由于以下两个原因之一,可能会发生此问题:
当数据源的服务器地址或 IP 地址与专用网络允许列表中指定的域不匹配时。这会导致将刷新作业发送到没有分配客户端的默认池。若要解决此问题,请确保 1) 允许列表包含数据源使用的域(服务器地址或 IP 地址),以及 2) 至少一个池与这些域(服务器地址或 IP 地址)相关联。有关详细信息,请参见步骤 3:为池指定域。
当池中没有客户端时。若要解决此问题,请至少向池中添加一个 Bridge 2020.2 (或更高版本)客户端。有关详细信息,请参见步骤 4:将客户端添加到池。
“errorID=NO_AGENT_IN_POOL_SUPPORTS_REMOTE_EXTRACT_REFRESH”
当刷新作业尝试在池中没有至少一个 Bridge 2020.2(或更高版本)客户端的情况下运行时,可能会出现此问题。若要解决此问题,请至少向池中添加一个 Bridge 2020.2 (或更高版本)客户端。有关详细信息,请参见步骤 3:为池指定域。
“errorID=NO_POOLED_AGENTS_CONNECTED”
当池中的任何客户端都无法运行数据新鲜度任务时,可能会出现此问题。有关详细信息,请参见上面的配置 Bridge 客户端池部分。
客户端中的“errorID=REMOTE_EXTRACT_REFRESH_ALL_AGENTS_BUSY”或“errorMessage: Maximum concurrency reached”
如果在给定时间运行的刷新作业数超过客户端池的容量,则可能会出现这些问题。为了帮助解决此问题,您可以执行以下操作:
将其他客户端添加到池中。有关详细信息,请参见步骤 4:将客户端添加到池。
增加每个客户端上的 connectionPool 设置的大小。有关详细信息,请参见管理 Bridge 池的大小。
“errorID= AGENTS_IN_POOL_REQUIRE_UPGRADE”
从 Tableau 2021.4 开始,当池中的客户端需要升级到 Bridge 2021.4(或更高版本)以运行数据新鲜度任务时,可能会出现此问题。有关升级客户端的详细信息,请参见安装 Bridge。
Bridge 客户端被注销
如果在同一 Windows 服务帐户下部署大量客户端,则可能发生此问题。当一个 Windows 服务帐户下运行的客户端超过 10 个时,帐户安全措施可能会导致客户端注销。有关详细信息,请参见Windows 服务帐户。
其他潜在的池化问题
尝试诊断与池化相关的问题时,请考虑查看 Bridge 客户端计算机上客户端的以下日志文件:tabbridgeclijob_<进程 id>、jprotocolserver_<进程 id>、stdout_jprotocolserver_<进程 id>。有关详细信息,请参见管理 Bridge 日志文件。
有几种方法可以管理池化 Bridge 客户端。
监视数据新鲜度任务
您可以使用“作业”页面和内置管理视图的组合来监视客户端活动。
实时查询
若要监视实时查询活动,可以使用到 Bridge 连接数据源的流量管理视图。
刷新作业
若要监视刷新作业,可以使用以下资源:
“作业”页面:“作业”页面可以显示使用 Online 计划的已完成、正在进行、待定、已取消和挂起的刷新作业。有关详细信息,请参见关于 Bridge 刷新作业。
“非数据提取后台任务”管理视图:在“通过 Bridge 刷新数据提取”上进行筛选后,此管理视图显示使用 Online 计划的 Bridge 刷新作业。有关详细信息,请参见非数据提取后台任务。
“Bridge 数据提取”管理视图:此管理视图显示使用 Online 计划和 Bridge(旧版)计划的 Bridge 刷新作业。有关此视图的详细信息,请参见Bridge 数据提取。
使用客户端日志创建数据源或视图:使用客户端生成的 JSON 日志文件,创建您自己的数据源和视图以监控刷新作业。有关详细信息,请参见下面的按客户端刷新作业部分。
按客户端刷新作业
作为使用上面列出的管理视图监视刷新作业的替代方法,请考虑创建您自己的数据源和视图来监视 Bridge 客户端执行的刷新。您可以通过使用 Tableau Desktop 连接到运行客户端的计算机上的客户端的 JSON 日志文件来完成此操作。
注意:客户端的 JSON 日志文件不会捕获虚拟连接的刷新。
JSON 日志文件由对象“k”和“v”组成。“k”对象捕获刷新作业,“v”对象捕获刷新详细信息。刷新及其详细信息包括:
计划类型 - Online 或 Bridge(旧版)
数据源类型和名称
刷新起止时间、持续时间、上载发布时间
错误
步骤 1:开始之前
如果您想依据一个日志文件的数据构建一个视图,您可以跳转到“步骤 2”。
如果客户端的数据位于多个日志文件中,则需要合并这些文件。您可以创建脚本以在本地合并日志文件,或使用 Tableau Desktop 执行合并,如以下过程中所述。
注意:
下面描述的过程假设您在与客户端相同的计算机上运行 Tableau Desktop。
如果您正在处理来自池中不同客户端的多个日志文件,除了为客户端合并多个日志文件之外,您还可以合并来自多个客户端的日志文件以监控池中的刷新。
当前不支持直接从 Tableau Online Web 制作连接到 JSON 文件。有关详细信息,请参见 Creator:在 Web 上连接到数据。
步骤 2:连接到 JSON 日志
若要构建数据源和视图,请使用 Tableau Desktop 连接到客户端的日志文件。
启动 Tableau Desktop,并在“连接”下选择“JSON 文件”。执行以下操作:
在“选择架构级别”对话框中,选择顶级架构以包含“k”对象详细信息,并可根据需要选择“v”级别架构以包含“v”对象详细信息,然后单击“确定”。
导航到要连接到的日志文件(例如,C:\Users\jsmith\文档\我的 Tableau Bridge 存储库\Logs),选择它,然后单击“打开”。
(可选)在数据源页面,右键单击日志文件,然后单击“转换为并集”以设置并集。执行以下操作:
选择“通配符(自动)”选项卡。
在“搜索范围”旁边,验证路径是否显示客户端的 Log 文件夹。
在“匹配模式”下,输入“ExtractRefreshMetrics_*”并单击“确定”。
选择工作表标签以开始分析并构建视图。
完成后,将数据源和视图分别发布到 Tableau Online。为确保您的数据源保持最新,您可以在发布后为数据源设置 Bridge(旧版)计划。
请注意,您创建的数据源和视图可能会在没有警告的情况下更改,因为在满足特定日志特定限制后,可能会生成新日志文件并删除旧日志文件。有关这些限制以及如何调整它们的详细信息,请参见更改 Bridge 客户端设置。
管理池和客户端
在“池化”部分下,您可以在 Bridge 部署中看到最多五个池化和客户端相关信息表。
关于池
第一个表由注册到站点的客户端组成,这些客户端按分配到的池进行组织。
第二个表“未分配的客户端”显示未分配给池的客户端。大多数情况下,这些客户端需要先分配到池中,然后才能对实时查询和数据提取刷新作业进行负载平衡。在其他情况下,此表中的客户端可能专用于使用Bridge(旧版)计划刷新数据源。
第三个表“默认池”显示默认池中的客户端。默认情况下,在 Bridge 2021.4 之前配置为使用池化的客户端包含在此池中。由于无法将默认池的域配置为访问特定的私有网络,我们建议您通过创建新池并将其映射到特定域来缩小其访问范围。
您在前三个表中看到的客户端可以告诉您以下信息:
客户端名称(也称为计算机名称)是安装并运行客户端的计算机的名称。
所有者名称,大多数情况下为站点管理员。这是从客户端向 Tableau Online 进行身份验证(登录到 Tableau Online)的用户。
池状态,仅适用于第一个表,可以指示 1) 池中是否有分配的客户端,2) 客户端已连接并可处理数据新鲜度任务,或 3) 池处于脱机状态,因为池中的所有客户端都已断开连接.
客户端版本:
当客户端未运行最新版本的 Bridge 时,此列中将显示一个警告图标 () 。尽管不是必需的,但我们强烈建议您升级以利用最新的安全性和功能更新。若要下载最新版本的 Bridge,请转到 Tableau 网站上的 Tableau Bridge 版本页面。
注意:仅当有较新的客户端可供下载时,警告图标才会显示。警告图标并不表示客户端或相关 Bridge 数据源或虚拟连接存在问题。
连接状态 — 有关详细信息,请参见下面的客户端连接状态。
上次连接 — 显示 Tableau Online 上次能够连接客户端的日期和时间。
关于私有网络允许列表
第四个表“允许列表注册表”包含池限定的域列表。
第五个表“允许列表请求”显示用户在尝试创建虚拟连接时请求连接的待定域。应该尽快处理这些域请求,以解除对用户虚拟连接工作流的阻止。
客户端连接状态
在列出客户端的位置,彩色方块和状态标签指示客户端是否可用于支持数据新鲜度任务。
绿色或“已连接”:绿色或“已连接”状态指明客户端是否已连接并可支持实时查询和数据提取刷新。
红色或“断开连接”:红色或“断开连接”状态可能表示使客户端暂时处于断开状态的几种情况之一。最常见的情况是,客户端未运行或在启动后无法与 Tableau Online 建立通信。可将将鼠标悬停在状态图标上来查看描述条件的工具提示。
注意:
当客户端处于断开连接状态时,实时查询可能会中断。在这种情况下,依赖于具有实时查询的数据源或虚拟连接的视图可能不会正确显示,直到问题得到解决。
上述状态反映您在客户端中看到的状态并与之对应。
站点管理员可以配置若干 Bridge 客户端设置来更改客户端的运行方式。在某些情况下,如果数据源所有者维护自己的客户端以运行 Bridge(旧版)计划,则其可能负责执行本主题中描述的某些任务。
以 Windows 服务形式运行 Bridge
为了将客户端包含在池中,客户端应以 Windows 服务形式运行(“服务”模式)。默认情况下,客户端设置为以 Windows 服务形式运行,以便它可以在后台对实时查询和刷新进行负载平衡,而无需专门的用户登录到计算机。客户端要以 Windows 服务形式运行,运行客户端的 Windows 用户帐户必须是计算机上“本地管理员”组的成员。
注意:如果您是数据源所有者并自行管理客户端,则您的客户端将不会包含在池中。但是,如果您希望即使在未登录到计算机的情况下 Bridge(旧版)计划也在后台运行,则客户端必须以 Windows 服务形式运行(“服务”模式)。
打开 Windows 系统托盘,然后单击 Tableau Bridge 图标以打开客户端。
从“模式”下拉菜单中,选择“服务”。将显示登录窗口。
输入您的本地管理员凭据。
在您的 Windows 服务列表中,Bridge 显示为“Tableau Bridge 服务”。您可以在 Windows 服务控制台中或在任务管理器中的“服务”选项卡上看到此项。
停止以 Windows 服务形式运行 Bridge
若要阻止客户端以服务形式运行,请更改其模式。
打开 Windows 系统托盘,然后单击 Tableau Bridge 图标以打开客户端。
从“模式”下拉菜单中,选择“应用程序”。
当客户端在“应用程序”模式下运行时,只有当用户在客户端从中运行的计算机上登录到 Windows 用户帐户时,实时查询和计划刷新才能运行。
切换与客户端关联的站点
如果您希望使用客户端使发布到其他 Tableau Online 站点的内容保持最新,则可以取消链接现有客户端,并从客户端中向新站点进行身份验证。
打开 Windows 系统托盘,然后单击 Tableau Bridge 图标以打开客户端。
从下拉菜单中,选择“取消链接”。
“取消链接”会从使用 Bridge(旧版)计划、计划和连接信息的客户端中移除数据源列表。
打开 Windows 系统托盘,然后单击 Tableau Bridge 图标以打开客户端。
出现提示时,使用站点管理员凭据登录到新站点。
执行以下一项或两项操作来配置客户端:
如果此客户端刷新与特定客户端关联的数据源,请要求数据源所有者重新配置其数据源并刷新计划。
如果希望此客户端促进实时连接或使用 Online 计划的数据提取连接,请确保新客户端是池的一部分。有关详细信息,请参见配置 Bridge 客户端池
取消链接客户端时,可能还需要为客户端刷新的数据源移除 Bridge(旧版)计划。其他数据源仍然有由池中的其他注册客户端执行的数据新鲜度任务。
有关详细信息,请参见退出和取消链接的影响。
配置刷新的超时限制
为了数据提取或刷新的滥用,您可以为客户端执行的刷新强制实施一个时间限制(也称为超时限制)。超时限制是单一数据提取在被客户端取消之前完成一次刷新允许的最长时间。如果因为达到超时限制而取消了数据提取刷新,您将在客户端中看到一条消息,并且系统会向数据源所有者发送电子邮件通知。
默认情况下,客户端的超时限制设置为 24 小时。您可以通过 Bridge 配置文件更改客户端的超时限制。
注意:必须重新启动客户端以使对配置文件所做的任何更改生效。
在安装了客户端的计算机上,转到“我的 Tableau Bridge 存储库”中的 Configuration 文件夹。
Configuration 文件夹的默认位置为 C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration。
打开 TabBridgeClientConfiguration.txt 文件。
在 extractRefreshTimeout 旁边,更改完成一次刷新任务所允许的时间。
注意:如果在配置文件中未看到参数,您可以像下面的示例中一样,向 dataSourceRefreshSettings 设置中添加 "extractRefreshTimeout" : 08:00:00",。
保存并关闭该文件。
退出并重新启动客户端以使更改生效。您重新启动客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。
对于应用程序模式:从客户端菜单中选择“退出”。
对于服务模式:从“模式”下拉菜单中选择“应用程序”;从客户端菜单中选择“退出”。
管理 Bridge 日志文件
客户端在其正常操作过程中会创建活动的日志。您可以使用这些日志来监视刷新、对 Bridge 问题进行故障排除,或者在 Tableau 支持部门向您请求日志以帮助解决问题时使用。
您可以管理 Bridge 日志文件的大小或增加日志文件在 TabBridgeClientConfiguration.txt 文件中删除之前的保留时间。
可配置选项
maxLogFileSizeInMB
:默认情况下,Bridge 日志文件允许的最大大小为 25 MB。当日志文件超出大小限制时,将会创建新日志文件。maxBackupLogFileCount
:允许的 Bridge 日志文件的最大数量的默认值为 40。当日志文件数量超过限制时,最旧的日志文件将被删除。remoteRequestLogFileLifeSpan
:对于发送到客户端的每个 Bridge 刷新作业,都会创建一组新的日志文件:tabbridgeclijob_<进程 id>、jprotocolserver_<进程 id> 程 stdout_jprotocolserver_<进程 id>。默认情况下,如果日志文件数量超过maxBackupLogFileCount
,日志文件在删除之前保留在 Logs 文件夹中的最长时间为 8 小时。否则,这些日志文件将无限期保留,而日志文件的数量小于或等于maxBackupLogFileCount
。注意:此处 <进程 id> 表示 Windows 进程 ID。
注意:名为 tabprotosrv® 的日志文件与其他 Bridge 日志文件不同。最大大小为 1 MB,允许的日志文件的最大数量为 8192。这些值也是不可配置的。
在安装了客户端的计算机上,转到“我的 Tableau Bridge 存储库”中的 Configuration 文件夹。
Configuration 文件夹的默认位置为 C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration。
打开 TabBridgeClientConfiguration.txt 文件。
在 loggerSettings 旁边,您可以更改以下参数的值:
“maxLogFileSizeInMB”:25
“maxBackupLogFileCount”:40
“remoteRequestLogFileLifeSpan”:“08:00:00”
保存并关闭该文件。
退出然后重新启动客户端以使更改生效。您重新启动客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。
管理 Bridge 池的大小
默认情况下,池中的每个客户端一次最多可对 10 个刷新作业进行负载平衡处理。如果在给定时间运行的刷新作业数超过客户端池的容量,或者您有硬件资源来支持它,请考虑增加每个客户端的容量。
您可以在 TabBridgeClientConfiguration.txt 文件中管理客户端的池化容量。
可配置选项
更改
ConnectionPool
重要信息:下面描述的过程需要取消客户端链接。取消链接将移除站点和客户端之间的关联。这意味着,对于使用 Bridge(旧版)计划刷新的数据源,取消客户端链接将移除与这些数据源的关联、其计划和来自客户端的任何连接信息。在修改 Bridge 池大小的过程中,我们建议您单击 Windows 系统托盘中的 Bridge 图标,并记下列出的数据源(步骤 5),以帮助重新计划过程(步骤 10)。
对于应用程序模式:从客户端菜单中选择“退出”。
对于服务模式:从客户端菜单中选择“退出”。在对话框中,选中“退出客户端并停止活动”复选框,然后单击“关闭”。
ConnectionPool
:这是客户端允许的绝对最大并发刷新作业数。默认值为 10,允许的最小值为 1,允许的最大值为 100。更改此值需要取消链接客户端。maxRemoteJobConcurrency
:这是客户端允许的最大并发刷新作业数,可用于调整或解决客户端性能问题,而无需更改ConnectionPool
中的绝对值。默认值为 10。此值必须等于或小于为ConnnectionPool
指定的值。更改此值不需要取消链接客户端。对于应用程序模式:从客户端菜单中选择“退出”。
对于服务模式:从“模式”下拉菜单中选择“应用程序”;从客户端菜单中选择“退出”。
在安装了客户端的计算机上,转到“我的 Tableau Bridge 存储库”中的 Configuration 文件夹。
Configuration 文件夹的默认位置为 C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration。
打开 TabBridgeClientConfiguration.txt 文件。
编辑
ConnectionPool
旁边的值。保存并关闭该文件。
(可选)单击 Windows 系统托盘中的 Bridge 图标,并记下列出的数据源以及已为这些数据源配置的刷新计划。
右键单击 Windows 系统托盘中的 Bridge 图标,然后选择“取消链接”。
有关“取消链接”选项的详细信息,请参见退出和取消链接的影响。
退出客户端以使更改生效。您退出客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。
再次启动 Bridge。
出现提示时,使用站点管理员凭据登录 Tableau Online。
(可选)如果对使用 Bridge(旧版)计划的数据源执行步骤 5,请按照添加新的或更新现有 Bridge(旧版)计划中所述的过程重新计划刷新,并高效地将数据源与客户端重新关联。
更改 maxRemoteJobConcurrency
在安装了客户端的计算机上,转到“我的 Tableau Bridge 存储库”中的 Configuration 文件夹。
Configuration 文件夹的默认位置为 C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration。
打开 TabBridgeClientConfiguration.txt 文件。
编辑
maxRemoteJobConcurrency
旁边的值。保存并关闭该文件。
退出客户端以使更改生效。您退出客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。
对于应用程序模式:从客户端菜单中选择“退出”。
对于服务模式:从客户端菜单中选择“退出”。在对话框中,选中“退出客户端并停止活动”复选框,然后单击“关闭”。
再次启动 Bridge。
出现提示时,使用站点管理员凭据登录 Tableau Online。
(可选)如果对使用 Bridge(旧版)计划的数据源执行步骤 5,请按照添加新的或更新现有 Bridge(旧版)计划中所述的过程重新计划刷新,并高效地将数据源与客户端重新关联。