Einführung in Datenquellen

Datenquellen können so konfiguriert werden, dass Datenbanktabellen oder Ansichten in den SKOOR Dashboards verfügbar sind.

Mit SKOOR Version 7.2 wurden neue Funktionen zum Erstellen und Bearbeiten von Tabellen sowie Tabellendaten hinzugefügt.

MySQL- und PostgreSQL-Datenbanken werden unterstützt.

Datenquelle erstellen

Nur Administratoren können Datenquellen erstellen.

Klicken Sie auf das Pluszeichen (+) und fügen Sie unter der Registerkarte „Allgemein” die Verbindungsparameter hinzu:

Klicken Sie unterhalb der Verbindungsparameter auf die Schaltfläche „Speichern“, um eine Verbindung zur Datenbank herzustellen. Wenn die Datenbank erreichbar ist, wird ein grünes Status-Symbol zusammen mit einigen Registerkarten für weitere Aktionen zu dieser Datenbank angezeigt:

Auf der Registerkarte „Allgemein“ können Sie den Namen der Datenquelle, die Verbindungsparameter und die Timeout-Einstellungen aktualisieren. Klicken Sie auf „Speichern“, um diese Änderungen zu speichern.

Datenbereiche und Schreibberechtigungen definieren

Nur Administratoren können Datenbereiche und Schreibberechtigungen definieren

Auf der Registerkarte „Berechtigungen“ kann der Zugriff von Benutzern oder Benutzergruppen auf die Datenquelle konfiguriert werden.

Administratoren dürfen alle Daten aus allen Tabellen lesen und ändern

Datenbereiche

In diesem Abschnitt können Bereiche für jeden Benutzer oder jede Benutzergruppe definiert werden. Nur Daten, die dem Bereich entsprechen, sind für den jeweiligen Benutzer oder die jeweilige Benutzergruppe sichtbar. Dies gilt sowohl für die Datenvorschau im Datenquellenbereich als auch für die Dashboards.

Ausdrücke zur Bereichsunterscheidung können einfache Zeichenfolgenwerte oder Operatoren sein, die auf der Seite „Datenquellenabfrage-Editor“ beschrieben sind.

Beispielausdrücke:

Ausdruck	Beschreibung
1234	Entspricht allen Zeilen, deren Spaltenwert 1234 ist.
NOT(NULL())	Entspricht allen Zeilen mit einem Spaltenwert ungleich NULL.
GE(0)	Entspricht allen Zeilen, deren Spaltenwert größer oder gleich Null ist.
foo%	Entspricht allen Zeilen mit einem Spaltenwert, der mit „foo” beginnt.

Schreibberechtigungen

Im Allgemeinen gelten für die SKOOR-Benutzerrollen die folgenden Regeln:

Benutzer mit der Rolle „Editor” können alle Daten aus allen Tabellen lesen.
Benutzer mit der Operator-Rolle können überhaupt keine Daten sehen

Schreibberechtigungen definieren

Benutzern mit der Rolle „Editor” das Bearbeiten von Daten in ausgewählten Tabellen zu ermöglichen
Benutzer mit der Operator-Rolle Daten in ausgewählten Tabellen lesen und bearbeiten zu lassen

Vorschau einer Datenquelle

Auf der Registerkarte „Daten“ sind alle Tabellen, Ansichten usw. der ausgewählten Datenquelle sichtbar. Benutzer mit der Rolle „Operator“ sehen nur die Tabellen, die durch die Schreibberechtigungen definiert sind.

Wählen Sie ein Element aus den Gruppen auf der linken Seite (z. B. „Tabellen“) aus, um dessen Daten anzuzeigen. Klicken Sie auf einen Spaltennamen, um die Spalte zu sortieren, oder verwenden Sie die Schaltfläche „Filter umschalten“ auf der rechten Seite, um nach bestimmten Datensätzen zu suchen.

Datenquelle bearbeiten

Erstellen/Importieren einer Tabelle

Nur Administratoren können neue Tabellen erstellen.

Neue Tabellen können manuell oder zusammen mit einem Datenimport erstellt werden.

