SKOOR Dokumentation

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

Grundlagen von Datenabfragen

Mit Datenabfragen können Daten aus externen Datenbanken für die Verwendung in Dashboards vorbereitet werden.

Datenabfragen bieten folgende Vorteile:

Entwicklung und Testen von SQL-Abfragen direkt im Admin-Bereich des SKOOR Dashboard
Die Leistung des Dashboards kann
- 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 pflegt
Verschachtelte Datenabfragen sind möglich
Versionen von Abfragen können veröffentlicht werden, ältere veröffentlichte Versionen können wiederverwendet werden.
Springen Sie direkt zu Dashboards, die eine Datenabfrage verwenden, und von diesen Dashboards zurück zur Datenabfrage

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

Wenn Sie daran interessiert sind, Datenabfragen mit Filter Matrix zu verwenden, finden Sie weitere Informationen unter: Filter Matrix & Datenabfragen

Datenabfragen erstellen

Für die Verwendung von 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:

Die Namen von Datenabfragen müssen systemweit eindeutig sein.

Das Fenster „Datenabfrage erstellen” wird angezeigt, in dem der Name der Datenabfrage und die verwendete Datenquelle festgelegt werden müssen.

Nach dem Klicken auf „Erstellen“ wird die Datenabfrage angezeigt.

Geben Sie eine SQL-Abfrage in das Feld „Abfrage“ ein. Aktivieren Sie das Kontrollkästchen „Über Dashboards zugänglich“, wenn die Datenabfrage in Dashboards verwendet werden soll:

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

Nun kann die neue Abfrage veröffentlicht werden.

Datenabfragen veröffentlichen

Abfragen können durch Klicken auf die Schaltfläche „Veröffentlichen“ veröffentlicht werden, wie unten gezeigt. Unveröffentlichte Versionen einer Abfrage haben keine Auswirkungen auf Dashboards.

Veröffentlichte Versionen einer Abfrage sind im Dropdown-Menü „Version“ gekennzeichnet. Bewegen Sie den Mauszeiger über das Fragezeichen, um die zum Zeitpunkt der Veröffentlichung angegebene Veröffentlichungsnotiz anzuzeigen:

Durch das erfolgreiche Veröffentlichen einer Datenabfrage werden automatisch alle unveröffentlichten Versionen dieser Abfrage bis zum Zeitpunkt der Veröffentlichung gelöscht.

Zuvor veröffentlichte Versionen sind davon nicht betroffen.

Datenabfragen materialisieren

Wenn das Kontrollkästchen „Materialisieren“ aktiviert ist, werden Datenbankobjekte erstellt, um das Ergebnis der Abfrage zu speichern, sobald die Abfrage veröffentlicht wird. Dies erhöht die Leistung beim Zugriff auf die Daten aus Dashboards erheblich. Es ist immer empfehlenswert, Indizes der wichtigsten Datenbankattribute zu erstellen.

Datenabfragen löschen

Klicken Sie auf die drei Punkte einer Gruppe oder Abfrage und dann auf „Löschen“.

Datenabfragen verschieben

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

Datenabfragen duplizieren

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

Datenabfragen umbenennen

Wenn eine Datenabfrage geöffnet ist, kann ihr Name einfach geändert werden, indem der neue Name in das Feld „Name“ eingegeben wird.

Dadurch wird eine neue Version der Datenabfrage erstellt, die veröffentlicht werden muss, damit der neue Name in den Dashboards angezeigt wird.

Wenn Sie eine Datenabfrage umbenennen, die in anderen Datenabfragen verschachtelt ist, wird die Namensänderung auf alle abhängigen Abfragen übertragen. Diese Übertragung führt zu neuen Versionen dieser abhängigen Abfragen, die dann zur Veröffentlichung bereit sind.

Liste der Einstellungen in der Datenabfrage

