Skip to main content

引擎奇偶校验实用程序

引擎奇偶校验实用程序是一种比较原始引擎与 AMP Engine 的简单方法。通过它,您可以并行运行两个引擎来评估结果,然后决定您可以放心地将哪个工作流转换为 AMP。

奇偶校验框架是一个命令行工具。不过,为了方便使用该框架,我们提供了一个可以使用 Alteryx 运行命令工具的宏指令。所以您可以选择...

  • 使用 AlteryxEngineCmd. exe 以通过命令行来运行奇偶校验框架。

  • 使用引擎奇偶校验宏指令。

  • 运行引擎奇偶校验分析应用程序。

使用 AlteryxEngineCmd.exe

您可以通过 AlteryxEngineCmd.exe 使用以下参数比较 AMP Engine 和原始引擎的工作流:

  • - testDir(通向工作流的路径):工作流所在的文件夹路径,或要测试的单个 YXMD 文件的路径。此参数必不可少,应该放在最前面。

  • -compareReport(通向 CSV 报告文件的路径):要保存报告的 CSV 文件名。

  • -tempDir(中间文件的路径):保存中介文件的文件夹。默认为运行后删除的 Alteryx 临时文件夹。

  • -compatibleMode(使用/不使用兼容模式运行 AMP Engine):布尔参数,默认情况下为“False”。如果设置为“True”,AMP Engine 将在兼容模式下运行,以保证与原始引擎相同的记录顺序。

  • -recordLimit(为所有输入设置记录限值):为输入工具设置全局记录限制以减少执行时间。默认值为 100,000。如需禁用,请将此值设置为 0。

  • - e1Filter(只筛选使用原始引擎创建的工作流):布尔参数,默认情况下为“False”。如果设置为“True”,将筛选(文件夹中的)仅为原始引擎创建的工作流。

所有参数都不区分大小写,可与‘/’和‘-’前缀一起使用。

例子

基本运行

AlteryxEngineCmd.exe /testdir "D:/path/to/workflows" /comparereport "D:/report.csv"

完整参数

AlteryxEngineCmd.exe -testDir "D:/path/to/workflows" -compareReport "D:/report.csv" -tempDir "D:/temp" -compatibleMode true -recordLimit 5 -e1Filter true

使用引擎奇偶校验宏指令

Designer 22.3 版及更高版本支持引擎奇偶校验宏指令。

对比工作流另一种方法是使用 Designer 宏指令。引擎奇偶校验宏指令未随 Designer 提供,您可以从 Community Gallery 下载 Engines Parity.yxzp 文件。

Engines Parity.yxzp 包含以下文件:

  • Engines Parity.yxmc:引擎奇偶校验宏指令。

  • Engines Parity.yxwz:引擎奇偶校验分析应用程序。

  • ReadFile.yxmc:宏指令和分析应用程序的支持文件。将此文件与宏指令/分析应用程序放在同一目录下。

  • RunCmdUniqueFiles.yxmc:宏指令和分析应用程序的支持文件。将其与宏指令/分析应用程序放在同一目录下。

要运行宏指令,请在 Designer 中右键单击画布,选择插入 > 宏指令 > Engines Parity.yxmc。现在您可以配置宏指令。

Macro Configuration
  1. 指定要在两个引擎上并行运行工作流的目录:使用浏览按钮导航到包含要比较的工作流的目录。

  2. 您还可以通过指定输出结果的位置字段设置要生成报告的路径。否则,报告将保存到 Alteryx 临时文件夹,并在您关闭 Designer 时删除。

    Output Location
  3. 以兼容模式运行 AMP Engine 设置可确保原始引擎和 AMP Engine 的记录顺序相同。默认选中此复选框。

  4. 选中仅筛选使用原始引擎构建的工作流复选框,可仅为使用原始引擎创建的工作流生成报告。

  5. 全局记录限制是用于比较的记录数量上限。如果不想指定限制,请将该数值设置为 0。

    Record Limit

使用引擎奇偶校验分析应用程序

Designer 22.3 版及更高版本支持引擎奇偶校验分析应用程序。

不过,引擎奇偶校验分析应用程序不随 Designer 提供,它是 Engines Parity.yxzp 文件的一部分,可从 Gallery 下载。

要使用引擎奇偶校验分析应用程序,请运行 Engines Parity.yxwz 文件。

Analytic Path