Klicken Sie auf das Symbol „+“ neben der Gruppe „Tabellen“, um das Dialogfeld „Tabelle hinzufügen“ zu öffnen:

Um eine Tabelle manuell zu definieren, klicken Sie auf die entsprechende Schaltfläche „Hinzufügen“, um Spalten und Indizes hinzuzufügen und Namen, Datentypen usw. zu definieren.

Weitere Informationen finden Sie im nächsten Abschnitt, Schema bearbeiten

Um eine Tabelle mit einem Datenimport hinzuzufügen, schalten Sie das Optionsfeld „Spalten“ auf „Importieren“ um:

Klicken Sie auf „Aus Datei importieren“ und öffnen Sie die gewünschte Excel- (XLSX) oder CSV-Datei. Die SKOOR-Software wertet nun die Spalten und Datentypen aus:

Um sicherzustellen, dass dieselbe Datei bei einem zukünftigen Datenladen erneut importiert werden kann, dürfen die Spaltennamen nicht geändert werden. Legen Sie einen Tabellennamen (standardmäßig übernimmt die Software den Dateinamen) sowie Primärschlüssel, Indizes, Datentyp usw. fest und klicken Sie auf „Erstellen und importieren“, um die eigentliche Tabellenerstellung und den Datenimport zu starten.

Eine vorhandene Tabelle bearbeiten

Die Bearbeitung ist nur autorisierten Benutzern gestattet. Weitere Informationen finden Sie unter Datenbereiche und Schreibberechtigungen.

Schema bearbeiten

Nur Administratoren können das Schema einer Tabelle bearbeiten.

Klicken Sie auf das Optionssymbol eines Tabellenelements, um dessen Schema zu bearbeiten:

Verwenden Sie das Dialogfeld „Tabelle bearbeiten“, um den Tabellennamen, den Primärschlüssel, die Indizes oder die Spalten in der Datenbank tatsächlich zu ändern:

Einstellung	Beschreibung
Tabellenname	Der Name der Tabelle
Primärschlüssel	Definieren Sie einen Primärschlüssel aus einer oder mehreren Spalten
Indizes	Definieren Sie ein- oder mehrspaltige Indizes für die aktuelle Tabelle
Spalten	Definieren Sie Spaltennamen, Datentyp und Standardwert. Aktivieren oder deaktivieren Sie die automatische Erhöhung und ob eine Spalte nullfähig ist

Daten bearbeiten

Tabellendaten können bearbeitet werden, während Ansichten, materialisierte Ansichten usw. schreibgeschützt sind.

Klicken Sie einfach in eine Spalte eines bestimmten Datensatzes, um dessen Daten zu bearbeiten, oder löschen Sie einen Datensatz über das entsprechende Papierkorb-Symbol. Es können mehrere Änderungen gleichzeitig vorgenommen werden, die durch eine Farbänderung und eine Rückgängig-Option auf der linken Seite gekennzeichnet werden.

Textfelder und Textbereiche bieten zusätzlich die Möglichkeit, ihren Wert auf NULL zu setzen. Klicken Sie dazu auf das X-Symbol, das erscheint, wenn Sie mit der Maus über ein solches Feld fahren.

Klicken Sie auf „Änderungen speichern“, um die Daten zu übernehmen.

Tabelle löschen

Klicken Sie auf das Optionssymbol eines Tabellenelements und wählen Sie „Löschen“, um es zu löschen.

Exportieren/Importieren in Datenquellen

Daten exportieren

Daten können durch Klicken auf die Schaltfläche „Exportieren“ in eine CSV-Datei exportiert werden. Die resultierende Datei enthält nur die in der Vorschau angezeigten Daten, d. h., die definierten Bereiche werden angewendet.

Die Daten werden in UTF-8-Kodierung exportiert.

Daten importieren

Die Dateigröße ist auf 100 MB für CSV-Dateien und 2 MB für XLSX-Dateien begrenzt.

Tabellen können direkt während des Imports von Daten erstellt werden. Weitere Informationen finden Sie im Abschnitt „Tabelle erstellen/importieren“.

