Kategorie: DBMS-Informationen#

Die Kategorie DBMS-Informationen (im englischen UI als "Databases" bezeichnet) dokumentiert die einzelnen Datenbanken innerhalb einer DBMS-Instanz auf einem Server. Sie ist eine Multi-Value-Kategorie -- pro Objekt lassen sich beliebig viele Datenbanken erfassen, denn ein Datenbankserver beherbergt in der Regel mehrere Datenbanken gleichzeitig.

Verwendung#

Typische Anwendungsfälle:

• Datenbankinventar aufbauen: Erfasse alle Datenbanken eines Servers mit Name, zugehörigem DBMS und Instanz. Zusammen mit der Softwarezuweisung entsteht ein vollständiges Bild der Datenbanklandschaft.
• Kapazitätsplanung: Die Felder Größe und Maximale Größe zeigen auf einen Blick, wie viel Speicher eine Datenbank aktuell belegt und welches Limit konfiguriert ist. Reports über diese Felder warnen frühzeitig vor Engpässen.
• Schema-Zuordnung: Über das Feld Schemata werden Datenbankschema-Objekte (Objekttyp "Datenbankschema") zugewiesen. So entsteht die Verbindung zur spezifischen Kategorie Datenbankschema, in der Schema-Details wie Storage Engine dokumentiert werden.
• Impact-Analyse: Wenn eine Datenbank gewartet oder migriert wird, zeigt die Verkettung Server --> Instanz --> Datenbank --> Tabellen sofort, welche Anwendungen und Tabellen betroffen sind.
• Compliance und Datenschutz: In Kombination mit der Kategorie Datenbanktabellen lässt sich nachvollziehen, in welcher Datenbank personenbezogene Daten gespeichert werden -- eine häufige Anforderung aus DSGVO-Audits.

Felder#

Zugewiesenes DBMS#

Verknüpfung zum DBMS, das diese Datenbank verwaltet. Auswahlfeld -- die verfügbaren Werte stammen aus den DBMS-Einträgen, die auf dem aktuellen Server über die Softwarezuweisung installiert sind. Damit i-doit weiss, welches Datenbankmanagementsystem für diese Datenbank zuständig ist.

Instanz#

Die DBMS-Instanz, unter der diese Datenbank läuft. Auswahlfeld -- die Werte stammen aus der Kategorie Datenbank-Hierarchie des aktuellen Objekts. Auf einem Server mit mehreren Instanzen (z.B. einer produktiven und einer Test-Instanz) wird hier die richtige zugeordnet.

Schemata#

Verknüpfung zu einem oder mehreren Datenbankschema-Objekten (Objekttyp "Datenbankschema"). Mehrfachauswahl -- so lassen sich alle Schemata einer Datenbank zuweisen. Die Schema-Objekte werden in der spezifischen Kategorie Datenbankschema weiter dokumentiert (Storage Engine, Beschreibung etc.).

Bezeichnung#

Der Name der Datenbank, z.B. idoit_data, wordpress_prod oder erp_main. Dieser Wert erscheint in der Listenansicht und in Reports.

Größe und Einheit#

Die aktuelle Größe der Datenbank. Die Einheit (MB, GB, TB) wird separat angegeben. Dieser Wert sollte regelmäßig aktualisiert werden -- idealerweise automatisiert über die API oder einen JDisc-Import.

Maximale Größe und Einheit#

Das konfigurierte Größenlimit der Datenbank. Wenn die aktuelle Größe sich diesem Wert nähert, ist ein Kapazitäts-Upgrade erforderlich. Dialog+-Feld für die Einheit -- so können auch ungewöhnliche Einheiten ergänzt werden.

Beschreibung#

Freitext für zusätzliche Angaben: Zweck der Datenbank, zugehörige Anwendung, Backup-Strategie, Replikationsstatus oder Verantwortlichkeiten.

Technische Referenz#

Felder (API-Referenz)#

API-Beispiele#

Eintrag erstellen#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.save",
    "params": {
        "apikey": "dein-api-key",
        "object": 4711,
        "category": "C__CATG__DATABASE_SA",
        "data": {
            "assigned_database": 1,
            "assigned_instance": 2,
            "title": "idoit_data",
            "size": 12.5,
            "size_unit": 3,
            "max_size": 50.0,
            "max_size_unit": 3,
            "description": "i-doit Mandantendatenbank, taegliches Backup via mysqldump"
        }
    },
    "id": 1
}

Einträge lesen#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.read",
    "params": {
        "apikey": "dein-api-key",
        "object": 4711,
        "category": "C__CATG__DATABASE_SA"
    },
    "id": 2
}

Eintrag aktualisieren#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.save",
    "params": {
        "apikey": "dein-api-key",
        "object": 4711,
        "category": "C__CATG__DATABASE_SA",
        "entry": 8,
        "data": {
            "size": 18.3,
            "description": "Update 2026-04: Datenbankgroesse nach Archivierung auf 18.3 GB gesunken."
        }
    },
    "id": 3
}