DB2-Extrakt importieren

Beschreibung

Importieren Sie eine IBM-DB2-Extraktdatei aus dem PlaidCloud-Document-Speicher. Das ist nützlich, wenn der DB2-Server nur über die lokale Infrastruktur erreichbar ist: Ein externer Prozess legt den Extrakt im PlaidCloud-Document-Speicher ab, und dieser Schritt liest ihn von dort in eine Projekttabelle.

Für den Live-Zugriff auf DB2 (ohne Extraktdatei) verbinden Sie sich über die Standardverbindung IBM DB2 und verwenden Externe Datenbanktabellen importieren.

Beispiele

Noch keine Beispiele …

Spezifische Konfigurationselemente

Keine

Allgemeine Konfigurationselemente

Option „Nicht-ASCII-Zeichen entfernen“

Wenn Sie diese Option auswählen, entfernt der Import jeden Inhalt, der nicht ASCII ist. PlaidCloud unterstützt Unicode (UTF-8) zwar vollständig, doch reale Dateien können alle möglichen Kodierungen und vereinzelte Zeichen enthalten, die ihre Verarbeitung erschweren.

Wenn der Inhalt der Datei voraussichtlich nur aus ASCII besteht, hilft das Aktivieren dieses Kontrollkästchens, einen reibungslosen Ablauf des Importvorgangs sicherzustellen.

Option „Dateien nach dem Import löschen“

Mit dieser Option löscht der Importvorgang die Datei nach einem erfolgreichen Import aus dem PlaidCloud-Dokumentenkonto.

Das ist nützlich, wenn die Importdateien aus einem führenden System neu erzeugt werden können oder es keinen Grund gibt, die Rohdateien nach ihrer Verarbeitung aufzubewahren.

Es werden nur Dateien gelöscht, die importiert wurden. Eine Datei, die übersprungen wurde oder beim Import eine Warnung ausgelöst hat, verbleibt im Ordner.

Dateiauswahl für den Import

Mit der Dateiauswahl in dieser Transformation wählen Sie eine Datei, die an einem PlaidCloud-Dokumentspeicherort liegt, zum Import aus.

Sie können auch ein Verzeichnis wählen. Dann werden alle Dateien in diesem Verzeichnis bei der Ausführung der Transformation importiert.

Dokumentenkonto auswählen

Wählen Sie ein PlaidCloud-Dokumentenkonto, auf das Sie Zugriff haben. Anschließend können Sie in der nächsten Auswahl ein Verzeichnis oder eine Datei wählen.

Innerhalb eines Projekts bietet die Liste oben auch Projektstandard an, einen Platzhalter für das Konto, das im Projekt aktuell als Standard festgelegt ist. Ein neuer Schritt wählt „Projektstandard“ vorab aus, wenn das Projekt einen hat. Ein bestehender Schritt behält das Konto, mit dem er gespeichert wurde, bis Sie es ändern. Ein Schritt, der auf „Projektstandard“ steht, wird mit dem Konto ausgeführt, das zum Zeitpunkt der Ausführung der Projektstandard ist. Ist keiner festgelegt, schlägt die Ausführung fehl und nennt das Projekt, anstatt auf ein anderes Konto auszuweichen.

Option „Suchen“

Mit der Option Suchen finden Sie alle passenden Dateien unterhalb eines angegebenen Verzeichnispfads zum Import. Das ist besonders nützlich, wenn viele Dateien einbezogen werden sollen, aber in verschachtelten Verzeichnissen liegen oder mit anderen Dateien im selben Verzeichnis vermischt sind, die Sie nicht importieren möchten.

Der ausgewählte Suchpfad ist das Startverzeichnis der Suche. Die Suche berücksichtigt alle Dateien in diesem Verzeichnis sowie in den Unterverzeichnissen, die den angegebenen Suchbedingungen entsprechen. Stellen Sie sicher, dass sich die Suchkriterien auch auf die Dateien in den Unterverzeichnissen anwenden lassen.

Die Suche kann mit den folgenden Bedingungen erfolgen:

Exakt: Der Suchtext muss genau übereinstimmen.
Beginnt mit: Findet jede Datei, die mit dem Suchtext beginnt.
Enthält: Findet jede Datei, die den Suchtext enthält.
Endet mit: Findet jede Datei, die mit dem Suchtext endet.

Ein KI-Assistent oder die REST-API kann die Suche außerdem auf glob setzen, ein Platzhaltermuster wie CO Store*.yxdb, das ohne Beachtung der Groß-/Kleinschreibung mit dem gesamten Dateinamen verglichen wird, oder auf regex, einen regulären Ausdruck, dem der gesamte Dateiname entsprechen muss. Ein regulärer Ausdruck unterscheidet zwischen Groß- und Kleinschreibung, es sei denn, er beginnt mit (?i).

Option „Datei oder Verzeichnis auswählen“

Wenn eine bestimmte Datei oder ein bestimmtes Verzeichnis mit Dateien importiert werden soll, ist die direkte Auswahl der Datei oder des Verzeichnisses besser als die Suche.

Um die Datei oder das Verzeichnis auszuwählen, wählen Sie über die Schaltfläche „Durchsuchen“ den Pfad im oben gewählten Dokumentenkonto.

Variablenersetzung

Sowohl bei der Suche als auch bei der Auswahl einer bestimmten Datei oder eines bestimmten Verzeichnisses können Sie Variablen im Pfad, im Suchtext und in Dateinamen verwenden.

Ein Beispiel, das die Variable current_month verwendet, um dynamisch auf die richtige Datei zu verweisen:

legal_entity/inputs/{current_month}/ledger_values.csv

Zieltabelle

Als Importziel können nur Tabellen gewählt werden, da Ansichten keine zugrunde liegenden Daten enthalten.

Option „Dynamisch“

Mit der Option „Dynamisch“ geben Sie eine Tabelle als Text an, auch mit Variablen. Das ist nützlich bei variablengesteuerten Workflows, in denen sich Verweise auf Tabellen und Ansichten nach den angegebenen Variablen richten.

Ein Beispiel, das die Variable current_month verwendet, um dynamisch auf die Zieltabelle zu verweisen:

legal_entity/inputs/{current_month}/ledger_values

Option „Statisch“

Wenn eine bestimmte Tabelle als Ziel für den Import dienen soll, lassen Sie das Kontrollkästchen Dynamisch deaktiviert und wählen Sie die Zieltabelle aus.

Wenn die Zieltabelle nicht existiert, wählen Sie die Schaltfläche Neu erstellen, um die Tabelle am gewünschten Speicherort anzulegen.

Der Tabellen-Explorer steht bei jeder Tabellenauswahl zur Verfügung. Klicken Sie auf die Schaltfläche „Tabellen-Explorer“ rechts neben der Tabellenauswahl, um ein Tabellen-Explorer-Fenster zu öffnen.

Data-Mapper-Konfiguration

Tabellen-Data-Mapper

Der Data Mapper ordnet Spalten der Quelldaten der Zieldatentabelle zu.

Untersuchen und Füllen des Mappers

Mit der Menüschaltfläche Quelle untersuchen stehen Ihnen weitere Möglichkeiten zur Verfügung, Spalten von der Quelle dem Ziel zuzuordnen:

Beide Zuordnungstabellen füllen: Übernimmt alle Werte aus der Quelldatentabelle in die Zieldatentabelle. Dies ist die Standardeinstellung.
Nur Quellzuordnungstabelle füllen: Ordnet nur alle Werte in der Quelldatentabelle zu. Das ist hilfreich, wenn Sie einen bestehenden Workflow ändern und sich die Spaltenstruktur der Quelle geändert hat.
Nur Zielzuordnungstabelle füllen: Übernimmt alle Werte nur in die Zieldatentabelle.

Reichen die Optionen für Quell- und Zielspalten nicht aus, können Sie auf verschiedene Weise weitere Spalten in die Zieldatentabelle einfügen:

Alle übernehmen fügt alle Quellspalten in die Zieldatentabelle ein, unabhängig davon, ob sie dort bereits vorhanden sind.
Ausgewählte übernehmen fügt nur die ausgewählten Quellspalten ein.
Klicken Sie mit der rechten Maustaste auf die Zielseite und wählen Sie Zeile einfügen, um direkt über der aktuell ausgewählten Zeile eine Zeile einzufügen.
Klicken Sie mit der rechten Maustaste auf die Zielseite und wählen Sie Zeile anhängen, um am unteren Ende (ganz rechts) der Zieldatentabelle eine Zeile einzufügen.

Spalten löschen

Um Spalten aus der Zieldatentabelle zu löschen, wählen Sie die gewünschten Spalten aus, klicken Sie mit der rechten Maustaste und wählen Sie Löschen.

Quellspalten, die nicht mehr aufgeführt sind

Eine Zielzeile kann eine Quellspalte benennen, die die Quelldatentabelle nicht mehr aufführt, zum Beispiel nachdem die Quelle erneut untersucht wurde. Der Schritt entfernt eine solche Zeile nie von selbst. Stattdessen wird der Spaltenname rot hinter einem Warnsymbol ⚠ angezeigt, und beim Daraufzeigen erscheint der Hinweis, dass die Spalte nicht in den Quellspalten enthalten ist. Bei einem Schritt mit mehreren Tabellen, etwa einer Union, wird jede Tabelle anhand ihrer eigenen Quellspalten geprüft.

Eine Zeile mit einer Konstante, einem Ausdruck oder einer Zusammenfassung Anzahl (einschließlich Nullwerte) wird nie markiert, da der Schritt ihre Quellspalte nicht liest. Solange die Quelldatentabelle keine Spalten aufführt, wird nichts markiert, zum Beispiel bevor die Quelle zum ersten Mal untersucht wurde.

Wenn Sie einen Schritt speichern, der noch markierte Zeilen enthält, listet ein Dialog Veraltete Spalten gefunden diese unter der Registerkarte oder Tabelle auf, auf der sie sich befinden, und bietet drei Optionen:

Alle entfernen und speichern — die markierten Zeilen entfernen und anschließend speichern.
Trotzdem speichern — den Schritt unverändert speichern.
Abbrechen — zum Schritt zurückkehren, ohne zu speichern.

Um eine Zeile beizubehalten und ihre Warnung zu beseitigen, fügen Sie die Spalte wieder zur Quelldatentabelle hinzu oder wählen Sie eine Spalte, die die Quelldatentabelle aufführt.

Spaltendatentyp

Jede Zielspalte hat einen Typ. Eine aus der Quelle übernommene Spalte behält den Typ der Quellspalte; eine von Hand hinzugefügte Zeile beginnt als Text, und Sie legen den Typ fest, den sie tatsächlich haben soll — eine Spalte, die Sie summieren oder sortieren möchten, benötigt ihren numerischen Typ oder Datumstyp, denn Text wird als Text sortiert und summiert.

Ein Schritt, der mit einer Spalte ohne jeden Typ gespeichert wurde, wird trotzdem ausgeführt. Der Typ wird beim Start des Schritts anhand der Quellspalte ermittelt, die diese Spalte liest. Gibt es nichts, woraus er sich ablesen ließe, wird er als Text behandelt: Die Spalten eines Schritts SQL extrahieren stammen aus der von Ihnen geschriebenen Abfrage und nicht aus einer zugeordneten Quelle, und wenn mehrere Quellen dieselbe Spaltenbezeichnung mit unterschiedlichen Typen führen, wird Text verwendet, statt einen davon zu erraten — eine falsche Vermutung führt zu einer Konvertierung, die das Warehouse ablehnen kann, und alles lässt sich in Text umwandeln.

Den Typ selbst festzulegen ist weiterhin der Weg, um zu bestimmen, was eine Spalte sein soll. Lassen Sie ihn leer, übernehmen Sie, was auch immer die Quellspalte gerade ist.

Spaltenreihenfolge ändern

Um Spalten in der Zieldatentabelle neu anzuordnen, wählen Sie die gewünschten Spalten aus. Dazu haben Sie zwei Möglichkeiten:

Pfeile für Massenverschiebung: Wählen Sie die gewünschte Verschiebeoption über die Pfeile oben rechts aus.
Kontextmenü: Klicken Sie mit der rechten Maustaste und wählen Sie An den Anfang verschieben, Nach oben, Nach unten oder An das Ende verschieben.

Ergebnis auf eindeutige Datensätze beschränken

Um nur eindeutige Werte zurückzugeben, wählen Sie die Menüoption Eindeutig. Dadurch wird für jede Spalte der Quelle ein Kontrollkästchen eingeblendet. Aktivieren Sie einfach das Kontrollkästchen neben der jeweiligen Spalte, um nur eindeutige Ergebnisse zurückzugeben.

Je nach Situation kann es sinnvoll sein, stattdessen eine Zusammenfassung in Betracht zu ziehen.

Beim Eindeutig-Verfahren bleibt der erste gefundene eindeutige Datensatz erhalten, die übrigen werden verworfen. Wenn Konsistenz zwischen den Ausführungen wichtig ist, sollten Sie die Daten sortieren.

Aggregation und Gruppierung

Um Ergebnisse zu aggregieren, wählen Sie die Menüoption Zusammenfassen. Dadurch wird für jede Spalte in der Zieldatentabelle ein Auswahlfeld eingeblendet. Wählen Sie für jede Spalte eine geeignete Zusammenfassungsmethode aus.

Wenn Quelle untersuchen die Spalten füllt, beginnt eine Zahlenspalte als Gruppieren nach statt als Summe, wenn ihr Name wie ein Bezeichner aussieht, etwa id, customer_id, Order No oder CustomerKey, wenn ihre Tabelle sie als Schlüssel festlegt oder wenn der Join sie als Schlüssel verwendet.

Gruppieren nach
Summe
Min
Max
Erster
Letzter
Anzahl
Anzahl (einschließlich Nullwerte)
Mittelwert
Standardabweichung
Stichproben-Standardabweichung
Grundgesamtheits-Standardabweichung
Varianz
Stichprobenvarianz
Grundgesamtheitsvarianz
Erweitert ohne Gruppierung

Informationen zur erweiterten Nutzung des Data Mappers, etwa zu Ausdrücken, Bereinigung und Konstanten, finden Sie unter Erweiterte Nutzung des Data Mappers

Table Data Filters

Für maximale Flexibilität stehen Datenfilter sowohl für die Quelldaten als auch für die Zieldaten zur Verfügung. Bei größeren Datensätzen kann es besonders vorteilhaft sein, Zeilen bereits in der Quelle herauszufiltern, sodass die übrigen Operationen auf einem kleineren Datensatz ausgeführt werden.

Teilmenge der Daten auswählen

Mit diesem Filtertyp filtern Sie die eingehenden Quelldaten anhand der angegebenen Bedingungen.

Sekundären Filter auf Ergebnisdaten anwenden

Mit diesem Filtertyp wenden Sie anhand der angegebenen Bedingungen einen Filter auf die Ergebnisdaten nach der Transformation an. Dadurch können Zeilen anhand der Ergebnisse komplexer Berechnungen, Zusammenfassungen oder Fensterfunktionen ausgeschlossen werden.

Zeilenbegrenzung der endgültigen Datentabelle (Limit)

Mit der Zeilenbegrenzung schränken Sie die Zeilen im Ergebnis anhand eines Bereichs und eines Startpunkts ein.

Filtersyntax

Die Filtersyntax nutzt Python SQLAlchemy und entspricht damit der Syntax anderer Ausdrücke.

Beispiele und Ausdrucksfunktionen finden Sie im Bereich Ausdrücke.