Historische Daten exportieren

Der Historienexport erzeugt Dateien im Hintergrund. Er eignet sich zum Aufbewahren unverarbeiteter Detaildaten oder zur Analyse mit anderen Werkzeugen, ohne dass der Browser bis zum Abschluss der Abfrage warten muss.

Exportablauf

1. Wählen Sie Datenpunkte und Zeitraum. Für freigegebene Datenpunkte geben Sie das Quellgerät an.
2. Prüfen Sie die Speicherplatzschätzung und erstellen Sie anschließend den Exportauftrag.
3. Verfolgen Sie in der Auftragsliste die Zustände Wartend, Laufend, Abgeschlossen oder Fehlgeschlagen. Nicht mehr benötigte Aufträge können abgebrochen werden.
4. Fordern Sie nach Abschluss eine kurzzeitig gültige Downloadberechtigung an und laden Sie die CSV- oder ZIP-Datei herunter.

Aufträge unterliegen Grenzen für Zeitraum, Dateigröße, Parallelität und freien Speicherplatz. Bei Platzmangel wird der Export abgelehnt oder gestoppt. Die konkreten Grenzen richten sich nach der Gerätekonfiguration.

Dateien und Daten

• Unterstützt historische Erfassungs-, Aggregations- und Freigabewerte. Wählen Sie denselben Datenpunkt desselben Geräts nicht mehrfach aus.
• CSV bewahrt die Kennzeichnung fehlender Werte und unterscheidet damit „keine Daten“ von einer leeren Zeichenfolge.
• Downloadberechtigungen sind zeitlich begrenzt und müssen nach Ablauf erneut angefordert werden. Geben Sie sie nicht öffentlich weiter.
• Exportiert werden die im gewählten Zeitraum noch vorhandenen Daten. Durch Aufbewahrungsregeln bereits gelöschte Historie lässt sich nicht wiederherstellen.

Integrationsschnittstellen

Vorgang	Schnittstelle
Speicherplatzschätzung	GET /ems-data/export/disk-space
Auftrag erstellen / Auftragsliste abfragen	POST /ems-data/export/tasks / GET /ems-data/export/tasks
Einzelnen Auftrag abfragen / abbrechen	GET /ems-data/export/tasks/:taskId / DELETE /ems-data/export/tasks/:taskId
Downloadberechtigung anfordern	POST /ems-data/export/tasks/:taskId/download-ticket

Übergeben Sie beim Erstellen eines Auftrags format (CSV oder CSV_ZIP), dataKeys, startTime und endTime. Der Download ist erst nach erfolgreichem Abschluss möglich. Die Annahme des Auftrags bedeutet noch nicht, dass die Datei erzeugt wurde.

Für kurzfristige Analysen verwenden Sie historische Abfragen, für fortlaufende Speicherung regelmäßige Archivierung und für Konfigurationsmigration Sicherung und Wiederherstellung. Agentenaufrufe beschreibt der Export-Skill.