New-JsonDb

EulandaXtools — Funktionsreferenz

New-JsonDb

ÜBERSICHT

Erstellt und verwaltet eine einfache, dateibasierte JSON-Datenbank für schnelle und sichere CRUD-Operationen mit Key-Management, Dateisperre und einfacher Integration in PowerShell-Skripte. Ideal für kleinere bis mittlere Datenmengen und Konfigurationen, bei denen keine komplexe relationale Datenbank benötigt wird.

SYNTAX

New-JsonDb [-Timeout] <int>

BESCHREIBUNG

Die Funktion New-JsonDb erzeugt ein Objekt, das eine JSON-Datei als Datenbank verwendet. Dabei wird automatisch eine JSON-Datei im angegebenen Ordner erstellt oder geöffnet. Jede Tabelle erhält eine eigene JSON-Datei, die den Tabellennamen als Dateinamen verwendet. Das Objekt unterstützt sichere CRUD-Operationen (Create, Read, Update, Delete) auf Datensätzen und verwendet dabei ein definiertes Key-Feld zur eindeutigen Identifizierung von Datensätzen. Um eine konsistente Datenbearbeitung zu gewährleisten, wird ein Locking-Mechanismus eingesetzt.

PARAMETER

-DataPath

Der Ordnerpfad, in dem sich die JSON-Datenbankdateien befinden oder erstellt werden sollen.

-Table

Der Tabellenname, der gleichzeitig als Dateiname für die JSON-Datenbankdatei verwendet wird.

-KeyField

Der Name des Feldes, das als eindeutiger Schlüssel (Primärschlüssel) für die Datensätze in der Tabelle dient.

-Timeout

Type: int
Default: 60

Optionale Timeout-Dauer in Sekunden für das Warten auf Freigabe eines Dateizugriffs bei gleichzeitiger Nutzung. Standard ist 60 Sekunden.

BEISPIELE

$db = New-JsonDb -DataPath "C:\temp" -Table "Partner" -KeyField "partnerName"
$db.AddOrUpdate(@{ partnerName="REWE"; partnerGln="4711" })
$partner = $db.GetItem("REWE")

HINWEISE

Unterstützt PowerShell 5.1 und neuer. Datensicherheit durch Lock-Mechanismus.