Skip to main content

Blue icon with floppy disk. In-DB-Daten-schreiben-Tool

Benutzerrolle – Anforderungen

Benutzerrolle*

Tool-/Funktionen-Zugriff

Vollbenutzer

✓

Basisbenutzer

X

* Gilt für Kunden von Alteryx OneProfessional und Enterprise Edition mit Designer-Versionen ab 2025.1.

Verwenden Sie das In-DB-Daten-schreiben-Tool, um eine Tabelle direkt in der Datenbank zu erstellen oder zu aktualisieren.

In-Database ermöglicht die Zusammenführung und Analyse großer Datenmengen, ohne die Daten aus einer Datenbank zu verschieben, und kann im Vergleich zu herkömmlichen Analysemethoden zu erheblichen Leistungsverbesserungen führen. Weitere Informationen zur In-DB-Tool-Kategorie finden Sie unter In-Datenbank: Übersicht.

Configure the Tool

Review the tool configuration options below.

Tool-Konfiguration

Ausgabemodus: Wählen Sie die entsprechende Option zum Schreiben der Daten aus. Zu den Optionen gehören:

  • Vorhandene anfügen: Fügt einer vorhandenen Tabelle alle Daten an. Die Ausgabe besteht aus „Datensätzen davor“ und „Datensätzen danach“.

  • Daten löschen und anfügen: Löscht alle ursprünglichen Datensätze aus der Tabelle und fügt der vorhandenen Tabelle anschließend die Daten an. Beachten Sie, dass dieser Modus je nach Datenbank in die Sie schreiben, unterschiedlich ist.

    • Oracle Datenbanken: Verwendet DELETE-Anweisung.

    • SQL-Server-Datenbanken: Verwendet TRUNCATE TABLE-Anweisung, da dies eine effizientere Methode ist. Sie benötigen entweder die ALTER Tabelle oder TRUNCATE Berechtigungen.

  • Tabelle überschreiben (verwerfen): Verwirft die vorhandene Tabelle vollständig und erstellt eine neue Tabelle.

  • Neue Tabelle erstellen: Erstellt eine neue Tabelle. Eine bestehende Tabelle wird dabei nicht überschrieben.

  • Temporäre Tabelle erstellen: Schreibt in eine temporäre Tabelle, die bis zum Ende der Sitzung verfügbar ist. Diese Option ist zum Erstellen von In-DB-Prognosemakros hilfreich, weil sie die Metadaten vorübergehend verankert. Wenn diese Option aktiviert ist, ist das Feld „Tabellenname“ deaktiviert, und es zeigt „[bei jeder Ausführung wird ein eindeutiger temporärer Tabellenname erzeugt]“ an.

  • Zeilen aktualisieren: Aktualisiert vorhandene Zeilen in einer Tabelle auf Grundlage der eingehenden Datensätze.

  • Zeilen löschen: Löscht vorhandene Zeilen in einer Tabelle auf Grundlage der eingehenden Datensätze.

  • Tabellen zusammenführen: Führt die eingehenden Daten mit der im Tool angegebenen Tabelle zusammen. Es unterstützt Löschen und Aktualisieren basierend auf ausgewählten Zusammenführungsfeldern.

  • Tabellenname: Geben Sie den Namen der zu erstellenden oder zu aktualisierenden Datenbanktabelle ein.

Append Fields Mapping

Feldzuordnung anfügen (oder SET Feldzuordnung, wenn Zeilen aktualisieren der ausgewählte Ausgabemodus ist): Dieser Bereich wird aktiv, wenn oben Vorhandene anfügen oder Daten löschen und anfügen ausgewählt ist.

Wählen Sie einen Konfigurationsmodus:

  • Automatisch nach Name konfigurieren: Richtet Felder nach dem Feldnamen aus.

  • Automatisch nach Position konfigurieren: Richtet Felder nach der Feldreihenfolge im Datenstrom aus.

When Fields are Different

Bei unterschiedlichen Feldern: Wählen Sie das Verhalten bei nicht konformen Datenfeldern unter den Optionen aus dem Dropdown-Menü aus.

  • Fehler - Verarbeitung stoppen: Gibt einen Fehler im Ergebnisfenster aus und beendet die Verarbeitung.

  • Anwendbare Felder ausgeben: Anwendbare Felder werden berücksichtigt. Nullwerte füllen leere Felder.

Options

