Verwalten von Eingabedaten

Sie können die Eingabetabellen direkt über Datentransformationen konfigurieren, um sicherzustellen, dass Ihre Eingabedaten die Anforderungen für Ihre Prozess-App erfüllen. Mit der Option Eingabedateneinstellungen verwalten können Sie vorhandene Eingabetabellen einfach konfigurieren oder neue Eingabetabellen aus neu hochgeladenen Dateien erstellen.

Führen Sie die folgenden Schritte aus, um die Einstellungen für die Eingabedaten zu verwalten.

1. Suchen Sie im Abschnitt Eingabe den Ordner Tabellen .
2. Suchen Sie die Tabelle, für die Sie die Dateien verwalten möchten, und wählen Sie das Kontextmenüsymbol aus, um den Bereich Tabelle bearbeiten für die ausgewählte Tabelle zu öffnen.

Die Seite Tabellen wird angezeigt und zeigt die Quelltabellen an, die bereits für Ihre Prozess-App vorhanden sind.

Zuordnen und Konfigurieren von Eingabetabellen

Wenn Sie eine oder mehrere Dateien hochladen, wird automatisch eine neue Tabelle im Abschnitt Quelltabellen für jede hochgeladene Datei hinzugefügt und eine entsprechende Eingabetabelle wird im Abschnitt Zieltabellen erstellt. Standardmäßig wird der Dateiname der hochgeladenen Datei als Name der Tabellen verwendet. Es wird eine Warnmeldung angezeigt, die angibt, dass die Tabelle konfiguriert werden muss, bevor Daten für die Tabelle hochgeladen werden können.

Zuordnen von Eingabetabellen

Ihre Eingabedaten müssen dem für Ihre App definierten Datenmodell entsprechen. Bei Bedarf können Sie eine Quelltabelle einer anderen Zieltabelle zuordnen.

Konfigurieren von Eingabetabellen

Die Einstellungen für die Zieleingabetabelle werden automatisch erkannt und Sie müssen sie nur überprüfen.

Führen Sie die folgenden Schritte aus, um die Einstellungen für eine Eingabetabelle zu bearbeiten.

1. Suchen Sie die Tabelle, die Sie konfigurieren möchten, und wählen Sie das Symbol Tabelle bearbeiten aus, um den Bereich Tabelle bearbeiten für die ausgewählte Tabelle zu öffnen.
2. Bearbeiten Sie die Einstellungen wie gewünscht und wählen Sie Speichern aus .

In der folgenden Tabelle werden die Tabelleneinstellungen beschrieben.

Einstellung	Beschreibung
Tabellenname	Der Name der Eingabetabelle in Datentransformationen.
Obligatorisch	Option zum Definieren der Tabelle als obligatorisch. Bei TRUE wird die Tabelle später beim Veröffentlichen oder Importieren der Prozess-App benötigt. Wenn die Tabelle dann nicht hochgeladen wird, wird ein Fehler ausgelöst. Bei FALSE wird die Tabelle beim Veröffentlichen oder Importieren der App als optional betrachtet. Wird die Tabelle dann nicht hochgeladen, wird eine leere Tabelle erstellt, damit nachfolgende SQL-Abfragen nicht fehlschlagen.
Automatisch erkennen	Ermöglicht es Ihnen, Feldtypen in der Eingabedatei zu identifizieren und die erkannten Feldtypen automatisch auf die entsprechenden Felder in der Zieltabelle anzuwenden.
Codierung	Die in der Datei verwendete Codierung.
Trennzeichen	Das Trennzeichen, das die verschiedenen Felder trennt.
Zeilenende	Das Zeichen, das verwendet wird, um das Ende einer Zeile und den Anfang einer neuen Zeile anzugeben.
Anführungszeichen	Das verwendete Anführungszeichen für Groß- und Kleinschreibungsfelder ist in Anführungszeichen gesetzt.
Escape-Zeichen	Das Escape-Zeichen, das verwendet wird, um Zeichen korrekt zu interpretieren, die sonst als spezielle Steuerzeichen behandelt würden (z. B. Anführungszeichen oder Trennzeichen). Hinweis: Standardmäßig wird das ausgewählte Anführungszeichen als Escape-Zeichen verwendet. Alternativ können Sie den umgekehrten Schrägstrich (\) als Escape-Zeichen auswählen.
Ladetyp	Der Lasttyp für die Tabelle. Hinweis: Wenn Sie als Lasttyp Inkrementell auswählen, müssen Sie zusätzliche Einstellungen angeben, um die inkrementelle Last für die Tabelle zu konfigurieren.