Einstellung	Beschreibung
Gruppe erstellen	Gruppen für zugehörige Abfragen hinzufügen
Datenabfrage 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
Zugänglich über Dashboards	Datenabfragen können aus Widgets von Dashboards ausgewählt werden, wenn dieses Kontrollkästchen aktiviert ist
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 anderen Datenabfragen oder Dashboards zur Verfügung. Nicht veröffentlichte Abfragen haben keinen Einfluss auf die in Dashboards angezeigten Daten
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, die Sie durch Anklicken zum entsprechenden Dashboard führen.
Materialisieren	Erstellen Sie Datenbankobjekte, um das Ergebnis der Abfrage zwischenzuspeichern und so die Leistung des Dashboards zu verbessern.
Indizes	Wählen Sie wichtige Datenbankattribute aus, für die SKOOR Indizes erstellen soll.
Jetzt aktualisieren	Aktualisieren Sie den Ergebnis-Cache (materialisierte Daten).
Aktualisierungslink kopieren	Kopieren Sie den Link der aktuellen materialisierten Abfrage. Mit diesem Link kann ein SKOOR-Job erstellt werden, um Aktualisierungen durchzuführen
Abfrage ausführen	Führt die SQL-Abfrage aus, speichert sie und zeigt das Ergebnis im Abschnitt „Datenvorschau“ an
Filter umschalten	Aktivieren oder deaktivieren Sie die Filterfelder unterhalb der Spalten des Ergebnissatzes, um nach bestimmten Datensätzen zu suchen.

Verschachtelte Abfragen

Daten aus anderen Datenabfragen können auf die gleiche Weise wie andere Datenbanktabellen oder -ansichten abgefragt oder verknüpft werden. Die Version der zugrunde liegenden Datenabfragen wird an die aktuelle Version angeheftet, sodass Änderungen nicht zu unerwartetem Verhalten führen. Wenn eine neue Version einer Datenabfrage erstellt wird, werden auch die zugrunde liegenden Abfragen auf ihre neuesten Versionen gesetzt.

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:

Abfrage „get_tech_sales“:

Abfrage „get_sales_data“:

Überprüfen Sie vor dem Ändern und Veröffentlichen von Abfragen immer die Abhängigkeiten.

Exportieren und Importieren

Export

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

Exportdialog:

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.

Beim Exportieren/Importieren von Datenabfragen ist Folgendes zu beachten

Auf dem Zielsystem müssen die in den Datenabfragen konfigurierten Datenquellen vorhanden sein.
Datenbereiche und Schreibberechtigungen der verwendeten Datenquelle werden mit der Datenabfrage exportiert/importiert. Damit der Import erfolgreich durchgeführt werden kann, sollten alle in den Einstellungen verwendeten Benutzer/Benutzergruppen im Zielsystem verfügbar sein. (Diese Option kann beim Import deaktiviert werden.)
Datenabfragen werden durch importierte Abfragen mit demselben Namen aktualisiert, unabhängig davon, zu welcher Gruppe sie gehören.
Die Versionsnummern der Abfragen auf dem Quell- und Zielsystem stimmen nicht unbedingt überein, 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 es sich um eine andere veröffentlichte Version handelt, wird die importierte Abfrage mit demselben Namen als unveröffentlichte Minor-Version hinzugefügt.
Wenn die neueste veröffentlichte Version mit der importierten Version ü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 gewünschte Gruppe mit aktivierter Option „Unveröffentlichte Versionen einschließen”.

Auf dem Zielsystem wird eine neue unveröffentlichte Minor-Version jeder importierten Abfrage erstellt.

Import

Wählen Sie „Datenabfragen importieren“ aus dem Kontextmenü von „Datenabfragen“ oder einer bestimmten Datenabfragegruppe.

Fügen Sie die exportierte Zeichenfolge in das entsprechende Feld des Importdialogs ein. Nach der Validierung werden die Importaktionen auf dem Bildschirm beschrieben:

Das Flag „Berechtigungen und Datenbereiche der Datenquelle“ wird verwendet, um optional die Berechtigungen und Datenbereiche zu importieren.

Wenn die Aktionen OK sind, klicken Sie auf „Datenabfragen importieren“.