配置和管理 Bridge 客户端池

本主题介绍站点管理员如何配置和管理 Bridge 客户端的池化。池化允许站点中的客户端对连接到本地数据的数据源的数据新鲜度任务进行负载平衡。

配置池化

池的目的是在池中的可用客户端之间分摊(或平衡)数据新鲜度任务的负载。尽管池中用于执行数据新鲜度任务的客户端是随机选择的,但如果出于任何原因客户端无法再执行任务,则系统会自动该任务重新路由到池中的另一个可用客户端来处理该任务。客户端池的支持或和管理无需您或用户进行额外干预。

池化经过优化,可使连接到关系数据的数据源保持最新。池化支持不会扩展到使用 Bridge(旧版)计划或连接到 文件数据的数据源,因为对于这些情况,计划刷新必须与特定客户端关联。

通常,我们建议在以下情况下进行池化:

  • Bridge 被用作关键服务。您的组织要求实时查询和计划刷新支持必须可用(即使在客户端变得不可用的情况下也是如此)。

  • 客户端满负荷运行。您的现有站点流量超出客户端的当前容量。

在配置池化之前

在为站点配置客户端池之前,请查看以下内容:

  • (必需)客户端必须已安装并正在运行。
  • 客户端配置为以服务方式运行。有关详细信息,请参见应用程序模式与服务模式
  • 在客户端中经过身份验证的用户是 Tableau Online 站点管理员。有关部署 Bridge 的详细信息,请参见计划 Bridge 部署

注意:在 Bridge 2020.2 之前,只能对实时查询进行池化。无法对数据提取的计划刷新进行池化。

有关用户角色的注释

只有站点管理员或者具有“站点管理员”或“站点管理员 Creator”角色的用户才能配置和维护池化客户端。无论在客户端中进行身份验证的用户类型如何,只有站点管理员才能将客户端添加到池、从池中移除客户端,并监视池中的客户端。

步骤 1:确保客户端可以连接到站点

为了使 Bridge 能够处理您的站点,您必须允许客户端向站点进行身份验证。

  1. 使用站点管理员凭据登录到 Tableau Online,并转到“设置”页面。

  2. 单击“身份验证”选项卡,并验证“连接的客户端”标题下的“允许客户端自动连接到此 Tableau Online 站点”复选框是否处于选中状态。有关此复选框的详细信息,请参见从连接的客户端中访问站点

步骤 2:启用池化

除了上面的站点设置之外,还必须配置特定于 Bridge 的设置,以便为站点启用池化。

  1. 在以站点管理员身份登录到 Tableau Online 的同时, 单击“设置”页面上的“Bridge”选项卡。

  2. 在“允许负载平衡”标题下,选中“允许跨 Bridge 客户端进行负载平衡以使本地数据保持最新”复选框。

在为站点启用池化后,作为发布过程的一部分,Tableau Online 会自动将用户和某些数据源与 Bridge 和客户端池关联。

步骤 3:将客户端添加到池

默认情况下,如果在客户端进行身份验证的用户是站点管理员,则所有 Bridge 2020.2(及更高版本)客户端都包含在池中。按照下面的过程添加未自动添加到池或在某些时候从池中删除的客户端。

  1. 在“Bridge”选项卡上的“客户端状态”下,导航到要包含在池中的客户端。

  2. 在“池”列中单击下拉箭头,并选择“默认值”

  3. 为包含在池中的每个客户端重复步骤 2。

管理池化的客户端

有几种方法可以管理池化 Bridge 客户端。

监视数据新鲜度任务

您可以使用“作业”页面和内置管理视图的组合来监视客户端活动。

刷新作业

若要监视刷新作业,可以使用以下资源:

  • 作业”页面:“作业”页面可以显示使用 Online 刷新(以前称为“建议”)计划的已完成、正在进行、待处理、已取消和挂起的刷新作业。有关详细信息,请参见关于 Bridge 刷新作业

  • 非数据提取后台任务”管理视图:在“通过 Bridge 刷新数据提取”上进行筛选后,此管理视图显示使用 Online 刷新(以前称为“建议”)计划的数据源的刷新作业。有关详细信息,请参见非数据提取后台任务

  • Bridge 数据提取”管理视图:此管理视图显示使用 Online 刷新(以前称为“建议”)和 Bridge(旧版)计划的数据源的刷新作业。有关此视图的详细信息,请参见Bridge 数据提取

实时查询

若要监视实时查询活动,可以使用到 Bridge 连接数据源的流量管理视图。

管理注册客户端

在“客户端状态”表中,您可以看到注册到站点的所有客户端的列表,而不只是您向其进行身份验证的客户端。客户端一次只能注册到一个站点。