Inkrementelles Datenladen

Bei einem vollständigen Ladevorgang werden alle Daten aus der Quelle extrahiert und in das Zielsystem geladen, unabhängig davon, ob sich die Daten seit dem letzten Laden geändert haben oder gleich geblieben sind. Bei einem inkrementellen Ladevorgang werden nur Daten extrahiert, die sich seit dem letzten Ladevorgang geändert (hinzugefügt oder aktualisiert) haben. Ein inkrementelles Laden ist in der Regel schneller und weniger ressourcenintensiv als ein vollständiges Laden, insbesondere wenn es um große Datenmengen geht, bei denen sich nur eine kleine Teilmenge häufig ändern kann.

Um das inkrementelle Laden von Daten für eine Tabelle zu aktivieren, müssen Sie den Ladetyp für die Tabelle auf Inkrementell festlegen. Inkrementelles Laden erfordert einen eindeutigen Bezeichner, um sicherzustellen, dass die Daten korrekt geladen werden, und ein Feld (z. B. ein Zeitstempel oder eine Version), um Änderungen in den Quelldaten nachzuverfolgen.

In der folgenden Tabelle werden die zusätzlichen Einstellungen beschrieben, die für das inkrementelle Laden erforderlich sind.

Einstellung	Beschreibung
Primärschlüssel	Das Primärschlüsselfeld oder die Felder, die jeden Datensatz in der Datenquelle eindeutig identifizieren.
Zeitstempelfeld	Das Feld, mit dem nachverfolgt wird, wann ein Datensatz zuletzt aktualisiert oder hinzugefügt wurde.
Zeitstempelformat	Das Format des Zeitstempelwerts, der im Feld Zeitstempel verwendet wird.

Wichtig:

Die zum Laden von Daten verwendete Extraktionsmethode kann eine zusätzliche oder spezifische Konfiguration für die inkrementelle Extraktion erfordern. Weitere Informationen zum Einrichten der inkrementellen Extraktion für CData Sync finden Sie unter Laden von Daten mit CData Sync. Weitere Informationen zum Einrichten der inkrementellen Extraktion für Theobald Xtract Universal finden Sie unter Laden von Daten mit Theobald Xtract Universal. Weitere Informationen zum Einrichten von DataUploader für die inkrementelle Extraktion finden Sie unter Laden von Daten mit DataUploader . Wenn Sie den Ladetyp zurück zu Vollständig ändern, stellen Sie sicher, dass Sie die verwendete Extraktionsmethode entsprechend konfigurieren.

Entfernen einer Quelldatei

Wenn Sie beim Hochladen von Quelldaten versehentlich eine Quelldatei auswählen, können Sie sie aus dem Bildschirm Eingabedaten entfernen.

Hinweis:

Eine Quelldatei kann nur entfernt werden, wenn keine Daten dafür hochgeladen wurden.

Führen Sie die folgenden Schritte aus, um eine Quelldatei zu entfernen.

1. Suchen Sie in der Liste Quelltabellen die Quelldatei, die Sie entfernen möchten.
2. Zeigen Sie mit der Maus auf die Tabelle und wählen Sie Datei entfernen aus.

Die Eingabedatei wird entfernt.

Löschen einer Eingabetabelle

