Skip to main content

Controller(控制器)

控制器管理服务设置并将工作委派给工作程序。在一个部署中,您只能启用一台计算机作为控制器。

System Settings(系统设置)中的Controller(控制器)屏幕上配置控制器组件。如果您在Environment(环境) > Setup Type(设置类型)屏幕上选择了以下选项之一,则在System Settings(系统设置)中会显示Controller(控制器)屏幕:

  • Designerand Scheduler Only(仅限 Designer 和计划程序)

  • Complete Alteryx Server(完整的 Alteryx Server)

  • Custom(自定义) > Enable Controller(启用控制器)

常规配置

Controller Configuration屏幕包括配置选项,例如要用于存储临时文件和日志文件的位置以及要记录的信息。

Screenshot of Controller General Configuration screen which includes the following settings: Controller Token, Workspace, Logging, Scheduler, Insights

控制器令牌

控制器Token是一个自动生成的密钥,控制器使用该密钥与使用 Designer 的工作程序和计算机进行通信。

如果使用 Designer 的计算机不是控制器计算机,并且您希望在这台计算机上计划未来某个日期的工作流,则必须在Schedule Workflow(计划工作流)屏幕上添加控制器令牌,以计划工作流。

如果要让一台计算机充当控制器,另一台计算机充当工作程序,您也需要控制器令牌。设置控制器计算机以获取控制器令牌。然后,在设置工作程序计算机时,在System Settings(系统设置) > Controller(控制器) > Remote(远程)中添加控制器令牌。

如有必要,您可以重新生成令牌,比方说,在令牌被盗用的情况下。如果您重新生成令牌,则必须也在部署中的 Server UI 和工作程序节点进行更新。如果要重新生成令牌,请单击Regenerate(重新生成)

Workspace(工作区)

Workspace(工作区)是控制器存储临时文件或缓存文件的位置。默认情况下,该文件夹位于 System Settings(系统设置)的 Environment(环境)屏幕中定义的全局工作空间文件夹中。请使用可安全存储大量文件的位置。

Logging(日志记录)

控制器为诸如服务已启动和已关闭之类的事件以及执行请求等生成日志。这些日志有助于进行故障排除。如需了解详情,请访问Configure and Use Server Logs(配置和使用 Server 日志)

Scheduler(计划程序)

选择Enable Scheduler auto-connect(启用计划程序自动连接),以允许计算机上的用户自动连接至计划程序。如果在连接至计划程序时遇到困难,请启用此选项。

洞察

选择Enable Insights(启用洞察),以允许该机对在Server 中呈现洞察的请求进行处理。洞察是在 Designer 中创建的交互式仪表板。

Engine(引擎)

选中 Enable AMP Engine(启用 AMP Engine),以支持在此环境中运行使用 Alteryx 多线程处理 (AMP) 引擎的工作流。在 Server 环境,这是开/关式设置。如果您为控制器启用 AMP Engine,则还需要在System Settings(系统设置) > Engine(引擎)屏幕上设置至少一个工作程序来运行 AMP Engine。如需了解详情,请访问Engine(引擎)AMP Engine 最佳实践帮助页面。

了解 AMP Engine 设置

对于 Server 环境,System Settings > Controller屏幕上的Enable AMP Engine(启用 AMP Engine) 设置是开/关式设置。此设置在环境级别启用 AMP。System Settings > Engine中的设置告诉工作程序可以使用哪些引擎,从而可以运行哪些工作流。如需了解详情,请访问Engine(引擎)AMP Engine 最佳实践帮助页面。

例如,让我们以一个 3 节点环境为例。节点 1 已为控制器和 Server UI 进行设置并启用了 AMP。节点 2 是工作程序专用的节点,其引擎设置为仅限原始引擎。节点 3 是工作程序专用的节点,其引擎设置为Both Engines(两类引擎)。在此情景中,启用了在 Server 上运行 AMP 工作流的选项,这些工作流将仅在节点 3 上运行。原始引擎工作流将在节点 2 或节点 3 上运行。如果节点 3 脱机,原始引擎工作流仍将在节点 2 上运行,但 AMP 工作流将卡在队列中,直到节点 3 恢复联机为止。

我们建议在将 AMP Engine 部署到生产环境之前,在开发环境中对其进行测试。如需详细了解 AMP Engine,包括内存要求,请参阅 AMP Engine 文档AMP Engine 最佳实践Alteryx AMP Engine

持久层

作为工作流执行和各种其他操作的编排器,控制器需要一个可以维护可用工作流、执行请求队列和其他信息的位置。在持久层屏幕上定义对服务运行至关重要的信息的存储位置。

Screenshot of Controller Persistence screen which includes the following settings: Database Type, Data Folder, Advanced Database Connection, Database, and Persistence Options

Database Type(数据库类型)

控制器通过 SQLite 或 MongoDB 数据库维护数据。Server 提供嵌入式 SQLiteMongoDB 选项,以及User-Managed MongoDB(用户管理的 MongoDB) 选项。如果要为 Server UI 配置计算机,则必须使用 MongoDB用户管理的 MongoDB

  • SQLite:创建 SQLite 数据库的实例。建议用于使用计划程序的轻量级和本地部署。

  • MongoDB:创建 MongoDB 数据库的实例。如使用量很大建议此选项。

  • User-Managed MongoDB:允许连接至您的 MongoDB 实现。

重要

  • 对于用户管理的 MongoDB,我们仅支持使用 SCRAM 身份验证的 MongoDB。不支持使用 Kerberos 身份验证的 MongoDB。

  • 我们强烈建议您为持久层数据库建立自动备份系统。如需了解如何备份 MongoDB,请转至 MongoDB 备份。要备份 SQLite,您可以压缩或复制 \ProgramData\Alteryx\Service\ 中的 Persistence 文件夹。

  • 如果在 SQLite 和 MongoDB 数据库类型之间切换,则不会迁移计划作业。必须手动重新计划这些作业。

