Engines Parityユーティリティ
Engines Parityユーティリティは、従来のEngineとAMP Engineを容易に比較できるツールです。両方を並行して実行し、結果を評価して、どのワークフローを問題なくAMPに変換できるかを決定できます。
パリティフレームワークはコマンドラインツールです。ただし、簡単に実行できるように、Alteryxコマンド実行ツールを使用するマクロがあります。従って、以下の選択が可能です。
AlteryxEngineCmd.exeを使用して、コマンドラインからパリティフレームワークを実行する。
Engines Parityマクロを使用する。
Engines Parity分析アプリを実行する。
AlteryxEngineCmd.exeを使用する
AlteryxEngineCmd.exe を使用して、AMPと従来のEngineのワークフローを次のパラメーターで比較できます。
-testDir <ワークフローへのパス>
このパラメーターは必須で、最初に指定します。
ワークフローを含むフォルダーへのパス、またはテストする1つのYXMDファイルへのパス。
-compareReport <CSVレポートファイルへのパス>
レポートを保存するCSVファイル名。
-tempDir <中間ファイルのパス>
中間ファイルが保存されるフォルダー。既定はAlteryx一時フォルダーで、実行後に削除されます。
-compatibleMode <AMP Engineを互換モードで実行するかどうか>
ブール型パラメーター、既定では「False」。「True」を指定して呼び出された場合、AMP Engineは互換モードで動作し、従来のEngineと同じレコード順序が保証されます。
-recordLimit <すべての入力にレコード制限を設定>
実行時間を短縮するために、入力ツールに対してグローバルレコード制限を設定します。既定値は100,000です。0に設定すると無効になります。
-e1Filter <従来のEngineで作成されたワークフローのみをフィルタリングします>
ブール型パラメーター、既定では「False」。「True」を指定して呼び出された場合、従来のEngine用に作成された、(指定されたフォルダーの)ワークフローのみがフィルタリングされます。
すべてのパラメーターは大文字と小文字を区別せず、「/」と「-」の両方の接頭辞を使用できます。
例
基本的な実行
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
Engines Parityマクロを使用する
Engines ParityマクロはDesignerバージョン22.3以降で利用可能です。
ワークフロー比較を行うもう1つの方法は、Designerマクロを使用することです。Engines ParityマクロはDesignerには付属していません。Galleryから Engines Parity.yxzp ファイルをダウンロードできます。
Engines Parity.yxzp は、次のファイルで構成されています。
Engines Parity.yxmc - Engines Parityマクロ。
Engines Parity.yxwz - Engines Parity分析アプリ。
ReadFile.yxmc - マクロおよび分析アプリのサポートファイルであり、それらと同じディレクトリに配置する必要があります。
RunCmdUniqueFiles.yxmc - マクロおよび分析アプリのサポートファイルであり、それらと同じディレクトリに配置する必要があります。
マクロを実行するには、Designerでキャンバスを右クリックし、[ 挿入 ] > [ マクロ ] > [ Engines Parity.yxmc ] を選択します。これで、マクロを設定できます。
両方のエンジンを並行に実行するワークフローを含むディレクトリを指定 。
レポートを生成するパスを設定することもできます。それ以外の場合は、Alteryx一時フォルダーに保存され、Designerを閉じると削除されます。
AMP Engineを互換モードで実行 すると、従来のEngineとAMP Engineでレコードの順序が同じになることが保証されます。既定では、このチェックボックスが選択されています。
[ 従来のエンジンで構築されたワークフローのみをフィルタリング ] チェックボックスをオンにすると、従来のEngineで動作するように作成されたワークフローのレポートのみが生成されます。
グローバルレコード制限は、比較に使用されるレコードの最大数です。制限を指定しない場合は、数値を0に設定します。
Engines Parity分析アプリを使用する
Engines Parity分析アプリは、Designerバージョン22.3から利用できます。
Engines Parity分析アプリはDesignerには付属していません。Galleryからダウンロードできる Engines Parity.yxzp ファイルの一部です。
Engines Parity分析アプリを使用するには、 Engines Parity.yxwz ファイルを実行します。