Datenabfragen

Mit Data Queries können Daten aus externen Datenbanken für die Verwendung in Dashboards aufbereitet werden.

  • Entwicklung und Testen von SQL-Abfragen direkt im Admin-Bereich des SKOOR Dashboard

  • Die Leistung des Dashboards kann erhöht werden

    • durch die Verwendung von Parametern, was zu kleineren Ergebnismengen aus den Datenbanken führt

    • durch die Verwendung der Materialize- Funktion, die automatisch eine Caching-Tabelle der Abfrageergebnisse in der Datenbank verwaltet

  • Verschachtelte Datenabfragen sind möglich

  • Versionen von Abfragen können veröffentlicht und zurückgesetzt werden

  • Direktes Springen zu Dashboards, die eine Datenabfrage verwenden, und von einem Dashboard zurück zur Datenabfrage

Dieser Abschnitt ist nur für Benutzer mit Administratorrechten verfügbar

Einige nützliche Beispiele finden Sie unter Beispiele für Datenabfragen .

Erstellen von Datenabfragen

Für die Verwendung mit Datenabfragen muss mindestens eine Datenquelle in SKOOR konfiguriert sein.

Klicken Sie auf die drei Punkte oben links auf dem Bildschirm, um eine neue Abfragegruppe hinzuzufügen, oder fügen Sie einfach eine Datenabfrage zur Standardgruppe hinzu:

bild-20240405-141259.png

Datenabfragenamen müssen systemweit eindeutig sein

Wählen Sie die Datenquelle aus dem entsprechenden Dropdown-Menü aus und geben Sie im Feld Abfrage eine SQL-Abfrage ein. Aktivieren Sie das Kontrollkästchen Von Dashboards aus zugänglich , wenn die Datenabfrage in Dashboards verwendet werden soll:

bild-20240405-142242.png

Abfragen können direkt getestet werden, indem Sie auf der rechten Seite des Editors auf die Schaltfläche Abfrage ausführen klicken. Klicken Sie auf Filter umschalten , um Filter zu aktivieren und zu verwenden, um nach bestimmten Datensätzen im Ergebnissatz zu suchen. Im Fehlerfall werden im Editor oder darüber Hinweise oder Meldungen angezeigt.

Sobald die Abfrage zur Verwendung in einem Dashboard bereit ist, kann sie veröffentlicht werden. Nicht veröffentlichte Versionen einer Abfrage wirken sich nicht auf Dashboards aus.

Veröffentlichte Versionen einer Abfrage werden in der Dropdown-Liste „Version“ markiert. Bewegen Sie den Mauszeiger über das Fragezeichen, um die zum Veröffentlichungszeitpunkt angegebene Beschreibung anzuzeigen:

Wenn das Kontrollkästchen „Materialisieren“ aktiviert ist, werden Datenbankobjekte erstellt, um den Ergebnissatz der Abfrage zu speichern, sobald die Abfrage veröffentlicht wird. Dadurch wird die Leistung beim Zugriff auf die Daten von Dashboards aus erheblich verbessert. Es ist immer eine gute Idee, Indizes der wichtigsten Datenbankattribute zu erstellen.

Einstellung

Beschreibung

Gruppe hinzufügen

Hinzufügen von Gruppen für zugehörige Abfragen

Abfrage hinzufügen

Neue Abfrage zu einer Gruppe hinzufügen

Name

Name der Datenabfrage. Dieser Name kann auch für verschachtelte Datenabfragen verwendet werden.

Datenquelle

Name der für diese Datenabfrage verwendeten Datenquelle

Zugriff über Dashboards

Wenn dieses Kontrollkästchen aktiviert ist, können Datenabfragen aus Widgets von Dashboards ausgewählt werden.

Abfrage

SQL-Sprachabfrage

Abfrageverlauf

Zuvor veröffentlichte Versionen einer Abfrage können bei Bedarf reaktiviert/veröffentlicht werden

Veröffentlichen

Stellen Sie die aktuelle Abfrage für andere Datenabfragen oder Dashboards zur Verfügung. Nicht veröffentlichte Abfragen wirken sich nicht auf die in Dashboards angezeigten Daten aus.

Abhängigkeiten

Zeigt Unterabfragen, Abfragen und Dashboards an, die die aktuelle Datenabfrage verwenden. Wenn Sie mit der Maus darüber fahren, wird eine Liste der spezifischen Elemente angezeigt.

Materialisieren

Erstellen Sie Datenbankobjekte, um die Ergebnismenge der Abfrage zwischenzuspeichern und so die Dashboard-Leistung zu verbessern.