Data Folder(数据文件夹)

Data Folder(数据文件夹)是 SQLite 或嵌入式 MongoDB 数据库文件的存储位置。如果您选择User-Managed MongoDB,则Data Folder将被禁用,因为它是在您的 MongoDB 实例中配置的。

高级数据库连接

如果您需要相关支持,请选择Advanced User-Managed MongoDB(高级用户管理的 MongoDB)

  • TLS/SSL

  • Replica Sets(副本集)

  • Sharding(分片)

  • MongoDB Atlas

重要

如果您在连接字符串(connection string)选项推出之前(2020.1 版或以前的版本)使用了副本集,则必须更改为连接字符串。

选择此选项后,Database(数据库)部分将显示一个 MongoDB Connection字段,供您指定 MongoDB 连接字符串。访问Advanced Connection String(高级连接字符串)帮助页面,获取有关指定连接字符串的提示和示例。

Screenshot of Advanced User-Managed MongoDB selected and the corresponding MongoDB Connection field that appears in the Database section

Database(数据库)

如果您选择了User-Managed MongoDB(用户管理的 MongoDB),并且没有使用Advanced Database Connection(高级数据库连接),那么您将在Database(数据库)部分指定 MongoDB 实例的Host (主机)位置以及Database Name(数据库名称)。如果 MongoDB 实例需要身份验证,请在Username(用户名)Admin Password(管理员密码)字段中输入这些信息。

Screenshot of Database settings when User-managed MongoDB option is selected

对于嵌入式 MongoDB,系统会自动填充Host(主机)Username(用户名)Admin Password(管理员密码)Password(密码)字段。该Admin Password(管理员密码)供 MongoDB 管理员用于设置备份和副本集。所有组件都使用该Password(密码)与 MongoDB 进行通信。您还可以使用该Password(密码)来创建与数据库相关联的使用情况报告。

Screenshot of Database settings when MongoDB option is selected

用户名、密码或参数值中的特殊字符必须进行 URL 编码。

Persistence Options(持久层选项)

数据库维护工作流结果、计划和上传文件的历史记录。您可以将各种项目和文件标记为在指定天数后删除。这些设置会减少 Server 使用的硬盘驱动器空间。

重要

  • 持久层选项具有追溯性。如果将所有持久层选项设置为10天后删除,则工作流结果、计划和文件的历史记录将仅显示最近10天的数据。

  • 这些设置还将应用于 Server Usage Report (Server 使用情况报告)的可用历史记录。

  • 对于所有持久层选项,处于错误状态的记录不会予以删除。

  • Delete queue and results after (days)(天数)【(天数)后删除队列和结果】:在指定天数后从数据库和工作流结果中删除已完成的作业。

  • Delete completed schedules after (days)【(天数)后删除已完成的计划】:删除在指定天数后State(状态)Completed(已完成)的计划。

  • Delete uploaded files after (days)【(天数)后删除上传的文件】:在指定天数后删除通过分析应用程序上传到 Server UI 的文件。

重要

我们建议您采用定期备份节奏,并启用在 180 天(或您选择的非零值)后删除队列和结果、完成的计划和上传的文件。如果将值设置为 0,项目将无限期保留。

Benefits(优点):这减少了硬盘空间的使用,并减小了 Server Usage Report(Server 使用情况报告)输出的大小。

测绘配置

Mapping Configuration(测绘配置)屏幕上,将计算机配置为地图控制器并定义图块和图层缓存的阈值。缓存地图图块和渲染它们所需的参考地图可提高性能。更大的缓存体积和更长的生存时间会导致对先前请求的图块的响应更快,但会占用更多的内存和磁盘空间。较小的缓存会产生相反的效果。

  • Enable map tile controller(启用地图图块控制器):选择“启用地图图块控制器”以允许计算机处理工作程序渲染的地图图块。“地图问题”和“地图输入”工具使用这些图块来渲染地图。

    • of tiles) 图块数:这是存储在内存中的最大地图图块数。1,000 个图块需要大约 450 MB 内存。内存缓存越高,存储的图块越多,性能越高,但需要的系统资源也越多。

    • Disk cache (MB)【磁盘缓存 (MB)】:这是为在硬盘上缓存地图图块图像分配的最大空间量。磁盘缓存越高,硬盘空间消耗越大,但可能会提高地图图块请求的性能。

    • Reference layer time to live (seconds)【引用图层生存时间(秒)】:“地图问题”和“地图输入”工具创建参考图层并由 YXDB 文件驱动。控制器可以维护对此 YXDB 文件的引用,以帮助加速渲染。此设置将定义用于保留引用图层信息的时间量。增加该数量可以优化频繁请求的图层的性能。下次请求时会重新生成过期的引用图层。

Remote Controller(远程控制器)

如果您已将计算机配置为工作程序,则Remote Controller(远程控制器)屏幕是Controller(控制器)下唯一的屏幕。这是将计算机连接至控制器计算机的位置。输入主机位置和控制器令牌以连接至控制器计算机。

  • Host(主机):输入控制器计算机的主机位置。

  • 令牌:输入控制器计算机令牌。您可以在控制器计算机的“系统设置”中 Controller > General 屏幕上找到 Controller Token。转至本文中的General 配置部分。

选择View(查看)Hide(隐藏)以显示或隐藏控制器令牌字符。

Screenshot of the Controller Remote screen which shows the Host and Token fields

下一步操作

配置Worker(工作程序)