Sie können eine Eingabetabelle löschen, die Sie zuvor hochgeladen haben, direkt auf der Seite „Zuordnungstabellen“ im Bildschirm „Eingabedaten“. Beim Löschen einer Eingabetabelle werden die Daten für Ihre Prozess-App entfernt. Wenn Sie die Daten in Ihrer Prozess-App zu einem späteren Zeitpunkt verwenden möchten, müssen Sie die Eingabetabelle erneut hochladen.

Wichtig:

Das Löschen einer Tabelle kann dazu führen, dass Datentransformationen fehlschlagen.

Führen Sie die folgenden Schritte aus, um eine Tabelle zu löschen.

1. Suchen Sie die Tabelle, die Sie löschen möchten, und wählen Sie das Symbol Tabelle löschen aus. Eine Bestätigungsmeldung wird angezeigt.
2. Wählen Sie Löschen aus.

Zuordnen und Konfigurieren von Eingabefeldern

Wenn Sie mit der Konfiguration der Eingabetabellen fertig sind, können Sie die Eingabefelder für die Tabellen zuordnen und konfigurieren. Wählen Sie Weiter auf der Seite Tabellen aus. Die Seite Felder wird angezeigt.

Für jede Tabelle werden die Felder aus der Quelldatei automatisch erkannt und den entsprechenden Feldern in der Zieltabelle zugeordnet.

Zuordnen von Eingabefeldern

Ihre Eingabedaten müssen dem für Ihre App definierten Datenmodell entsprechen. Bei Bedarf können Sie ein Quellfeld einem anderen Zielfeld zuordnen.

Die Option Automatisch erkennen erkennt Feldtypen in der Eingabedatei und wendet die erkannten Feldtypen automatisch auf die entsprechenden Felder in der Zieltabelle an.

Konfigurieren von Eingabefeldern

Die Einstellungen für die Zieleingabefelder werden automatisch erkannt und Sie müssen sie nur überprüfen.

Führen Sie die folgenden Schritte aus, um die Einstellungen für ein Eingabefeld zu bearbeiten.

1. Suchen Sie das Feld, das Sie konfigurieren möchten, und wählen Sie das Symbol Feld bearbeiten aus, um den Bereich Feld bearbeiten für das ausgewählte Feld zu öffnen.
2. Bearbeiten Sie die Einstellungen wie gewünscht und wählen Sie Speichern aus .

In der folgenden Tabelle werden die Tabelleneinstellungen beschrieben.

Einstellung	Beschreibung
Name	Der Name des Felds. Hinweis: Name ist ein Pflichtfeld.
Automatisch erkennen	Ermöglicht es Ihnen, den Feldtyp in der Eingabedatei zu identifizieren und den erkannten Feldtyp automatisch für das Feld in der Zieltabelle anzuwenden.
Typ	Der Datentyp des Felds. * Text * Integer * Dezimalzahl * Boolescher Wert • Datum * DateTime Hinweis: Je nach Feldtyp müssen Sie Analyseeinstellungen angeben, um das Feld zu konfigurieren.
Obligatorisch	Option zum Definieren des Felds als obligatorisch. Wenn diese Option ausgewählt ist, ist das Feld beim Veröffentlichen oder Importieren der Prozess-App erforderlich. Ein Fehler wird dann ausgegeben, wenn das Feld fehlt. Wenn diese Option nicht ausgewählt ist, gilt das Feld als optional. Wenn es fehlt, wird das Feld mit NULL-Werten hinzugefügt, damit nachfolgende SQL-Abfragen nicht fehlschlagen.
Eindeutig	Option zum Definieren des Feldwerts mit einem eindeutigen oder eindeutigen Wert für jeden Datensatz.
Nicht NULL	Option zum Definieren, dass das Feld für jeden Datensatz einen Wert haben muss. Das Feld darf nicht leer gelassen oder mit einem NULL-Wert ausgefüllt werden.

Analysieren Sie die Einstellungen für Feldtypen