Optionen: Dieser Bereich wird aktiv, wenn Zeilen aktualisieren oder Zeilen löschen als Ausgabemodus gewählt wird.

  • WHERE Feldzuordnung: Bildet die bedingte Anweisung für den Ausgabemodus Zeilen aktualisieren und Zeilen löschen.

Advanced Query Options

Use this section to define Pre- and Post-SQL statements to execute. This option is compatible with all of the above output modes. Pre- and Post-SQL statements are compatible with Bulk Loaders, OCI, ODBC, and OLE DB technologies.

To configure your SQL statements...

  1. Use the 3-dot menu associated with either the Pre- or Post-SQL Statement fields to launch the Configure Pre/Post-SQL Statements window, which includes the SQL Editor and Stored Procedures tabs.

  2. Next, define SQL statements as needed:

    • Pre-SQL Statement: Define a SQL statement to execute before running the in-database statement/query and before appending to or creating the output table.

    • Post-SQL Statement: Define a SQL statement to execute after running the in-database statement/query and after appending to or creating the output table.

    Anmerkung

    Most Pre/Post-SQL use cases involve the Write Data In-DB tool. If your workflow doesn't include a Data Stream In tool, then the next best place for session variables is the Write Data In-DB tool.

  3. To configure Pre-SQL and Post-SQL statements...

    • Use the SQL Editor tab to define a SQL statement to execute before/after the In-DB execution. When the workflow runs, the Results window displays messages to show that the tool is executing SQL statements, along with a label (PreSQL or PostSQL). All SQL statements are sent directly to the database.

      • Pre-SQL/Post-SQL statements do not return data. While SQL can return data, Designer doesn't do anything with it.

      • If there are multiple streams of In-DB tools, there is no guaranteed order of execution between different streams. The Results window displays the order.

    • Use the Stored Procedures tab to select and configure a stored procedure call for your database. You can select a Parameter and set a Value for your stored procedures if needed. All stored procedures are sent directly to the database.

      • If a stored procedure is executed successfully, it returns any necessary status messages or warnings in the Results window.

      • If a stored procedure returns data, Designer does not return it anywhere. The data is not displayed in the Results window.

      Wichtig

      Stored procedures are supported for these connections:

      • SQL Server for ODBC and Bulk Writer

      • Oracle for ODBC Only

  4. Select OK when you're finished or Cancel to return to the tool configuration window.

Abfragestruktur

Beispielabfragen für die Optionen „Zeilen aktualisieren und löschen“ für den Ausgabemodus:

Zeilen aktualisieren

WITH upstream AS ( ... ) UPDATE t SET t.col2 = (SELECT col2 FROM upstream u WHERE u.col1 = t.col1 AND ...), ... FROM target_ t WHERE EXISTS ( SELECT * FROM upstream u WHERE u.col1 = t.col1 AND ... )

Zeilen löschen

WITH upstream AS ( ... ) DELETE t from target_ t WHERE EXISTS ( SELECT * FROM upstream u WHERE u.col1 = t.col1 AND ... )

Einschränkungen

  • Ausgabeoptionen aktualisieren/löschen unterstützen derzeit keine Spaltenaliasse.

  • Die Option „Ausgabe aktualisieren" erfordert derzeit, dass alle Feldnamen mit den Feldnamen der Zieltabelle übereinstimmen (für die Option „Automatisch nach Name konfigurieren - Felder anfügen") und dass die Anzahl der Felder mit der Anzahl der Felder der Zieltabelle übereinstimmt (für die Option „Automatisch nach Position konfigurieren - Felder anfügen").

  • Aktualisieren/Löschen ist derzeit nur für ODBC-Verbindungen auf SQL-Server unterstützt.

  • Die Optionen „Ausgabe aktualisieren/löschen“ unterstützen derzeit das Aktualisieren oder Löschen von Nullwerten nicht. Die Vergleichsoperatoren (wie = oder !=), die für Alteryx „Aktualisieren und Löschen“-Abfragen verwendet werden, geben „unbekannt“ für Nullwerte zurück. Weitere Informationen finden Sie unter Microsoft SQL Server-Dokumentation.

  • Beim Anfügen von Daten mit dem In-DB-schreiben-Tool müssen alle Spalten in der Zieltabelle in die INSERT-Anweisung aufgenommen werden, damit die INSERT-Anweisung gültig ist. Fehlende Spalten werden mit einem NULLwert hinzugefügt.

  • „In-DB zusammenführen“ ist nur für Databricks Unity Catalog unterstützt.

In diesem Abschnitt: