Engines-Parität-Hilfsprogramm
Das Engines-Parität-Hilfsprogramm bietet eine einfache Möglichkeit, die Original-Engine und die AMP Engine zu vergleichen. Sie können damit beide Engines parallel ausführen, die Ergebnisse auswerten und entscheiden, welchen Workflow Sie problemlos in AMP konvertieren können.
Parität-Framework ist ein Befehlszeilen-Tool. Zur Vereinfachung gibt es jedoch ein Makro, welches das Befehl-ausführen-Tool von Alteryx verwendet. Sie haben daher folgende Möglichkeiten:
Führen Sie das Parität-Framework über die Befehlszeile mit AlteryxEngineCmd.exe aus.
Verwenden Sie das Engines-Parität-Makro.
Führen Sie die Engines-Parität-Analyse-App aus.
Verwendung von AlteryxEngineCmd.exe
Sie können Workflows auf AMP und der Original-Engine über AlteryxEngineCmd.exe mit folgenden Parametern vergleichen:
-testDir(Pfad zum Workflow): Pfad zum Ordner mit Workflows oder Pfad zu einer einzelnen YXMD-Datei, die Sie testen möchten. Dieser Parameter ist obligatorisch und sollte an erster Stelle stehen.-compareReport(Pfad zur CSV-Berichtsdatei): Name der CSV-Datei, in der der Bericht gespeichert werden soll.-tempDir(Pfad zu Zwischendateien): Ordner, in dem Zwischendateien gespeichert werden. Standardmäßig ist das der temporäre Alteryx-Ordner, der nach der Ausführung gelöscht wird.-compatibleMode(AMP Engine im/nicht im Kompatibilitätsmodus ausführen): Boolescher Parameter, standardmäßig „Falsch“. Wenn auf „Wahr“ gesetzt, wird die AMP Engine im Kompatibilitätsmodus ausgeführt, um die gleiche Datensatzreihenfolge wie die Original-Engine zu gewährleisten.-recordLimit(Datensatzlimit für alle Eingaben festlegen): Legen Sie das globale Datensatzlimit für Eingabe-Tools fest, um die Ausführungszeit zu reduzieren. Die Standardeinstellung ist „100000“. Setzen Sie diesen Wert zur Deaktivierung auf 0.-e1Filter(nur mit der Original-Engine erstellte Workflows filtern): Boolescher Parameter, standardmäßig „Falsch“. Wenn auf „Wahr“ gesetzt, werden Workflows (aus dem Ordner) gefiltert, die nur für die Original-Engine erstellt wurden.
Bei allen Parametern wird die Groß-/Kleinschreibung nicht beachtet und sie können sowohl mit dem Präfix „/“ als auch mit dem Präfix „-“ verwendet werden.
Beispiele
Basisausführung
AlteryxEngineCmd.exe /testdir "D:/path/to/workflows" /comparereport "D:/report.csv"
Vollständige Parameter
AlteryxEngineCmd.exe -testDir "D:/path/to/workflows" -compareReport "D:/report.csv" -tempDir "D:/temp" -compatibleMode true -recordLimit 5 -e1Filter true
Verwendung des Engines-Parität-Makros
Das Engines-Parität-Makro ist ab Designer-Version 22.3 verfügbar.
Eine weitere Möglichkeit zum Vergleichen von Workflows ist die Verwendung des Designer-Makros. Das Engines-Parität-Makro ist nicht im Lieferumfang von Designer enthalten. Sie können die Datei Engines Parity.yxzp aber aus der Community Gallery herunterladen.
Engines Parity.yxzp besteht aus folgenden Dateien:
Engines Parity.yxmc: Engines-Parität-Makro.
Engines Parity.yxwz: Engines-Parität-Analyse-App.
ReadFile.yxmc: Die unterstützende Datei für das Makro und die Analyse-App. Legen Sie diese Datei im selben Verzeichnis wie das Makro und die Analyse-App ab.
RunCmdUniqueFiles.yxmc: Die unterstützende Datei für das Makro und die Analyse-App. Legen Sie diese im selben Verzeichnis wie das Makro und die Analyse-App ab.
Um das Makro auszuführen, klicken Sie in Designer mit der rechten Maustaste auf den Canvas und wählen Sie Einfügen > Makro > Engines Parity.yxmc. Jetzt können Sie das Makro konfigurieren.
Das Verzeichnis mit den Workflows angeben, die mit beiden Engines parallel ausgeführt werden sollen: Verwenden Sie die Schaltfläche zum Durchsuchen, um zu dem Verzeichnis zu navigieren, das die Workflows enthält, die Sie vergleichen möchten.
Sie können den Pfad, wo der Bericht erstellt werden soll, auch über das Feld Speicherort für die Ausgabeergebnisse angeben festlegen. Andernfalls wird er im temporären Alteryx-Ordner gespeichert und gelöscht, wenn Sie Designer schließen.
Durch die Einstellung AMP Engine im Kompatibilitätsmodus ausführen wird sichergestellt, dass die Datensatzreihenfolge bei der Original-Engine und bei der AMP Engine gleich ist. Dieses Kontrollkästchen ist standardmäßig ausgewählt.
Aktivieren Sie das Kontrollkästchen Nach Workflows filtern, die mit der Original-Engine erstellt wurden, um die Berichte nur für Workflows zu generieren, die so erstellt wurden, dass sie mit der Original-Engine funktionieren.
Das globale Datensatzlimit ist die maximale Anzahl von Datensätzen, die für den Vergleich verwendet werden. Wenn Sie kein Limit angeben möchten, setzen Sie die Zahl auf 0.
Verwendung der Engines-Parität-Analyse-App
Die Engines-Parität-Analyse-App ist ab Designer-Version 22.3 verfügbar.
Die Engines-Parität-Analyse-App ist nicht im Lieferumfang von Designer enthalten. Sie ist aber Teil der Datei Engines Parity.yxzp, die in der Gallery heruntergeladen werden kann.
Um die Engines-Parität-Analyse-App zu verwenden, führen Sie die Datei Engines Parity.yxwz aus.
