Datenabfragen
Dieser Abschnitt ist nur für Benutzer mit Administratorrechten verfügbar
Grundlagen zu Data Queries
Mit Data Queries können Daten aus externen Datenbanken für die Verwendung in Dashboards aufbereitet werden.
Data Queries bieten folgende Vorteile:
Entwicklung und Testen von SQL-Abfragen direkt im Admin-Bereich des SKOOR Dashboard
Die Dashboard-Performance kann gesteigert werden
durch die Verwendung von Parametern, was zu kleineren Ergebnismengen aus den Datenbanken führt
durch die Verwendung der Funktion Materialize, die automatisch eine Caching-Tabelle des Abfrageergebnisses in der Datenbank pflegt
Verschachtelte Data Queries sind möglich
Versionen von Abfragen können veröffentlicht und ältere veröffentlichte Versionen wiederverwendet werden.
Direktes Springen zu Dashboards, die eine Data Query verwenden, und von diesen Dashboards zurück zur Data Query
Siehe Beispiele für Data Queries für einige nützliche Beispiele.
Wenn Sie Data Queries zusammen mit der Filter Matrix verwenden möchten, finden Sie weitere Details unter: Filter Matrix & Data Queries
Data Queries erstellen
In SKOOR muss mindestens eine Datenquelle für die Verwendung mit Data Queries 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 Data Query zur Standardgruppe hinzu:
Namen von Data Queries müssen systemweit eindeutig sein
Der Dialog Create Data Query wird angezeigt, in dem der Name der Data Query und die verwendete Datenquelle festgelegt werden müssen.
Nach einem Klick auf Create wird die Data Query angezeigt.
Geben Sie eine SQL-Abfrage in das Feld Query ein. Aktivieren Sie das Kontrollkästchen Accessible from dashboards, wenn die Data Query in Dashboards verwendet werden soll:
Abfragen können direkt getestet werden, indem Sie auf die Schaltfläche Run query auf der rechten Seite des Editors klicken. Klicken Sie auf Toggle filters, um Filter zu aktivieren und in der Ergebnismenge nach bestimmten Datensätzen zu suchen. Bei Fehlern werden Hinweise oder Meldungen im Editor oder darüber angezeigt.
Nun kann die neue Abfrage veröffentlicht werden.
Data Queries veröffentlichen
Abfragen können durch Klicken auf die Schaltfläche Publish veröffentlicht werden, wie unten dargestellt. Unveröffentlichte Versionen einer Abfrage wirken sich nicht auf Dashboards aus.
Veröffentlichte Versionen einer Abfrage sind im Versions-Dropdown-Menü markiert. Bewegen Sie den Mauszeiger über das Fragezeichen, um die bei der Veröffentlichung angegebene Publish note anzuzeigen:
Durch die erfolgreiche Veröffentlichung einer Data Query werden automatisch alle unveröffentlichten Versionen dieser Abfrage bis zum Zeitpunkt der Veröffentlichung gelöscht.
Zuvor veröffentlichte Versionen sind davon nicht betroffen.
Data Queries materialisieren
Wenn das Kontrollkästchen Materialize aktiviert ist, werden Datenbankobjekte erstellt, um die Ergebnismenge der Abfrage zu speichern, sobald die Abfrage veröffentlicht wird. Dies erhöht die Performance beim Zugriff auf die Daten aus Dashboards erheblich. Das Erstellen von Indizes für die wichtigsten Datenbankattribute ist immer empfehlenswert.
Data Queries löschen
Klicken Sie auf die drei Punkte einer Gruppe oder Abfrage und wählen Sie Delete.
Data Queries verschieben
Abfragen können per Drag & Drop zwischen Gruppen verschoben werden.
Data Queries duplizieren
Abfragen können einfach kopiert werden, indem Sie im Kontextmenü auf Duplicate klicken.
Data Queries umbenennen
Wenn eine Data Query geöffnet ist, kann ihr Name einfach angepasst werden, indem Sie den neuen Namen in das Feld Name eingeben.
Dadurch wird eine neue Version der Data Query erstellt, die veröffentlicht werden muss, damit der neue Name in den Dashboards angezeigt wird.
Wenn Sie eine Data Query umbenennen, die in anderen Data Queries verschachtelt ist, wird die Namensänderung an alle abhängigen Abfragen weitergegeben. Diese Weitergabe führt zu neuen Versionen dieser abhängigen Abfragen, sodass diese zur Veröffentlichung bereitstehen.
Liste der Einstellungen in Data Query
Einstellung | Beschreibung |
|---|---|
Create Group | Gruppen für zugehörige Abfragen hinzufügen |
Add data query | Neue Abfrage zu einer Gruppe hinzufügen |
Name | Name der Data Query. Dieser Name kann auch für verschachtelte Data Queries verwendet werden |
Data source | Name der Datenquelle, die für diese Data Query verwendet wird |
Accessible from dashboards | Wenn dieses Kontrollkästchen aktiviert ist, können Data Queries in Widgets von Dashboards ausgewählt werden |
Query | SQL-Abfrage |
Query history | Zuvor veröffentlichte Versionen einer Abfrage können bei Bedarf reaktiviert/veröffentlicht werden |
Publish | Stellt die aktuelle Abfrage anderen Data Queries oder Dashboards zur Verfügung. Unveröffentlichte Abfragen wirken sich nicht auf die in Dashboards angezeigten Daten aus |
Dependencies | Zeigt Unterabfragen, Abfragen und Dashboards an, welche die aktuelle Data Query verwenden. Wenn Sie den Mauszeiger darüber bewegen, wird eine Liste der jeweiligen Elemente angezeigt; ein Klick darauf springt zum entsprechenden Dashboard. |
Materialize | Erstellt Datenbankobjekte zum Zwischenspeichern der Ergebnismenge der Abfrage, um die Dashboard-Performance zu steigern |
Indices | Wählen Sie die wichtigsten Datenbankattribute aus, für die SKOOR Indizes erstellen soll |
Refresh now | Aktualisiert den Cache der Ergebnismenge (materialisierte Daten) |
Copy refresh link | Kopiert den Link der aktuellen materialisierten Abfrage. Mithilfe dieses Links kann ein SKOOR-Job erstellt werden, um Aktualisierungen durchzuführen |
Run query | Führt die SQL-Abfrage aus, speichert sie und zeigt die Ergebnismenge im Bereich Data Preview an |
Toggle filters | Schaltet Filterfelder unter den Spalten der Ergebnismenge ein oder aus, um nach bestimmten Datensätzen zu suchen |
Verschachtelte Abfragen
Daten aus anderen Data Queries können auf die gleiche Weise abgefragt oder verknüpft (Join) werden wie andere Datenbanktabellen oder Views. Die Version der zugrunde liegenden Data Queries wird auf die aktuelle Version fixiert, sodass Änderungen nicht zu unerwartetem Verhalten führen. Sobald eine neue Version einer Data Query erstellt wird, werden auch die zugrunde liegenden Abfragen auf ihre jeweils neuesten Versionen gesetzt.
Die folgende Data Query wählt eine Teilmenge der Data Query get_sales_data aus:
Die Abhängigkeit zwischen den Data Queries get_sales_data und get_tech_sales ist oben rechts in beiden Data-Query-Ansichten sichtbar:
Abfrage get_tech_sales:
Abfrage get_sales_data:
Stellen Sie sicher, dass Sie vor dem Ändern und Veröffentlichen von Abfragen immer die Abhängigkeiten prüfen
Export und Import
Export
Data-Query-Gruppen 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 Produktivsystemen.
Export-Dialog:
Um den Export abzuschließen, kopieren Sie den Export-String oder laden Sie ihn im JSON-Format herunter. Aktivieren Sie das Kontrollkästchen Plain JSON, um den Export-String als JSON zu lesen.
Beim Exportieren/Importieren von Data Queries muss Folgendes beachtet werden
Auf dem Zielsystem müssen die in den Data Queries konfigurierten Datenquellen vorhanden sein.
Data Scopes und Schreibberechtigungen der verwendeten Datenquelle werden zusammen mit der Data Query exportiert bzw. importiert. Damit dies erfolgreich importiert werden kann, müssen alle in den Einstellungen verwendeten Benutzer/Benutzergruppen auf dem Zielsystem verfügbar sein. (Diese Option kann beim Importieren deaktiviert werden.)
Data Queries werden durch importierte Abfragen mit demselben Namen aktualisiert, unabhängig davon, zu welcher Gruppe sie gehören
Versionsnummern von Abfragen auf dem Quell- und Zielsystem stimmen nicht unbedingt überein, da sie unabhängig voneinander erhöht werden
Veröffentlichte Abfragen
Standardmäßig wird die zuletzt veröffentlichte Version jeder Data Query einer Gruppe exportiert.
Auf dem Zielsystem wird beim Importieren Folgendes ausgeführt:
Wenn die neueste Version einer Abfrage unveröffentlicht oder eine andere veröffentlichte Version ist, wird die importierte Abfrage mit demselben Namen als unveröffentlichte Minor-Version hinzugefügt
Wenn die neueste veröffentlichte Version mit der importierten Version identisch ist, wird eine neue veröffentlichte Version der Abfrage hinzugefügt.
Unveröffentlichte Abfragen
Um die neuesten unveröffentlichten Änderungen zu exportieren, exportieren Sie die gewünschte Gruppe, während Include unpublished versions aktiviert ist.
Auf dem Zielsystem wird für jede importierte Abfrage eine neue unveröffentlichte Minor-Version erstellt.
Import
Wählen Sie import data queries aus dem Kontextmenü von Data Queries oder einer bestimmten Data-Query-Gruppe.
Fügen Sie den exportierten String in das entsprechende Feld des Import-Dialogs ein. Nach der Validierung werden die Importaktionen auf dem Bildschirm beschrieben:
Die Option DataSource’s Permissions and Data scopes wird verwendet, um optional die Berechtigungen und Data Scopes zu importieren.
Wenn die Aktionen OK sind, klicken Sie auf Import Data Queries.