Indizes

Wählen Sie die wichtigsten Datenbankattribute aus, für die SKOOR Indizes erstellen soll

Jetzt aktualisieren

Aktualisieren des Ergebnissatz-Cache (materialisierte Daten)

Aktualisierungslink kopieren

Kopieren Sie den Link der aktuellen materialisierten Abfrage. Ein SKOOR-Job kann erstellt werden, um Aktualisierungen über diesen Link durchzuführen.

Abfrage ausführen

Führt die SQL-Abfrage aus, speichert sie und zeigt den Ergebnissatz im Abschnitt „Datenvorschau“ an.

Filter ein-/ausblenden

Filterfelder unterhalb der Ergebnisspalten ein- oder ausschalten, um gezielt nach Datensätzen zu suchen

Löschen von Abfragen oder Gruppen

Klicken Sie auf das Zahnradsymbol einer Gruppe oder Abfrage und dann auf Löschen .

Verschieben von Abfragen zwischen Gruppen

Abfragen können per Drag & Drop zwischen Gruppen verschoben werden.

Doppelte Abfragen

Abfragen können einfach kopiert werden, indem Sie im Kontextmenü auf „Duplizieren“ klicken.

bild-20240405-142931.png

Verschachtelte Abfragen

Daten aus anderen Datenabfragen können abgefragt oder mit anderen Datenbanktabellen oder Ansichten verbunden werden. Die Version der zugrunde liegenden Datenabfragen wird an die aktuelle Ansichten festgehalten, sodass Änderungen nicht zu unerwartetem Verhalten führen. Zum Zeitpunkt der neuen Version einer Datenabfrage wird auch zu den neuesten Versionen erstellt.

Die folgende Datenabfrage wählt eine Teilmenge der Datenabfrage get_sales_data aus:

Die Abhängigkeit zwischen den Datenabfragen get_sales_data und get_tech_sales ist oben rechts auf beiden Datenabfragebildschirmen sichtbar:

get_tech_sales-Abfrage:

get_sales_data-Abfrage:

Überprüfen Sie immer die Abhängigkeiten, bevor Sie Abfragen ändern und veröffentlichen.

Export und Import

Datenabfragegruppen können aus jedem SKOOR-System exportiert und in dieses importiert werden. Dies ermöglicht den Austausch von Abfragen beispielsweise zwischen Test- und Produktionssystemen.

bild-20240405-143625.png

Exportdialog:

bild-20240405-143318.png

Um den Export abzuschließen, kopieren Sie die Exportzeichenfolge oder laden Sie sie im JSON-Format herunter. Aktivieren Sie das Kontrollkästchen Plain JSON, um die Exportzeichenfolge als JSON zu lesen.

Auf dem Zielsystem müssen die in den Datenabfragen konfigurierten Datenquellen vorhanden sein

Datenabfragen werden durch importierte Abfragen mit demselben Namen aktualisiert, unabhängig davon, zu welcher Gruppe sie gehören

Die Versionsnummern der Abfragen auf den Quell- und Zielsystemen müssen nicht unbedingt übereinstimmen, sie werden unabhängig voneinander erhöht.

Veröffentlichte Abfragen

Standardmäßig wird die zuletzt veröffentlichte Version jeder Datenabfrage einer Gruppe exportiert.

Auf dem Zielsystem wird beim Importieren Folgendes durchgeführt:

  • Wenn die neueste Version einer Abfrage unveröffentlicht ist oder eine andere veröffentlichte Version ist, wird die importierte Abfrage mit demselben Namen als unveröffentlichte Nebenversion hinzugefügt.

  • Wenn die zuletzt veröffentlichte Version mit der importierten übereinstimmt, wird eine neue veröffentlichte Version der Abfrage hinzugefügt.

Nicht veröffentlichte Abfragen

Um die neuesten unveröffentlichten Änderungen zu exportieren, exportieren Sie die erforderliche Gruppe mit aktivierter Option „Unveröffentlichte Versionen einschließen“ .

Von jeder importierten Abfrage wird eine neue, unveröffentlichte Nebenversion auf dem Zielsystem erstellt.

Importieren

Klicken Sie mit der rechten Maustaste auf eine Gruppe im Zielsystem und klicken Sie importieren . Fügen Sie die exportierte Zeichenfolge in das jeweilige Feld des Importdialogfelds ein. Nach einer Validierung werden die Importaktionen auf dem Bildschirm beschrieben:

Wenn die Aktionen in Ordnung sind, klicken Sie auf Datenabfragen importieren .