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
@lastExecutionan 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