您在此列表中看到的客户端可以告诉您以下信息:

  • 客户端名称,同时也是安装并运行客户端的计算机的名称。

  • 所有者名称,大多数情况下为站点管理员。这是从客户端向 Tableau Online 进行身份验证(登录到 Tableau Online)的用户。

  • 已池化或未池化:
    • 列为“默认”的客户端包含在池中。这意味着客户端正在对连接到本地关系数据的数据源(实时连接或数据提取连接)的实时查询和计划刷新进行负载平衡。

    • 列为“未池化”的客户端未包含在池中。在大多数情况下,可能不会将客户端包括在池中,因为这些特定客户端已预留出来专门运行 Bridge(旧版)计划,其中包括连接到文件数据的数据源的计划刷新。尽管运行 Bridge(旧版)计划的客户端可以是客户端池的一部分,但无法对刷新本身进行负载平衡。

    注意:无法对池进行分区,以便将实时查询与计划刷新分开处理。

  • 客户端版本:

    • 当客户端未运行最新版本的 Bridge 时,此列中将显示一个警告图标 () 。尽管不是必需的,但我们强烈建议您升级以利用最新的安全性和功能更新。若要下载最新版本的 Bridge,请转到 Tableau 网站上的 Tableau Bridge 版本(链接在新窗口中打开)页面。

      注意:仅当有较新的客户端可供下载时,警告图标才会显示。警告图标并不表示客户端或相关 Bridge 数据源存在问题。

    • 与 Tableau Desktop 集成的客户端(版本 2018.1 及更低版本)将不列出版本号。

  • 连接状态 — 有关详细信息,请参见下面的部分。

  • 上次连接 — 显示 Tableau Online 上次能够连接客户端的日期和时间。

客户端连接状态

在已注册的客户端表中,彩色圆圈和状态标签指示客户端是否可用于支持数据新鲜度任务。

  • 绿色或“已连接”:绿色或“已连接”状态指明客户端是否已连接并可支持实时查询(实时连接)和计划刷新(数据提取连接)。

  • 红色或“断开连接”:红色或“断开连接”状态可能表示使客户端暂时处于断开状态的几种情况之一。最常见的情况是,客户端未运行或在启动后无法与 Tableau Online 建立通信。可将将鼠标悬停在状态图标上来查看描述条件的工具提示。

    注意:

    • 当客户端处于断开连接状态时,实时查询可能会中断。在这种情况下,依赖于具有实时连接的数据源的视图可能会正确显示,直到问题得到解决。
    • 但是,当客户端处于断开连接状态时,数据提取刷新会继续按计划运行,并可以从客户端中启动手动刷新。
  • 无颜色或空白:与 Tableau Desktop(版本 2018.1 及更低版本)集成的客户端无法显示不同的可用性状态。

上述状态反映您在客户端中看到的状态并与之对应。

池化疑难解答

Bridge 刷新作业失败,并出现下列错误之一。

可能会在“作业”页面和“非数据提取后台任务”管理视图上看到以下错误。

  • “errorID=NO_POOLED_AGENTS_ASSIGNED”

    如果池中没有客户端,则可能会出现此问题。若要解决此问题,请至少向池中添加一个 Bridge 2020.2 (或更高版本)客户端。有关详细信息,请参见步骤 3:将客户端添加到池

  • “errorID=NO_AGENT_IN_POOL_SUPPORTS_REMOTE_EXTRACT_REFRESH”

    当刷新计划作业尝试在池中没有至少一个 Bridge 2020.2(或更高版本)客户端的情况下运行时,可能会出现此问题。若要解决此问题,请至少向池中添加一个 Bridge 2020.2 (或更高版本)客户端。有关详细信息,请参见步骤 3:将客户端添加到池

  • “errorID=NO_POOLED_AGENTS_CONNECTED”

    当池中的任何客户端都无法运行数据新鲜度任务时,可能会出现此问题。有关详细信息,请参见上面的客户端连接状态部分。

  • 客户端中的“errorID=REMOTE_EXTRACT_REFRESH_ALL_AGENTS_BUSY”“errorMessage: Maximum concurrency reached”

    如果在给定时间运行的刷新计划作业数超过客户端池的容量,则可能会出现这些问题。为了帮助解决此问题,您可以执行以下操作: 

  • “errorID=SITE_NO_LONGER_HANDLING_LIVE_QUERIES”

    没有为站点启用或关闭 Bridge 池化时,可能会出现此问题。若要帮助解决此问题,请启用池化。有关详细信息,请参见步骤 2:启用池化

Bridge 客户端被注销

如果在同一 Windows 服务帐户下部署大量客户端,则可能发生此问题。当一个 Windows 服务帐户下运行的客户端超过 10 个时,帐户安全措施可能会导致客户端注销。有关详细信息,请参见Windows 服务帐户

其他潜在的池化问题

尝试诊断与池化相关的问题时,请考虑查看 Bridge 客户端计算机上客户端的以下日志文件:tabbridgeclijob_<进程 id>jprotocolserver_<进程 id>、stdout_jprotocolserver_<进程 id>。有关详细信息,请参见管理 Bridge 日志文件

感谢您的反馈!