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. Darüber hinaus können Skripte als Datenquellen definiert werden, um Daten aus fast jeder anderen Quelle anzufordern.

Erstellen einer PostgreSQL- oder MySQL-Datenquelle

Nur Administratorbenutzer können Datenquellen erstellen

Klicken Sie auf das +-Zeichen und fügen Sie Verbindungsparameter hinzu:

Klicken Sie auf die Schaltfläche Speichern unter den Verbindungsparametern, um eine Verbindung zur Datenbank herzustellen. Wenn die Datenbank erreichbar ist, wird ein grünes Statussymbol zusammen mit einigen Registerkarten für weitere Aktionen mit dieser Datenbank angezeigt:

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.

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

Datenbereiche

In diesem Abschnitt können Sie Bereiche für jeden Benutzer oder jede Benutzergruppe definieren. Nur Daten, die dem Bereich entsprechen, sind für den jeweiligen Benutzer oder die Benutzergruppe sichtbar. Dies gilt sowohl für die Datenvorschau im Abschnitt „Datenquelle“ als auch für die Dashboards.

Bereichsdiskriminatorausdrücke können einfache Zeichenfolgenwerte oder Operatoren sein, die auf der Seite des Datenquellenabfrage-Editors beschrieben sind.

Beispielausdrücke:

Ausdruck	Beschreibung
1234	Stimmt mit allen Zeilen überein, deren Spaltenwert gleich 1234 ist.
NICHT NULL())	Stimmt mit allen Zeilen überein, deren Spaltenwert ungleich NULL ist.
GE(0)	Stimmt mit allen Zeilen überein, deren Spaltenwert größer gleich Null ist.
foo%	Stimmt mit allen Zeilen überein, deren Spaltenwert mit „foo“ beginnt

Schreibberechtigungen

Generell gelten für die SKOOR-Benutzerrollen folgende Regeln:

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

Definieren Sie Schreibrechte für

Benutzern mit der Rolle „Editor“ das Bearbeiten von Daten in ausgewählten Tabellen ermöglichen
Benutzern mit der Rolle Operator das Lesen und Bearbeiten von Daten in ausgewählten Tabellen ermöglichen

Vorschau und Bearbeiten von Daten

Im Reiter Daten sind alle Tabellen, Ansichten etc. der ausgewählten Datenquelle sichtbar. Operator -Benutzer sehen nur die Tabellen, die durch Schreibberechtigungen definiert sind.

Vorschau

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 ihn zu sortieren, oder verwenden Sie die Schaltfläche „Filter umschalten“ auf der rechten Seite, um nach bestimmten Datensätzen zu suchen.

Daten bearbeiten

Tabelle können bearbeitet werden, während Ansichten, materialisierte Ansichten usw. nur gelesen werden können

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

Klicken Sie auf „Änderungen speichern“ , um die Daten beizubehalten.

Daten exportieren

Durch Klicken auf die Schaltfläche Exportieren können Daten 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 UTF-8 kodiert exportiert

Daten importieren

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

Tabellen können direkt beim Importieren von Daten erstellt werden. Weitere Informationen finden Sie im Abschnitt „Tabelle erstellen“.

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ügt 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. Für diesen Fall muss ein Primärschlüssel für die Tabelle definiert sein.
REPLACE: Vorhandene Daten werden gekürzt, bevor sie aus der Datei geladen werden

Erstellen einer Tabelle

Nur Administratorbenutzer können neue Tabellen erstellen

Neue Tabellen können manuell oder im Zuge eines Datenimports 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, Datenbankschema bearbeiten .

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

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 bei einem zukünftigen Datenladen dieselbe Datei erneut importiert werden kann, können die Spaltennamen nicht geändert werden. Definieren Sie einen Tabellennamen (standardmäßig übernimmt die Software den Dateinamen) sowie Primärschlüssel, Indizes, Datentyp usw. und klicken Sie auf Erstellen und importieren, um die eigentliche Tabellenerstellung und den Datenimport zu starten.

Datenbankschema bearbeiten

Nur Administratoren können ein Datenbankschema bearbeiten

Klicken Sie auf das Optionssymbol eines Tabellenelements, um die eigentliche Tabelle zu löschen oder ihr Schema zu bearbeiten:

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

Einstellung	Beschreibung
Tabelle	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
Säulen	Definieren Sie Spaltennamen, Datentyp und Standardwert. Schalten Sie die automatische Erhöhung ein oder aus und ob eine Spalte null sein kann.

Erstellen einer Skriptdatenquelle

Wenn der Datenquellentyp in SCRIPT geändert wird, ändern sich die Konfigurationsparameter. Jetzt kann ein Skript zusammen mit allen erforderlichen Parametern konfiguriert werden, um eine für SKOOR-Dashboards geeignete Ausgabe zu generieren.

Die Skriptausgabe muss im JSON-Format sein

Parameter	Beschreibung
Name	Name der Datenquelle. Dieser Name ist in den Widget-Einstellungen verfügbar, wenn der Suchtyp auf dataSource eingestellt ist. Die Tabelle wird immer auf STDOUT eingestellt:
Ausführbare Datei abrufen	Vollständiger Pfad zum 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 an das Skript übergeben werden, ebenso wie direkt in diesem Feld festgelegte Argumente. Beispiel: Die Anzeige des URL-Parameters ist als Suchanfrage in einem Tabellen-Widget konfiguriert: Derselbe Parameter kann nun neben anderen Argumenten auch an das Datenquellenskript übergeben werden, beispielsweise der Wert „123“:
Ergebniszeiger abrufen	Wenn in den Dashboards nur eine Teilmenge 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" } ] } Auf einem Dashboard wird nur das Dateisystem-Array angezeigt. Daher muss der JSON-Zeiger /filesystems als Abrufergebniszeiger festgelegt werden: Wenn alle Objekte eines JSON-Strings angezeigt werden sollen, setzen Sie den Fetch-Ergebniszeiger auf „ / “.
Eindeutige ausführbare Datei	Wenn eine Skript-Datenquelle für ein Filtermatrix-Widget verwendet wird, wird ein JSON-Array mit eindeutigen Werten benötigt. Das hier konfigurierte Skript oder Programm muss ein solches Array zurückgeben
Klare Argumente	Siehe Fetch-Argumente
Eindeutiger Ergebniszeiger	Siehe Fetch-Ergebniszeiger
Säulen	Die JSON-Felder der Skriptausgabe müssen als Spalten konfiguriert werden, um als solche in den Dashboard-Widgets verfügbar zu sein.