Editing data transformations

Anzeigen und Bearbeiten von Dateien

SQL-Dateien und Eingabedateien werden auf Registerkarten angezeigt. Wenn Sie eine SQL-Datei oder eine Eingabedatei öffnen, wird eine neue Registerkarte im Datentransformations-Editor geöffnet. Auf diese Weise können Sie mehrere Dateien gleichzeitig öffnen und mit ihnen arbeiten. Wenn ungespeicherte Änderungen in einer SQL-Datei vorhanden sind, wird dies mit einem blauen Punkt auf der Registerkarte angezeigt.

Tipp:

Sie können eine Datei in einer angehefteten Registerkarte öffnen. Auf diese Weise können Sie schnell auf Dateien zugreifen, ohne sie wiederholt öffnen zu müssen. Sobald eine Datei angeheftet ist, bleibt sie im Editor sichtbar, auch wenn Sie andere Dateien öffnen.

Sie können entweder auf die Datei doppelklicken oder die Option Anheften aus dem Registerkartenkontextmenü auswählen, um eine Registerkarte anzuheften.

Hinweis: Wenn in der aktuell geöffneten SQL-Datei ungespeicherte Änderungen vorhanden sind, verbleiben diese Änderungen beim Öffnen der neuen Datei auf einer eigenen Registerkarte. Wenn keine ungespeicherten Änderungen vorhanden sind, wird die neue SQL-Datei auf der aktuell angezeigten Registerkarte geöffnet.

Schließen von Dateien

Sie können die aktuelle Registerkarte, alle Registerkarten oder alle anderen Registerkarten schnell über das Registerkartenkontextmenü schließen.

Klicken Sie mit der rechten Maustaste auf einen Registerkartennamen, um das Registerkartenkontextmenü zu öffnen.

Ausführen der Abfragen

Achtung:

Alle ausführen und die Datei ausführen sind auf eine Stunde begrenzt. Daher 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 finden Sie im Process Mining-Portal .

Wenn Sie Transformationen bearbeiten, können Sie Alle 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 Alle 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:

• Alle 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:

Die Ausführung aller wirkt sich nicht auf die Daten in der veröffentlichten Prozess-App aus.

Anzeigen von kompilierter SQL

Sie können nach dem Ausführen der Abfragen eine kompilierte Version des SQL-Codes anzeigen, indem Sie die Umschaltoption Kompiliertes SQL aktivieren. Dies ist beim Debuggen von SQL-Fehlern nützlich, da die gemeldeten Zeilennummern den Zeilennummern in der kompilierten SQL entsprechen.

Hinweis:

Nur SQL-Dateien, die gerade ausgeführt wurden, zeigen den Umschalter Kompiliertes SQL an.

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	Öffnen Sie die Weitere Aktionen für 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, zeigt ein blauer Punkt in der Ordnerstruktur Transformationen an, dass nicht gespeicherte Änderungen vorhanden sind.

Verschieben von Dateien

Sie können Dateien einfach ziehen und ablegen, um sie in einen anderen Ordner zu verschieben oder sie innerhalb eines Ordners neu anzuordnen. Es wird eine Bestätigungsmeldung angezeigt, um versehentliche Dateiverschiebungen zu verhindern.

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	Öffnen Sie die Weitere Aktionen für den Ordner oder die Datei, den/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	Öffnen Sie die Weitere Aktionen für den Ordner oder die Datei, den/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.

Duplizieren einer Datei

Durch das Duplizieren einer SQL-Datei können Sie Ihre Abfragen wiederverwenden und Änderungen vornehmen, ohne eine komplett neue Datei erstellen zu müssen. Sie können damit auch Änderungen an Ihren Abfragen vornehmen, ohne die ursprünglichen Abfragen zu verändern oder zu beschädigen.

Durch das Duplizieren einer Datei wird eine Kopie der Originaldatei im selben Ordner direkt unter der duplizierten Datei erstellt.

Führen Sie die folgenden Schritte aus, um eine SQL-Datei zu duplizieren.

Schritte	Aktion
1	Öffnen Sie die Weitere Aktionen für die Datei, die Sie duplizieren möchten, um das Kontextmenü zu öffnen.
2	Wählen Sie Duplizieren aus. Die duplizierte Datei wird am selben Speicherort wie die Originaldatei eingefügt.

Kopieren und Einfügen einer Datei

Sie können eine SQL-Datei kopieren und an einem anderen Ort einfügen. Durch das Kopieren und Einfügen einer SQL-Datei können Sie Ihre Abfragen wiederverwenden und Änderungen an Ihren Abfragen vornehmen, ohne eine komplett neue Datei erstellen zu müssen.

Führen Sie die folgenden Schritte aus, um eine SQL-Datei zu kopieren und einzufügen.

Schritte	Aktion
1	Öffnen Sie die Weitere Aktionen für die Datei, die Sie kopieren möchten, um das Menü zu öffnen.
2	Wählen Sie Kopieren aus.
3	Öffnen Sie die Weitere Aktionen Wählen Sie Einfügen im Menü aus. Die kopierte Datei wird eingefügt.
4	Ziehen Sie die Datei an den gewünschten Speicherort und legen Sie sie dort ab.

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.

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.

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", #}

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.