Konvertierte Alteryx-Workflows validieren

Die Validierung bestätigt, dass ein konvertierter Alteryx-Workflow in PlaidCloud ausgeführt werden kann und, wenn erwartete Ausgaben verfügbar sind, dieselben geschäftlichen Ergebnisse liefert.

Verwenden Sie diese Anleitung, nachdem Sie einen Workflow, eine App oder ein Makro in PlaidCloud importiert haben.

Eine Validierungsstufe wählen

Die meisten Migrationsprogramme verwenden zwei Validierungsstufen.

Strukturelle Validierung

Die strukturelle Validierung bestätigt, dass PlaidCloud aus dem Alteryx-Entwurf einen vollständigen Workflow erstellt hat. Verwenden Sie diese Stufe, wenn Sie die Migrationsbereitschaft messen, ein Portfolioinventar vorbereiten oder Workflows konvertieren, bevor erwartete Ausgaben verfügbar sind.

Prüfen Sie Folgendes:

Der konvertierte Workflow wird im Visuellen Workflow-Designer geöffnet.
Der Workflow-Graph enthält die erwarteten Verzweigungen, Joins, Makros und Ausgaben.
Alle erforderlichen Eingabedateien wurden in den ausgewählten Document-Pfad hochgeladen.
Alle erforderlichen Makros wurden importiert oder generiert.
Makroeingaben und Makroausgaben sind verbunden.
Fragen der Analyse-App wurden zu Workflow-Variablen mit kontrollierten Eingabefeldern.
Die Workflow-Ausführung wird abgeschlossen und meldet eindeutige Bereitschaftshinweise für datenabhängige Bedingungen.

Validierung der Ausgabeparität

Die Validierung der Ausgabeparität bestätigt, dass der konvertierte Workflow dieselben tabellarischen Ergebnisse erzeugt wie der Alteryx-Workflow.

Vergleichen Sie:

Schema der Ausgabetabelle.
Zeilenanzahl.
Zeilenwerte.
Behandlung von Nullwerten.
Numerische Genauigkeit und Rundung.
Datums- und Zeitwerte.
Geometriewerte, wenn räumliche Ausgaben Teil des Ergebnisses sind.

Ignorieren Sie die Zeilenreihenfolge, es sei denn, der Workflow sortiert Daten ausdrücklich oder der nachgelagerte Prozess hängt von geordneten Zeilen ab.

Auf der Lakehouse-v2-Engine (StarRocks) von PlaidCloud sind diese häufig verwendeten Konvertierungen wertgeprüft und stimmen mit der Alteryx-Ausgabe überein, sodass Sie ohne besondere Behandlung übereinstimmende Ergebnisse erwarten können:

Umwandlung von Text in Titelschreibweise.
Sphärische (Großkreis-)Entfernung zwischen Punkten.
Stichprobenkovarianz.
Summe und Durchschnitt über numerische Werte, die als Text gespeichert sind.
Aufteilen von Text in Spalten mit einem regulären Ausdruck.
Mittelwertimputation fehlender Werte.

Migration nachweisen

Migration nachweisen vergleicht, was ein konvertierter Workflow erzeugt hat, mit den Ausgaben, die Alteryx erzeugt hat, sodass Sie sie nicht von Hand abgleichen müssen. In einem Workspace, der über den Alteryx-Abdeckungsbericht entstanden ist, erscheint es in der Checkliste auf der Startseite als Migration nachweisen mit einer Schaltfläche Vergleichen, und der Abdeckungsbericht bietet dieselbe Schaltfläche.

Wählen Sie Alteryx-Ausgabe importieren… und importieren Sie jede Ausgabedatei, die Ihr Alteryx-Workflow erzeugt hat. Weitere Ausgabe hinzufügen fügt ein weiteres Paar hinzu.
Wählen Sie für jedes Paar die Konvertierte Ausgabe und die Alteryx-Ausgabe, mit der sie übereinstimmen soll.
Wählen Sie Vergleichen.