In der folgenden Tabelle sind die verfügbaren Analyseeinstellungen für die verschiedenen Feldtypen beschrieben.

Feldtyp	Einstellungen parsen
Integer	Tausendertrennzeichen * Keine * Punkt (.) z. B. Komma (,)
Dezimalzahl	* Dezimaltrennzeichen     * Punkt (.)     z. B. Komma (,) * Tausendertrennzeichen     * Keine     * Punkt (.)     z. B. Komma (,)
Boolescher	# True-Wert: TRUE oder 1 False-Wert: FALSE oder 0 Hinweis: Der Wert „true“ und „false“ sind obligatorische Einstellungen und müssen unterschiedlich sein.
Datum	Datumsformat (Sehen Sie sich die Beispiel-Analyseeinstellungen für Datumsformate an ).
DateTime	Datums- und Uhrzeitformat Datumsformat (Siehe Beispiel-Analyseeinstellungen für Datetime-Formate.)

Beispiele für Analyseeinstellungen für Datumsformate

Format	Beispiel
yyyy-mm-dd	2025-04-05 2025-4-5
mm/dd/yy	04/05/25 4/5/25
mm/dd/yyyy	04/05/2025 4/5/2025
mm-dd-yyyy	04-05-2025 4-5-2025
dd-mm-yyyy	05-04-2025 5-4-2025
yyyy/mm/dd	2025/04/05

Beispiele für Analyseeinstellungen für Datetime-Formate

Format	Beispiel
yyyy-mm-dd hh:mm:ss[.nnn]	2025-04-05 14:30:45.123 2025-4-5 14:30:45.123
yyyy/mm/dd hh:mm:ss[.nnn]	2025/04/05 14:30:45.123 2025/4/5 14:30:45.123
mm/dd/yyyy hh:mm:ss[.nnn]	04/05/2025 14:30:45.123 4/5/2025 14:30:45.123 04/05/2025 14:30:45 4/5/2025 14:30:45
yyyy-mm-ddThh:mm:ss[.nnn]	2025-04-05T14:30:45.123 2025-4-5T14:30:45.123
mm-dd-yyyy hh:mm:ss[.nnn]	04-05-2025 14:30:45.123 4-5-2025 14:30:45.123 04-05-2025 14:30:45 4-5-2025 14:30:45
dd-mm-yyyy hh:mm:ss[.nnn]	05-04-2025 14:30:45.123 5-4-2025 14:30:45.123 05-04-2025 14:30:45 5-4-2025 14:30:45
yyyy-mm-ddThh:mm:ss[.nnn]+00:00*	2025-04-05T14:30:45.123+02:00 2025-04-05T14:30:45-03:00 2025-04-05T14:30:45 2025-4-5T14:30:45.123+02:00 2025-4-5T14:30:45-03:00 2025-4-5T14:30:45Z
yyyy-mm-ddThh:mm:ss[.nnn]+0000*	2025-04-05T09:30:00+0000 2025-04-05T09:30:00.123+0000
yyyy-mm-dd hh:mm:ss[.nnn]+00:00*	2025-04-05 09:30:00+00:00 2025-04-05 09:30:00.123+00:00
yyyy-mm-dd hh:mm:ss[.nnn]+0000*	2025-04-05 09:30:00+0000 2025-04-05 09:30:00.123+0000
dd/mm/yyyy hh:mm:ss[.nnn]	05/04/2025 14:30:45.123 5/4/2025 14:30:45.123
mm/dd/yy hh:mm:ss[.nnn] AM/PM	04/05/25 02:30:45 PM 4/5/25 02:30:45 PM

** Zeitstempel, die Zeitzoneninformationen enthalten, werden während der Datenerfassung automatisch in UTC konvertiert.

Anpassen vorhandener Prozess-Apps zur Verwendung des Bildschirms „Eingabedaten verwalten“.

Einleitung

Hinweis:

