Menüpfad: Reporting › Reports › Custom Query Jobs
Menüpfad | Reporting › Reports › Custom Query Jobs |
Berechtigung | SuperAdmin |
Voraussetzung | eine lesende SQL-Abfrage für die Standorte liegt bereit |
Führt eine schreibgeschützte SQL-Abfrage gleichzeitig über mehrere Standorte aus, verfolgt den Fortschritt und zeigt die Ergebnisse je Standort. Nur SELECT-Anweisungen oder CTEs mit WITH sind erlaubt.
Eine Abfrage ausführen
- Wählen Sie mindestens eine Standort-Filterart (z. B. „Standort IDs") und füllen Sie sie.
- Setzen Sie optional „Start"/„Ende", „Max. Standorte", „Parallele Abfragen" und „Nur online".
- Schreiben Sie die SQL-Abfrage in den SQL-Editor.
- Prüfen Sie die Validierungshinweise unter dem Editor — sie müssen leer sein bzw. „SQL Validierung für die Frontend-Regeln erfolgreich." zeigen.
- Klicken Sie „Job starten".
- Klicken Sie in der Job-Liste bei Ihrem Job auf das Symbol für Ergebnisse, um die Standortergebnisse zu sehen.
- Optional: Klicken Sie das CSV-Symbol, um die abgeschlossenen Zeilen herunterzuladen.
Der Job läuft je Standort einzeln; Fortschritt und Status aktualisieren sich automatisch alle 5 Sekunden. Abgeschlossene Standorte zeigen ihre Ergebnisspalten in der Tabelle „Standortergebnisse"; laufende Jobs zeigen „Standortergebnisse erscheinen, sobald der laufende Job Standorte verarbeitet."
Standortauswahl und Ausführungsparameter
Feld | Bedeutung | Werte | Pflicht |
|---|---|---|---|
Standort IDs | schränkt auf konkrete Standort-IDs ein | Liste | mindestens eine Filterart aktiv |
PLZ | Filter nach Postleitzahl | Text | s. o. |
Stadt | Filter nach Stadtnamen | Text | s. o. |
Ländercode | Filter nach Ländercode, wird groß geschrieben | Text | s. o. |
Start / Ende | Zeitfenster, in dem die Standorte zuletzt online gewesen sein müssen | Datum/Uhrzeit | – |
Max. Standorte | Obergrenze der einbezogenen Standorte, vorbelegt 100 | Zahl | größer 0 |
Parallele Abfragen | wie viele Standorte gleichzeitig abgefragt werden, vorbelegt 4 | Zahl | 1 bis 64 |
Nur Standorte der letzten 30 Minuten online | beschränkt auf zuletzt aktive Standorte, vorbelegt an | An/Aus | – |
Die Liste bestehender Jobs zeigt Job-ID, Status, Fortschrittsbalken, die Kennzahlen „Erfolgreich"/„Fehlgeschlagen"/„Übersprungen", Erstellungs-/Aktualisierungsdatum und die Aktionen Ergebnisse anzeigen, erneut starten, abbrechen (nur bei laufenden Jobs). Ohne Jobs steht dort „Keine Custom Query Jobs gefunden."
Job-Status
Ein Job zeigt als Abzeichen in der Job-Liste einen von sechs Zuständen: In Warteschlange, Läuft, Abgeschlossen, Mit Fehlern abgeschlossen, Fehlgeschlagen, Abgebrochen.
Der Standort-Status je Zeile der Standortergebnisse verwendet ein eigenes, teils überschneidendes Vokabular: Ausstehend, Läuft, Erfolgreich, Fehlgeschlagen, Offline übersprungen. Ein Job kann laufen, während einzelne seiner Standorte bereits Erfolgreich oder Offline übersprungen sind — einen Zustand, den es beim Job selbst nicht gibt.
Hinweis: Der Reiter „Custom Query Jobs" verlangt die Rolle SuperAdmin und erschien beim
Prüfen mit einem Testkonto ohne diese Rolle nicht in der Reiterleiste unter „Reporting →
Reports".