Metadaten-Abfrage
Die Benutzeroberfläche ermöglicht das Abfragen von Metadaten mit kundenspezifischen, ausschließlich lesenden SQL-Anweisungen auf die Metadata SQL Views. Die Ergebnisse der Abfragen können in der Benutzeroberfläche angezeigt bzw. in unterschiedlichen Formaten heruntergeladen werden.
Nur Benutzer mit der Zugriffsstufe Administrator sind berechtigt, die Metadaten-Abfrage zu öffnen.
Für den Betrieb der Metadaten-Abfrage muss ein entsprechender Benutzer konfiguriert sein (siehe Server-Parameter DATASPOT_POSTGRES_READONLY_USER), welcher lesende Berechtigungen für alle Metadata SQL Views hat.
Alle SQL-Anweisungen der Metadaten-Abfrage werden ausschließlich mit diesem Benutzer durchgeführt.
Funktionsweise
Die Metadaten-Abfrage in der Benutzeroberfläche hat die gleiche Funktionsweise und Semantik wie das Metadata Query-API. Die Metadaten-Abfrage führt eine kundenspezifische SQL-Anweisung auf die Metadata SQL Views durch.
Die kundenspezifische SQL-Anweisung kann nur auf Tabellen zugreifen, für die der konfigurierte Benutzer berechtigt ist.
Die SQL-Abfrage richtet sich nach dem Metamodell, welches alle Eigenschaften und Beziehungen der Metadatenobjekte dokumentiert. Das Ergebnis der Abfrage kann in unterschiedlichen Formaten heruntergeladen werden.
Es ist nicht möglich, schreibende SQL-Anweisungen auszuführen. Die Transaktion in PostgreSQL wird als ausschließlich lesende Transaktion gestartet und zusätzlich mehrfach gegen schreibende SQL-Anweisungen abgesichert.
Formate
Beim Herunterladen der abgefragten Metadaten werden folgende Formate unterstützt:
| Format | Dateierweiterung | Beschreibung |
|---|---|---|
CSV | .csv | CSV (Comma-separated values) |
JSON | .json | JSON (JavaScript Object Notation) |
XML | .xml | XML (Extensible Markup Language) |
Die Properties richten sich nach der jeweiligen, kundenspezifischen SQL-Anweisung.
Aufruf
Die Metadaten-Abfrage kann in der Seitenleiste geöffnet werden.
Das Datenbankschema zeigt alle Tabellen (inkl. Spalten und Datentypen) an, für die der konfigurierte Benutzer berechtigt ist.
Alle Tabellen und Spalten im Datenbankschema dataspot sind dokumentiert.
Die Beschreibungen werden als Tooltipps über den Tabellen bzw. Spalten automatisch angezeigt.
Die SQL-Anweisung kann im Eingabefeld eingegeben werden. Durch Klick auf "Abfragen" wird die SQL-Anweisung ausgeführt.
Die Tastenkombination STRG+Enter im Eingabefeld führt die SQL-Anweisung ebenfalls durch.
Die SQL-Anweisung darf nur eine einzige, ausschließlich lesende SQL-Abfrage enthalten.
Kommentare mit -- bzw. /* und */ sind zulässig.
Die abgefragten Metadaten werden seitenweise in einer Tabelle angezeigt.
Es ist möglich, mehrere Abfragen gleichzeitig zu bearbeiten. Für jede Abfrage kann ein eigener Reiter geöffnet werden.
Herunterladen
Durch Klick auf das Download-Symbol wird der Download-Dialog geöffnet.
Das Format muss verpflichtend angegeben werden.
- Durch Klick auf "Herunterladen" wird ein Job gestartet, der die SQL-Anweisung ausführt und die abgefragten Metadaten bereitstellt. Während die Abfrage läuft, wird der Fortschritt angezeigt.
- Durch Klick auf "Stoppen" wird die laufende Abfrage gestoppt.
Durch Klick auf "Schließen" kann der Dialog geschlossen werden, ohne die laufende Abfrage zu stoppen. Der Benutzer kann die Applikation weiter benutzen, während die Abfrage im Hintergrund läuft. Das bereitgestellte Ergebnis kann gegebenenfalls später im Dashboard abrufen werden, wo die Abfrage auch gestoppt oder nachträglich erneut gestartet werden kann.
Sobald die Abfrage fertig ist, werden die Statistik und das Protokoll angezeigt.
- Durch Klick auf "Öffnen" werden die abgefragten Metadaten geöffnet und angezeigt.
- Durch Klick auf "Speichern" können die abgefragten Metadaten als Datei gespeichert werden.
Treten bei der Abfrage Fehler auf, wird eine entsprechende Fehlermeldung ausgegeben. Die genaue Fehlerursache kann dem Protokoll entnommen werden.
