bson | objectId functions (ObjectId-Funktionen)
In diesem Abschnitt werden Funktionen für die Arbeit mit BSON objectId-Werten beschrieben.
BSON (Binary JSON) ist eine Binärdarstellung von vorwiegend von MongoDB verwendeten JSON-artigen Dokumenten. Einige Systeme, die MongoDB-kompatible APIs implementieren, wie Azure Cosmos DB unterstützen ebenfalls BSON-Dokumente.
Eine BSON objectId ist ein 12-Byte-Identifier bestehend aus:
•einem 4-Byte-Zeitstempel, der die Anzahl der Sekunden seit der Unix-Epoche darstellt (1970-01-01T00:00:00Z).
•einem 5-Byte-Zufallswert, der einmal pro clientseitigem Prozess generiert wird.
•einem um 3-Byte inkrementierenden Zähler pro Client-Prozess, der auf einen Zufallswert initialisiert wird. Dieser Zähler wird für jede neue durch denselben Prozess generierte ObjectID inkrementiert, wodurch die Eindeutigkeit gewährleistet wird.
Mapforce unterstützt die folgenden Funktionen für die Arbeit mit BSON-ObjectIds:
•objectId-datetime: Extrahiert das aus dem gespeicherten Zeitstempel konvertierte Datum und die Uhrzeit der Erstellung einer ObjectId (in UTC).
•objectId-random: Extrahiert den Zufallswert aus einer ObjectId.
•objectId- ordinal: Extrahiert den Inkrementierungszähler (Ordnungszahl) aus einer ObjectId.
•to-objectId: Erstellt anhand des angegebenen Datums, des Zufallswerts und Zählers eine ObjectId.
Behandlung von BSON ObjectIds in MapForce
BSON-ObjectIds werden automatisch in Hex-Strings konvertiert und wieder zurückkonvertiert. Nähere Informationen dazu finden Sie in der nachstehenden Tabelle. Ein Beispiel dazu finden Sie in der Beschreibung der to-objectId-Funktion.
Konvertierung | Was passiert |
|---|---|
bson.objectId > String | Erzeugt einen 24-Zeichen-Hexadezimalstring, der die 12-Byte-ObjectId darstellt. |
String > bson.objectId | Parst einen 24-Zeichen-Hexadezimalstring und erstellt daraus eine 12-Byte-ObjectId. Wenn es sich beim Input nicht um einen gültigen Hexadezimalstring der korrekten Länge handelt, kommt es zu einem Fehler. |
Nützliche Links