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 提供,但您可以从社区 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