Obwohl vorhandene Prozess-Apps voll funktionsfähig bleiben, können Sie Prozess-Apps anpassen, um den Bildschirm Eingabedaten verwalten in Process Mining zu verwenden. Mit dem Bildschirm Eingabedaten verwalten können Sie einfach neue Eingabetabellen und Eingabefelder hinzufügen. Daher wird empfohlen, Prozess-Apps anzupassen, bei denen sich die Struktur der Eingabedaten ändern kann. Wenn Sie nicht viele Änderungen an der Struktur der Eingabedaten erwarten, sollten Sie in Betracht ziehen, die App nicht anzupassen.

Wenn Sie den Bildschirm Eingabedaten verwalten verwenden möchten, um die Tabellen und Felder für eine vorhandene Prozess-App zu laden, müssen Sie die auf dieser Seite beschriebenen Schritte manuell ausführen.

Voraussetzungen

Bevor Sie mit der Anpassung Ihrer App beginnen:

1. Stellen Sie sicher, dass alle Änderungen an der Prozess-App veröffentlicht werden.
2. Exportieren oder klonen Sie die Prozess-App, um eine Sicherung zu speichern.

Schritte

Tipp:

Die Eingabeabfragen sind die SQL-Dateien, die auf eine Tabelle verweisen, die im Abschnitt sources definiert ist. Diese Modelle befinden sich in der Regel im Ordner 1_input.

Führen Sie diese Schritte für jede der Eingabeabfragen aus.

1. Stellen Sie sicher, dass die SQL-Eingabedatei nur Umbenennungen und Typumwandlungen enthält. Verschieben Sie andere Logik (Filterung, abgeleitete Spalten usw.) in nachfolgende SQL-Dateien.

Die folgende Abbildung zeigt ein Beispiel für eine Event_log_input.sql -Datei, die nur Umbenennungen und Typumwandlungen enthält.

2. Gehen Sie zu Eingabedaten verwalten und passen Sie die Feldeigenschaften für jedes Feld an. Weitere Informationen dazu finden Sie unter Zuordnen und Konfigurieren von Eingabefeldern .

1. Legen Sie den Datentyp und die Umbenennungen mit der Option Eingabedateneinstellungen verwalten in Datentransformationen fest.
2. Überprüfen Sie die Feldattribute (Obligatorisch, Eindeutig, nicht NULL) im Bereich Feldeigenschaften und stellen Sie sicher, dass sie korrekt festgelegt sind.

3. Überprüfen Sie alle SQL-Dateien auf Verweise auf die Eingabetabelle: {{ ref('table_name') }} und aktualisieren Sie diese Verweise, um die neue Tabelle zu verwenden:

Ersetzen Sie jedes Vorkommen von {{ ref('table_name') }} durch {{ source('sources', 'source_table_name') }}. Beispiel: Ersetzen Sie {{ ref('Event_log_input') }} , das auf Ihre SQL-Dateien verweist, durch {{ source('sources', 'Event_log_raw') }} , um direkt auf die Quelltabelle zu verweisen.

Hinweis:

Diese Verweise können in jeder SQL-Datei vorkommen.

4. Da die ursprüngliche SQL-Eingabedatei nicht mehr verwendet wird, können Sie sie jetzt sicher löschen.
   Wichtig:

   Wenn Ihre Transformationen eine Formateinstellung enthalten, die in Einstellungen für Eingabedaten verwalten noch nicht verfügbar ist, sollte das Typ-Casting in den dbt -Transformationen verbleiben. Beispielsweise sind SAP-Datumen nicht verfügbar (JJJJMMTT).

Fehlersuche und ‑behebung

Frage

Die Datei, die ich zuvor hochgeladen habe, kann nicht korrekt geladen werden.

Mögliche Lösung

Überprüfen Sie die Codierung und Zeilenenden der Dateien, um zu überprüfen, ob sie mit den Tabelleneinstellungen übereinstimmen. Weitere Informationen finden Sie unter Zuordnen und Konfigurieren von Eingabetabellen .