Definición
Crea un ObjectId de un valor hexadecimal.
Compatibilidad
Este método está disponible en implementaciones alojadas en los siguientes entornos:
MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube
MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.
Sintaxis
El campo hexadecimalString especifica una cadena que contiene un valor hexadecimal de 24 caracteres. Por ejemplo, "64c13ab08edf48a008793cac".
Ejemplos
Los siguientes ejemplos muestran cómo agregar un identificador de objeto a un documento usando ObjectId.createFromHexString() y cómo aparece el identificador de objeto en la salida cuando se recupera.
Crear una colección que contenga un documento con identificador de objeto
El siguiente ejemplo crea una colección llamada objectIdentifierValuesFromHex:
db.objectIdentifierValuesFromHex.insertOne( { _id: 0, objectIdentifierValue: ObjectId.createFromHexString( "64c13ab08edf48a008793cac" ) } )
El campo objectIdentifierValue contiene el identificador de objeto creado a partir de la cadena hexadecimal especificada en ObjectId.createFromHexString().
Recuperar documento de una colección con identificador de objeto
El siguiente ejemplo recupera el documento:
db.objectIdentifierValuesFromHex.findOne( { _id: 0 } )
Ejemplo de salida:
{ _id: 0, objectIdentifierValue: ObjectId("64c13ab08edf48a008793cac") }