Datenquellen können konfiguriert werden, um Datenbanktabellen oder -ansichten in den SKOOR-Dashboards verfügbar zu machen. 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 von nahezu jeder anderen Quelle anzufordern.

Erstellen Sie eine 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, erscheint ein grünes Statussymbol zusammen mit einigen Registerkarten für weitere Aktionen in dieser Datenbank:

Definieren Sie Datenbereiche und Schreibberechtigungen

Nur Administratorbenutzer können Datenbereiche und Schreibberechtigungen definieren

Im Reiter „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 zum Geltungsbereich passen, sind für den jeweiligen Benutzer oder die Benutzergruppe sichtbar. Dies gilt sowohl für die Datenvorschau im Datenquellenbereich als auch für die Dashboards.

Bereichsdiskriminatorausdrücke können einfache Zeichenfolgenwerte oder Operatoren sein, die auf der Seite des Datenquellenabfrageeditors beschrieben werden.

Beispielausdrücke:

Ausdruck	Beschreibung
1234	Entspricht allen Zeilen mit einem Spaltenwert von 1234.
NICHT NULL())	Entspricht allen Zeilen mit einem Spaltenwert ungleich NULL.
GE(0)	Entspricht allen Zeilen, deren Spaltenwert größer gleich Null ist.
foo%	Entspricht allen Zeilen, 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

Erlauben Sie Benutzern mit der Editor-Rolle, Daten in ausgewählten Tabellen zu bearbeiten
Ermöglichen Sie Benutzern mit der Rolle Operator , Daten in ausgewählten Tabellen zu lesen und zu bearbeiten

Daten in der Vorschau anzeigen und bearbeiten

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

Vorschau

Wählen Sie ein Element aus den Gruppen auf der linken Seite aus (z. B. Tabellen ), 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. 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 Papierkorbsymbol. Mehrere Änderungen können gleichzeitig vorgenommen werden und werden durch einen Farbwechsel 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 für CSV auf 100 MB und für XLSX auf 2 MB begrenzt

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

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

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

EINFÜGEN: Alle Datensätze aus der Datei einfügen. Duplikate werden eingefügt, wenn die Tabellendefinition dies zulässt
UPSERT: Alle Datensätze aus der Datei einfügen. Wenn ein Datensatz bereits vorhanden ist, wird er aktualisiert. Für diesen Fall muss ein Primärschlüssel in der Tabelle definiert werden
ERSETZEN: Vorhandene Daten werden abgeschnitten, bevor die Daten aus der Datei geladen werden

Erstellen Sie eine Tabelle

Nur Administratorbenutzer 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, Datenbankschema 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 erforderliche Excel- (XLSX) oder CSV-Datei. Die SKOOR-Software wertet nun die Spalten und Datentypen aus:

Um sicherzustellen, dass dieselbe Datei bei einem zukünftigen Datenladevorgang 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 Administratorbenutzer können ein Datenbankschema bearbeiten

Klicken Sie auf das Optionssymbol eines Tabellenelements, um die tatsächliche 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 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, wenn eine Spalte nullbar ist

Erstellen Sie eine 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 in JSON formatiert 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 gesetzt:
Ausführbare Datei abrufen	Vollständig qualifizierter 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 URL- Parameteranzeige ist als Suchabfrage in einem Tabellen-Widget konfiguriert: Derselbe Parameter kann nun an das Datenquellenskript übergeben werden sowie weitere Argumente, 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 JSON-Beispielzeichenfolge 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 Skriptdatenquelle 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 Abrufargumente
Eindeutiger Ergebniszeiger	Siehe Abrufergebniszeiger
Säulen	Die JSON-Felder der Skriptausgabe müssen als Spalten konfiguriert werden, um als solche in den Dashboard-Widgets verfügbar zu sein