Dokumentation

Daten-Quellen

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 von 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 auf die Schaltfläche „Speichern“ unterhalb der Verbindungsparameter, um eine Verbindung zur Datenbank herzustellen. Wenn die Datenbank erreichbar ist, erscheint ein grünes Statussymbol sowie einige Registerkarten für weitere Aktionen in dieser Datenbank:

image-20240808-084010.png

Über die 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

image-20250213-212229.png

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 Abschnitt „Datenquelle“ als auch für die Dashboards.

Ausdrücke zur Bereichsauswahl können einfache Zeichenfolgenwerte oder Operatoren sein, die auf der Seite des Datenquellen-Abfrageeditors beschrieben sind.

Beispielausdrücke:

Ausdruck

Beschreibung

1234

Passt auf alle Zeilen, deren Spaltenwert 1234 ist.

NOT(NULL())

Ergibt alle Zeilen, deren Spaltenwert nicht NULL ist.

GE(0)

Gibt alle Zeilen zurück, deren Spaltenwert größer oder gleich Null ist.

foo%

Gilt für alle Zeilen, deren Spaltenwert mit „foo“ beginnt

Schreibberechtigungen

Im Allgemeinen 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 einsehen

Schreibberechtigungen so definieren, dass

  • Benutzern mit der Rolle „Editor“ das Bearbeiten von Daten in ausgewählten Tabellen zu ermöglichen

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

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.

image-20250213-212333.png

Eine Datenquelle bearbeiten

Eine Tabelle erstellen/importieren

Nur Benutzer mit Administratorrechten können neue Tabellen erstellen

Neue Tabellen können manuell oder im Rahmen eines Datenimports erstellt werden.

Klicken Sie auf das Plus-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. festzulegen.

Weitere Informationen finden Sie im nächsten Abschnitt „Schema bearbeiten“

Um eine Tabelle im Rahmen eines Datenimports hinzuzufügen, stellen 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 Datenimport erneut importiert werden kann, dürfen die Spaltennamen nicht geändert werden. Legen Sie einen Tabellennamen fest (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.

Eine vorhandene Tabelle bearbeiten

Das Bearbeiten 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, Indizes oder 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 Mehrspaltenindizes für die aktuelle Tabelle

Spalten

Spaltennamen, Datentyp und Standardwert definieren. Die automatische Inkrementierung aktivieren oder deaktivieren und festlegen, ob eine Spalte Nullwerte zulassen darf

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 Papierkorbsymbol. Es können mehrere Änderungen gleichzeitig vorgenommen werden; diese werden durch eine Farbänderung und eine Rückgängig-Option auf der linken Seite gekennzeichnet.

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

image-20240808-093526.pngimage-20240808-093610.png

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

Tabelle löschen

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

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 berücksichtigt.

Die Daten werden in UTF-8-Kodierung exportiert

image-20240808-095215.png

Daten importieren

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

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

Excel-Dateien (nur im XLSX-Format) und kommagetrennte (CSV) Dateien 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: Alle Datensätze aus der Datei einfügen. Duplikate werden eingefügt, sofern die Tabellendefinition dies zulässt

  • UPSERT: Alle Datensätze aus der Datei einfügen. Wenn ein Datensatz bereits vorhanden ist, wird er aktualisiert. In diesem Fall muss für die Tabelle ein Primärschlüssel definiert sein

  • REPLACE: Vor dem Laden der Daten aus der Datei werden vorhandene Daten gelöscht

Erstellen einer Skript-Datenquelle (veraltet)

Skript-Datenquellen sind veraltet, und von ihrer Verwendung wird abgeraten

Wird der Datenquellentyp auf „SCRIPT“ geändert, ändern sich die Konfigurationsparameter. Nun 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

image-20240717-150657.png

Parameter

Beschreibung

Name

Name der Datenquelle. Dieser Name ist in den Widget-Einstellungen verfügbar, wenn der Suchtyp auf „dataSource“ eingestellt ist. Die Tabelle ist 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 an das Skript übergeben werden wie die direkt in diesem Feld festgelegten Argumente. 

Beispiel: Der URL-Parameter „display“ ist in einem Tabellen-Widget als Suchabfrage konfiguriert:

Derselbe Parameter kann nun zusammen mit anderen Argumenten an das Datenquellenskript übergeben werden, zum Beispiel der Wert „123“:

Zeiger auf das Abfrageergebnis

Wenn in den Dashboards nur ein Teil des JSON-String-Ergebnisses des Programms benötigt wird, muss ein JSON-Zeiger festgelegt werden. 

Die folgende Beispiel-JSON-Zeichenkette 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 „filesystems“-Array angezeigt. Daher muss der JSON-Zeiger „/filesystems“ als Abruf-Ergebniszeiger festgelegt werden:

Sollten alle Objekte einer JSON-Zeichenkette angezeigt werden, setzen Sie den Abruf-Ergebniszeiger auf „/“.

Eigenständige 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

Eindeutige Argumente

Siehe Abrufargumente

Zeiger auf das eindeutige Ergebnis

Siehe „Ergebniszeiger abrufen“

Spalten

Die JSON-Felder der Skript-Ausgabe müssen als Spalten konfiguriert werden, damit sie als solche in den Dashboard-Widgets verfügbar sind

Zurück
Daten-Quellen
Weiter
Datenabfragen