PlaidCloud prüft zuerst die Zeilenanzahlen, dann jede Spalte und zeigt anschließend Zeilen, die nur auf einer Seite vorkommen (jeweils bis zu 20), sodass ein Unterschied seiner Spalte zugeordnet wird. Jede Ausgabe meldet eines der folgenden Ergebnisse.

Ergebnis	Bedeutung
Stimmt mit `<output>` überein: `<n>` Zeilen auf beiden Seiten, jede Spalte gleich.	Auf beiden Seiten dieselbe Zeilenanzahl und jede Spalte gleich.
Stimmt mit `<output>` in allen verglichenen Punkten überein: `<n>` Zeilen auf beiden Seiten.	Alles Verglichene stimmt überein. Ein Hinweis wie 3 weitere Spalten wurden nicht verglichen. zählt die ausgelassenen Spalten.
Weicht von `<output>` ab: `<n>` Zeilen konvertiert, `<m>` Zeilen aus Alteryx.	Die Zeilenanzahlen, Spalten oder Werte weichen ab. Der Bericht listet Spalten auf, die nur auf einer Seite vorkommen, und für jede Spalte, was abweicht (zum Beispiel Summe, Minimum oder Anzahl eindeutiger Werte).

Eine Seite mit mehr als 5 Millionen Zeilen ist zu groß für einen Vergleich an dieser Stelle; vergleichen Sie stattdessen einen gefilterten Auszug beider Seiten. Die Zeile in der Checkliste der Startseite zeigt das letzte Ergebnis: Ausgaben stimmen überein, Ausgaben stimmen in den verglichenen Spalten überein oder Einige Ausgaben weichen ab.

Auf Ihrem eigenen Snowflake- oder Databricks-Warehouse zeigt das Fenster außerdem die Warehouse-Kosten der letzten Ausführung, gekennzeichnet als zugeordnet oder geschätzt, sowie eine Schätzung für die nächste Ausführung.

Eingaben validieren

Bevor Sie Ausgaben vergleichen, prüfen Sie, dass der konvertierte Workflow dieselben Quelldaten verwendet:

Öffnen Sie den beim Import ausgewählten Document-Ordner.
Prüfen Sie, dass erforderliche Dateien und Begleitdateien vorhanden sind.
Prüfen Sie, dass dynamische Eingabemuster zu den vorgesehenen Dateien aufgelöst werden.
Prüfen Sie, dass Datenbank- oder API-Anmeldeinformationen in der Zielumgebung verfügbar sind.
Prüfen Sie, dass die Workflow-Variablen den in der Alteryx-Ausführung verwendeten Werten entsprechen.

Abgestimmte Eingaben beschleunigen die Validierung und halten Vergleiche auf das Workflow-Verhalten fokussiert.

Makros validieren

Konvertierte Alteryx-Makros werden zu PlaidCloud-Makro-Workflows. Validieren Sie das Makro und den aufrufenden Workflow gemeinsam:

Öffnen Sie den generierten Makro-Workflow.
Prüfen Sie, dass jede Makroeingabe einen passenden Makroeingabeschritt hat.
Prüfen Sie, dass jede Makroausgabe einen passenden Makroausgabeschritt hat.
Führen Sie einen Workflow aus, der das Makro aufruft.
Prüfen Sie, dass wiederholte oder gleichzeitige Ausführungen voneinander isoliert bleiben.
Vergleichen Sie die Makroausgabedaten, wenn Sie erwartete Makroausgaben haben.
Prüfen Sie bei einem Batch-Makro, dass jeder Durchlauf im gesammelten Ergebnis erscheint, auch bei einer Ausführung, deren Makro keine Durchläufe erzeugt – diese sollte ein leeres Ergebnis liefern und keine Zeilen einer früheren Ausführung. Hängt die Makrologik davon ab, wie ein Double-Wert ankommt, prüfen Sie sie erneut: Eine Double-Makroeingabe kommt jetzt als Zahl statt als Text an.

Analyse-Apps validieren

Konvertierte Alteryx-Analyse-Apps verwenden Workflow-Variablen für kontrollierte Benutzereingaben.

Prüfen Sie Folgendes:

Textfelder, numerische Eingaben, Datumsangaben, Dateiauswahlen, Ordnerauswahlen, Listen, Bäume, Optionsfelder, Kontrollkästchen und Dropdown-Listen stellen die erwarteten Eingabesteuerelemente bereit.
Die Standardwerte entsprechen der ursprünglichen App, sofern Standardwerte vorhanden waren.
Erforderliche Werte sind vor der Ausführung des Workflows gesetzt.
Bedingungen erzeugen für die konfigurierten Eingabewerte die erwarteten Meldungen, Warnungen oder das erwartete Stoppverhalten.

Spezialisierte Ausgaben validieren

Manche konvertierten Workflows erzeugen nicht nur Tabellen, sondern Artefakte. Validieren Sie diese Ausgaben entsprechend ihrer Verwendung.

Für Berichte, PDFs, Bilder, Diagramme und Karten:

Prüfen Sie, dass das Artefakt im erwarteten Document-Pfad erstellt wurde.
Prüfen Sie, dass das Artefakt die erwarteten Daten, Beschriftungen, Bilder und das erwartete Layout enthält.
Prüfen Sie, dass nachgelagerte Verbraucher das Artefakt öffnen oder verwenden können.
Vergleichen Sie es mit einem erwarteten Artefakt, sofern eines verfügbar ist.

Für NLP-, Fuzzy-Matching- und räumliche Workflows:

Prüfen Sie, dass der verwaltete Job-Executor erfolgreich abgeschlossen wurde.
Prüfen Sie die Executor-Hinweise.
Vergleichen Sie erzeugte Tabellen oder Bewertungen mit den erwarteten Ausgaben.
Dokumentieren Sie alle Unterschiede bei Cloud-nativen Artefakten, wenn die PlaidCloud-Ausgabe absichtlich von einer Alteryx-Desktop-spezifischen Ausgabe abweicht.

Für Machine-Learning-Workflows:

Prüfen Sie, dass der ML-Train-Schritt seine einzeilige Modelltabelle geschrieben hat, und prüfen Sie die aufgezeichneten Trainingsmetriken.
Vergleichen Sie die Vorhersagespalte von ML Score mit den Alteryx-Bewertungen. Erwarten Sie bei XGBoost-Modellen statistische Äquivalenz statt identischer Werte und prüfen Sie die Zuordnungshinweise des Schritts.

Validierungsunterschiede beheben

Wenn die Validierung einen Unterschied findet, prüfen Sie die Punkte in dieser Reihenfolge:

Fehlende oder abweichende Eingabedateien.
Abweichende Workflow-Variablenwerte.
Abweichende Datenbank-Snapshots oder API-Antworten.
Unterschiede bei Datum, Zeitzone, Nullwerten, Rundung oder Zeichenfolgensortierung.
Unterschiede beim räumlichen Bezug oder Geometrieformat.
Unterschiede bei Cloud-nativen Artefakten für Berichte, Karten, proprietäre Formate oder reine Desktop-Renderer.

Führen Sie den Workflow nach der Behebung der Ursache erneut aus und wiederholen Sie den Vergleich.

Einen validierten Workflow übernehmen

Wenn die Validierung bestanden ist:

Verschieben oder kopieren Sie den Workflow in das Produktionsprojekt, wenn die Migration in einem Staging-Projekt erfolgte.
Prüfen Sie die Document-Pfade und Anmeldeinformationen der Produktion.
Planen Sie den Workflow.
Überwachen Sie die ersten Produktionsausführungen im Ausführungsverlauf.
Bewahren Sie die Validierungsergebnisse zusammen mit dem Migrationsprotokoll für Audit und Support auf.