SQL importieren

Beschreibung

Importiert das Ergebnis einer SQL-Abfrage gegen eine externe Datenbank in eine PlaidCloud-Projekttabelle. Die Abfrage läuft auf der entfernten Datenbank; nur die Ergebnismenge wird nach PlaidCloud geholt.

Unterscheidet sich von Externe Datenbanktabellen importieren dadurch, dass Sie das SQL selbst schreiben – nützlich für komplexe Joins, Filter oder Aggregationen, die die Quelldatenbank ausführen soll, bevor die Daten in PlaidCloud landen.

Importparameter

SQL-Tabelle importieren

Quelle und Ziel

Datenbankverbindung

Informationen zum Einrichten einer Datenbankverbindung finden Sie unter PlaidCloud-Datenverbindungen

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.

SQL-Abfrage

Schreiben Sie in diesem Abschnitt die SQL-Abfrage, die die benötigten Daten zurückgibt.

Spaltentyp-Erkennung

SQL-Importe können beim Laden versuchen, den Datentyp zu erraten, oder alle Spalten auf den Typ Text setzen. Die dynamische Festlegung der Datentypen kann schneller sein, wenn die Daten sauber sind, kann aber unter Umständen zu Problemen führen.

Wenn zum Beispiel die meisten Daten numerisch erscheinen, aber auch Text enthalten ist, wird möglicherweise versucht, die Spalte als numerisch festzulegen, was beim Laden zu Problemen durch nicht passende Datentypen führt. Probleme kann es auch bei einem numerischen Produktcode mit 16 Stellen geben: Führende Nullen würden abgeschnitten, sodass eine Zahl statt eines 16-stelligen Codes entsteht.

Alle Daten auf Text zu setzen, erfordert dagegen einen nachfolgenden Extract-Schritt, um Datentypen, die nicht Text sein sollen, in den passenden Typ umzuwandeln, etwa Datums- oder Zahlenwerte.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache
Der Schritt dauerte deutlich länger als üblich – bis zu etwa eine halbe Stunde mehr –, ohne dass sich an Ihrer Abfrage, der Verbindung oder dem Datenvolumen etwas geändert hat	Der Hintergrund-Worker, der den Import ausführte, wurde mittendrin unterbrochen (ein plattformseitiger Neustart oder eine Verdrängung, nichts in Ihrem Workflow), und die Plattform hat den Import der Tabelle für Sie wiederholt. Die Wiederholung beginnt erst, wenn die Unterbrechung erkannt wird, was die zusätzliche Zeit erklärt.
Der Schritt wurde nach dieser Verzögerung trotzdem erfolgreich abgeschlossen	Die Wiederholung ersetzt den Inhalt der Tabelle vollständig, das Ergebnis entspricht also einer einzigen sauberen Ausführung – es gibt nichts weiter zu prüfen oder zu wiederholen.
Der Schritt schlägt mit „has already been attempted and cannot be safely re-run“ fehl	Bei einem Import-SQL-Schritt tritt diese Ablehnung nicht mehr auf – eine Unterbrechung mitten in der Ausführung wird stattdessen wiederholt. Sie sehen sie weiterhin, und zwar bewusst, beim Wiederherstellen eines Projektarchivs oder beim Laden einer Dimension, wo eine erneute Ausführung ein Duplikat erzeugen würde, statt etwas zu ersetzen. Öffnen Sie ein Support-Ticket, wenn Sie sie bei einem Import-SQL-Schritt selbst sehen.