bson | objectId functions
Cette section décrit les fonctions permettant de manipuler les valeurs objectId BSON.
BSON (Binary JSON) est une représentation binaire de documents de type JSON principalement utilisée par MongoDB. Certains systèmes qui implémentent des API compatibles avec MongoDB, tels qu'Azure Cosmos DB, prennent également en charge les documents BSON.
Un BSON ObjectId est un identifiant de 12 octets composé de :
•Un horodatage de 4 octets représentant le nombre de secondes écoulées depuis l'époque Unix (1970-01-01T00:00:00Z).
•Une valeur aléatoire de 5 octets générée une fois par processus côté client.
•Un compteur incrémental de 3 octets par processus client, initialisé à une valeur aléatoire. Ce compteur s'incrémente à chaque fois qu'un nouvel ObjectId est généré par le même processus, garantissant ainsi l'unicité.
MapForce prend en charge les fonctions suivantes pour travailler avec les ObjectId BSON :
•objectId-datetime: extrait la date et l'heure de création d'un ObjectId (en UTC), converties à partir de l'horodatage enregistré.
•objectId-random: extrait la valeur aléatoire d'un ObjectId.
•objectId-ordinal: extrait le compteur incrémental (ordinal) d'un ObjectId.
•to-objectId: crée un ObjectId en utilisant la date de création, la valeur aléatoire et le compteur spécifiés.
Gestion des objectId BSON dans MapForce
Les objectId BSON sont automatiquement convertis en chaînes hexadécimales et inversement. Pour plus de détails, consultez le tableau ci-dessous. Pour un exemple, consultez la description de la fonction to-objectId.
Conversion | Ce qui se passe |
|---|---|
bson.objectId > string | Produit une chaîne hexadécimale de 24 caractères représentant l'ObjectId de 12 octets. |
string > bson.objectId | Analyse une chaîne hexadécimale de 24 caractères et construit un ObjectId de 12 octets. Une erreur se produit si l'entrée n'est pas une chaîne hexadécimale valide de longueur correcte. |
Liens utiles