Zum Inhalt springen

CSV Batch Export

Der Job CSV-BatchExport stellt das Ergebnis einer SQL-Abfrage als CSV-Datei bereit.

Der erzeugte Export kann:

  • gespeichert werden
  • per E-Mail versendet werden
  • gespeichert und versendet werden

Der Job eignet sich insbesondere für:

  • periodische Datenexporte
  • Reporting-Zwecke
  • Datenübergaben an externe Systeme

Technische Einordnung

Der Job führt ein frei definierbares SQL-Statement gegen eine konfigurierte Quelldatenbank aus und erzeugt aus der Ergebnismenge eine CSV-Datei.

Optional kann:

  • ein Namensgenerator zur Dateibenennung verwendet werden
  • das letzte Ausführungsdatum als Parameter @lastExecution an das SQL übergeben werden
  • die Datei automatisch per E-Mail versendet werden

Typspezifische Konfiguration

Allgemeine Einstellungen

Feld Beschreibung
Überschreiben wenn notwendig Ist die Checkbox aktiv, wird eine bereits vorhandene Datei mit identischem Namen überschrieben.
Kodierung Definiert die Zeichencodierung der Ergebnisdatei (z. B. UTF-8).
Trennzeichen Definiert das Feldtrennzeichen innerhalb der CSV-Datei (z. B. ;).
Überschriften weglassen Steuert, ob die CSV-Datei mit oder ohne Spaltenüberschriften erzeugt wird. Sind Überschriften aktiviert, werden die im SQL definierten Feldnamen als Spaltenüberschriften verwendet.
Namensgenerator Hier wird der Namensgenerator hinterlegt, der den Dateinamen der Ergebnisdatei erzeugt.
Verzeichnis Zielverzeichnis für die erzeugte Datei. Es können ausschließlich logische Verzeichnisse verwendet werden, die zuvor unter Communication → Ressourcen konfiguriert wurden.
Quelldatenbank Definiert die Datenbank, auf die sich das SQL (Batchcode) bezieht. Es können nur Datenbanken verwendet werden, die zuvor unter Communication → Ressourcen konfiguriert wurden.
Timeout Definiert die maximale Wartezeit auf eine Antwort der Datenbank, bevor der Lauf abgebrochen wird. Dies betrifft nicht die Laufzeit des SQL, sondern die maximale Antwortzeit der Datenbank.
LogRowsEffected Wird in diesem Jobtyp nicht verwendet.

SQL-Konfiguration

Feld Beschreibung
Batchcode Enthält das SQL-Statement zur Ermittlung der Ergebnismenge. Es darf kein Leerzeichen vor dem ersten oder nach dem letzten Zeichen des SQL enthalten sein.

E-Mail-Konfiguration (optional)

Feld Beschreibung
Email an Empfängeradresse für den E-Mail-Versand der Ergebnisdatei.
Subjekt Betreff der generierten E-Mail.
Mailtext Definiert den Textkörper der E-Mail. Es kann ein frei formulierter Fließtext hinterlegt werden.
Datei nicht an Mail anhängen Legt fest, ob die erzeugte Datei der E-Mail als Anhang beigefügt wird.

Hinweise & Empfehlungen

  • Das SQL sollte deterministisch und eindeutig sortiert sein, um reproduzierbare Ergebnisse zu gewährleisten.
  • Die Verwendung eines Namensgenerators wird empfohlen, um Dateinamenskonflikte zu vermeiden.
  • Bei produktiven Exportprozessen sollte ein dediziertes Zielverzeichnis verwendet werden.
Zuletzt aktualisiert am