Bearbeiten und Testen von Datentransformationen

Editing transformations

Weitere Informationen zum Bearbeiten von Datentransformationen finden Sie auf den unten aufgeführten Seiten.

• Structure of transformations

• Designing an event log

• Tips for writing SQL

Ausführen der Abfragen

Achtung:

Für Versionen vor 2023.10.7 Alle ausführen und Datei ausführen sind auf 10 Minuten begrenzt. Ab 2023.10.7 Alle ausführen und Datei ausführen sind auf 1 Stunde begrenzt.

Es wird dringend empfohlen, ein kleines Dataset für die Entwicklung und das Testen von Datentransformationen zu verwenden, um sicherzustellen, dass Ihre Transformationen dieses Zeitlimit nicht überschreiten. Weitere Informationen zum Hochladen eines Entwicklungs-Datasets finden Sie imProcess Mining-Portal .

Wenn Sie Transformationen bearbeiten, können Sie Abfragen ausführen auswählen, um Ihre Änderungen zu testen und eine Vorschau anzuzeigen. Die Abfragen, die geändert wurden, und alle damit verbundenen Abfragen werden ausgeführt. Zum Beispiel, wenn cases_input.sql geändert wurde. Der Befehl Abfragen ausführen würde cases_input.sql und cases.sql ausführen, wodurch die Ergebnisse von cases_input.sql verwendet werden.

Die resultierenden Daten sind nur im Datentransformations-Editor verfügbar, nicht im Dashboard-Editor.

Es gibt zwei Arten von Ausführungen:

• Abfragen ausführen : Startet eine Datenausführung, bei der alle geänderten Abfragen und deren Abhängigkeiten erneut berechnet werden.

• Datei ausführen : Startet eine Ausführung, um nur die aktuell ausgewählte SQL-Datei und deren übergeordnete Abfragen neu zu berechnen. Mit dieser Option können Sie Anpassungen an bestimmten SQL-Dateien testen und debuggen.

Tipp:

Sie können Ausführung jederzeit abbrechen auswählen, um die Ausführung der Transformationen abzubrechen.

Die Ergebnisse werden im Vorschaubereich angezeigt.

Hinweis:

Abfragen ausführen ist in der Regel viel schneller als Auf Dashboards anwenden, bei dem eine vollständige Datenausführung gestartet wird.

Hinweis:

Das Ausführen von Abfragen wirkt sich nicht auf die Daten in der veröffentlichten Prozess-App aus.

Hinzufügen von Ordnern und Dateien

Sie können neue Ordner erstellen und neue Dateien in Ihren Transformationen hinzufügen.

Benennungskonventionen

• Für Namen von Dateien, Ordnern, Feldern und Tabellen:

  • Sie können nur Kleinbuchstaben (az), Großbuchstaben (AZ) und Ziffern (0-9) verwenden;

  • Sie keine Sonderzeichen |*:?"<>\/ für Namen von Dateien, Ordnern, Feldern und Tabellen verwenden.
• Für Dateinamen können Sie nur _:. als Sonderzeichen verwenden.
• Ein Dateiname darf nicht mit einem _ (Unterstrich) beginnen.

Erstellen eines neuen Ordners oder einer neuen Datei im Transformationsmenü

Führen Sie die folgenden Schritte aus, um einen neuen Ordner oder eine neue Datei zu erstellen.

Schritte	Aktion
1	Navigieren Sie zu dem Speicherort in den Transformationen, an dem Sie eine neue Datei oder einen neuen Ordner hinzufügen möchten.
2	Wechseln Sie zum Bereich Transformationen und wählen Sie das Menü aus Symbol, um das Transformationsmenü zu öffnen.
3	Wählen Sie die entsprechende Option aus dem Menü aus.
4	Geben Sie einen beschreibenden Namen für den neuen Ordner oder die neue Datei ein und wählen Sie die Eingabetaste aus.

Der neue Ordner oder die neue Datei wird im ausgewählten Ordner erstellt.

Erstellen eines neuen Ordners oder einer neuen Datei über das Kontextmenü

Führen Sie die folgenden Schritte aus, um einen neuen Ordner oder eine neue Datei über das Kontextmenü zu erstellen.

Schritte	Aktion
1	Klicken Sie mit der rechten Maustaste auf den Ordner in den Transformationen, in dem Sie eine neue Datei oder einen neuen Ordner hinzufügen möchten.
2	Wählen Sie die entsprechende Option aus dem Menü aus.
3	Geben Sie einen beschreibenden Namen für den neuen Ordner oder die neue Datei ein und wählen Sie die Eingabetaste aus.

Der neue Ordner oder die neue Datei wird im ausgewählten Ordner erstellt.

Nicht gespeicherte Änderungen in Dateien

Wenn Sie eine .sql -Datei bearbeiten, wird in der Ordnerstruktur der Transformationen angegeben, dass nicht gespeicherte Änderungen vorhanden sind.

Im obigen Beispiel gibt es ungespeicherte Änderungen in der Tags.sql -Datei, die sich im Ordner „Modelle“ -> „5_business_logic “ befindet.

Umbenennen eines Ordners oder einer Datei

Führen Sie die folgenden Schritte aus, um einen neuen Ordner oder eine neue Datei zu erstellen.

Schritte	Aktion
1	Klicken Sie mit der rechten Maustaste auf den Ordner oder die Datei, die Sie umbenennen möchten, um das Kontextmenü zu öffnen.
2	Wählen Sie Umbenennen aus.
3	Bearbeiten Sie den Namen wie gewünscht und wählen Sie die Eingabetaste aus.

Der Ordner oder die Datei wird umbenannt.

Löschen eines Ordners oder einer Datei

Führen Sie die folgenden Schritte aus, um einen neuen Ordner oder eine neue Datei zu erstellen.

Schritte	Aktion
1	Klicken Sie mit der rechten Maustaste auf den Ordner oder die Datei, die Sie löschen möchten, um das Kontextmenü zu öffnen.
2	Wählen Sie Löschen aus. Eine Bestätigungsmeldung wird angezeigt.
3	Wählen Sie Löschen aus, um die Löschung zu bestätigen.

Der Ordner oder die Datei wird gelöscht.

Hinzufügen von Kommentaren zu Dateien

Wenn Sie Kommentare in Ihre SQL-Transformationsdateien aufnehmen oder Teile der Datei auskommentieren möchten, wird dringend empfohlen, die Jinja-Kommentarsyntax zu verwenden, die standardmäßig auf {# ... #} festgelegt ist. Dadurch können Sie auch Makros kommentieren.

SQL

{# {{ pm_utils.optional(ref('Cases_base'), '"Case_status"') }} as "Case_status", #}

{# case
    when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} >= 1000000 
      then {{ pm_utils.as_varchar('>= 1M') }}
    when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} >= 0 
     then {{ pm_utils.as_varchar('0 - 1M') }}
   when {{ pm_utils.optional(ref('Cases_base'), '"Case_value"', 'double') }} is not null
     then {{ pm_utils.as_varchar('< 0') }}
  end as "Case_value_group", #}

In Dateien suchen/ersetzen

Im Datentransformations- Editor können Sie Texte in einer einzelnen Datei suchen und ersetzen.

Find Text

So suchen Sie einen Text im Datentransformations-Editor:

1. Klicken Sie auf eine zufällige Stelle im Code-Editor oder wählen Sie den Text aus, den Sie nach anderen Vorkommen suchen möchten.

2. Drücken CTRL+F.

3. Geben Sie den Test, nach dem Sie suchen möchten, in das Feld Suchen ein.

   Alle Vorkommen des Texts in der aktuellen Datei werden hervorgehoben.

4. Wählen Sie ENTER aus, um zum nächsten Vorkommen zu springen.

Suchen und ersetzen

So suchen Sie einen Text im Datentransformations-Editor:

1. Klicken Sie auf eine zufällige Stelle im Code-Editor oder wählen Sie den Text aus, den Sie nach anderen Vorkommen suchen möchten.

2. Drücken CTRL+H.

3. Geben Sie den Test ein, nach dem Sie suchen möchten, und geben Sie den neuen Test in das Feld Ersetzen ein.

   Alle Vorkommen des Texts in der aktuellen Datei werden hervorgehoben.

4. Wählen Sie ENTER aus, um den Text zu ersetzen und zum nächsten Vorkommen zu springen.

So suchen Sie einen Text im Datentransformations-Editor:

1. Klicken Sie auf den Code-Editor.

2. Drücken CTRL+H.

3. Geben Sie den Test ein, nach dem Sie suchen möchten, und geben Sie den neuen Test in das Feld Ersetzen ein.

   Alle Vorkommen des Texts in der aktuellen Datei werden hervorgehoben.

4. Drücken Crtl+Alt+Enter.

Tipp:

Sie können auch die Symbole Ersetzen oder Alle ersetzen verwenden.

Suchen/Ersetzen in mehreren Dateien

Wenn Sie Texte in mehreren Dateien suchen/ersetzen möchten, ist dies nur in einem externen Editor möglich.

Führen Sie die folgenden Schritte aus, um Texte in mehreren Dateien zu suchen/ersetzen:

1. Exportieren Sie Transformationen aus Ihrer Prozess-App.

   Hinweis:

   Wenn Sie ausstehende Änderungen im Datentransformations-Editor haben, verwenden Sie zuerst Anwenden auf Dashboards und exportieren Sie die Transformationen, nachdem die Datenausführung abgeschlossen ist.

2. Entpacken Sie die Transformationen.

3. Öffnen Sie die Transformationen in Ihrem bevorzugten Code-Editor, z. B. Notepad++ oder Visual Studio Code.

4. Verwenden Sie die Funktionen dieser Tools, um Texte in mehreren Dateien zu suchen oder zu ersetzen.

5. Speichern Sie die Dateien.

6. Fügen Sie die Transformationsdateien zu einer .zip- Datei.

7. Importieren Sie die Transformationen in Ihre Prozess-App.

Hinweis:

Wenn Sie gefragt werden, welche Daten für eine Datenausführung verwendet werden sollen, wählen Sie Abbrechen aus, wenn Sie mit der Bearbeitung von Transformationen fortfahren möchten, bevor Sie eine neue Datenausführung durchführen.

Bearbeiten von dbt-Projektkonfigurationsdateien

Sie können auch dbt-Projektkonfigurationsdateien im Datentransformations-Editor öffnen, z. B. dbt_project.yml.

Warnung:

Es wird dringend empfohlen, nur den Abschnitt vars bei Bedarf zu bearbeiten. Die anderen Teile von dbt_project.yml dürfen nicht geändert werden, um sicherzustellen, dass die Transformationen weiterhin ordnungsgemäß funktionieren.

Ausführliche Informationen zu dbt finden Sie in der offiziellen dbt-Dokumentation.

Verfügbarmachen der Transformationen in Dashboards

Um die Änderungen in den Dashboards verfügbar zu machen, müssen Sie die Daten in einem vollständigen Datendurchlauf laden und die Transformationen durchführen. Wählen Sie die Schaltfläche Auf Dashboards anwenden aus, um eine Datenausführung zu starten.

Hinweis:

Je nach Größe Ihres Datasets kann dies einige Zeit in Anspruch nehmen.

Nach einer erfolgreichen Datenausführung stehen die neuen Transformationen im Dashboard-Editor zur Verfügung und können zur Anpassung der Dashboards verwendet werden.

Achtung:

Wenn Sie über eine veröffentlichte Version der Prozess-App verfügen, sehen Geschäftsanwender sofort die neuen Daten. Wenn Sie sicherstellen möchten, dass Ihre veröffentlichte App auch während der Bearbeitung von Transformationen ordnungsgemäß funktioniert, sollten Sie unbedingt eine Entwicklungs-App verwenden.

Führen Sie die folgenden Schritte aus.

1. Klonen Sie Ihre App, um eine Entwicklungs-App zu erstellen.

2. Bearbeiten und testen Sie die Transformationen.

3. Exportieren Sie die Transformationen aus der Entwicklungs-App.

4. Importieren Sie die Transformationen in Ihre veröffentlichte Prozess-App.