Excel-Dateien (nur XLSX-Format) und kommagetrennte Dateien (CSV) können importiert werden, um eine Tabelle zu ersetzen oder zu aktualisieren. Klicken Sie auf die Schaltfläche „Importieren“, um das Dialogfeld zu öffnen:

Klicken Sie zunächst auf „Aus Datei importieren“, um eine Datei zu öffnen. Wählen Sie anschließend einen der folgenden Importmodi aus:

INSERT: Fügen Sie alle Datensätze aus der Datei ein. Duplikate werden eingefügt, wenn die Tabellendefinition dies zulässt.
UPSERT: Fügt alle Datensätze aus der Datei ein. Wenn ein Datensatz bereits vorhanden ist, wird er aktualisiert. In diesem Fall muss ein Primärschlüssel für die Tabelle definiert sein.
ERSETZEN: Vor dem Laden der Daten aus der Datei werden vorhandene Daten gelöscht.

Erstellen einer Skript-Datenquelle (veraltet)

Skript-Datenquellen sind veraltet und sollten nicht mehr verwendet werden.

Wenn der Datentyp auf SCRIPT geändert wird, ändern sich die Konfigurationsparameter. Jetzt kann ein Skript zusammen mit allen Parametern konfiguriert werden, die zur Erzeugung einer für SKOOR Dashboard geeignete Ausgabe erforderlich sind.

Die Skriptausgabe muss im JSON-Format vorliegen.

Parameter	Beschreibung
Name	Name der Datenquelle. Dieser Name ist in den Widget-Einstellungen verfügbar, wenn der Suchtyp auf „dataSource“ gesetzt ist. Die Tabelle wird immer auf „STDOUT“ gesetzt:
Ausführbare Datei abrufen	Vollständiger Pfad zu dem Programm oder Skript, das die Daten generiert. Dieses Programm muss auf dem System verfügbar sein, auf dem der SKOOR-Webdienst installiert ist.
Argumente abrufen	Befehlszeilenargumente des Programms, ein Argument pro Zeile. Alle im Ziel-Widget festgelegten Parameter können ebenso wie direkt in diesem Feld festgelegte Argumente an das Skript übergeben werden. Beispiel: Der URL-Parameter „display“ ist als Suchabfrage in einem Tabellen-Widget konfiguriert: Der gleiche Parameter kann nun an das Datenquellenskript sowie an andere Argumente übergeben werden, beispielsweise den Wert „123“:
Ergebniszeiger abrufen	Wenn in den Dashboards nur ein Teil des JSON-String-Ergebnisses des Programms benötigt wird, muss ein JSON-Zeiger gesetzt werden. Die folgende Beispiel-JSON-Zeichenfolge wird von einem Programm generiert (zur besseren Lesbarkeit formatiert): { "host": "myhost", "filesystems": [ { "size": "51G", "used": "22G", "available": "27G", "usedp": "46%", "mountpoint": "/" }, { "size": "17G", "used": "45M", "available": "16G", "usedp": "1%", "mountpoint": "/home" } ] } Nur das Dateisystem-Array wird in einem Dashboard angezeigt. Daher muss der JSON-Zeiger /filesystems als Fetch-Ergebniszeiger festgelegt werden: Wenn alle Objekte einer JSON-Zeichenfolge angezeigt werden sollen, setzen Sie den Fetch-Ergebniszeiger auf „/“.
Eindeutige ausführbare Datei	Wenn eine Skript-Datenquelle für ein Filtermatrix-Widget verwendet wird, ist ein JSON-Array mit eindeutigen Werten erforderlich. Das hier konfigurierte Skript oder Programm muss ein solches Array zurückgeben.
Eindeutige Argumente	Siehe Fetch-Argumente
Eindeutiger Ergebniszeiger	Siehe Ergebniszeiger abrufen
Spalten	Die JSON-Felder der Skriptausgabe müssen als Spalten konfiguriert werden, damit sie als solche in den Dashboard-Widgets verfügbar sind.

Dokumentation

Daten-Quellen