Definición
Crea un objeto binario a partir 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. Por ejemplo, "64c13ab08edf48a008793cac".
Ejemplos
Los siguientes ejemplos muestran cómo agregar un objeto binario a un documento usando Binary.createFromHexString() y cómo aparece el objeto binario en la salida cuando se recupera.
Crear una colección que contenga un documento con un objeto binario
El siguiente ejemplo crea una colección llamada binaryObjectsFromHexString:
db.binaryObjectsFromHexString.insertOne( { _id: 0, binaryObject: Binary.createFromHexString( "64c13ab08edf48a008793cac" ) } )
El campo binaryObject contiene el objeto binario creado a partir de la cadena especificada en Binary.createFromHexString().
Recuperar documento de una colección con un objeto binario
El siguiente ejemplo recupera el documento:
db.binaryObjectsFromHexString.findOne( { _id: 0 } )
Nota
A partir mongosh 2.0.0 de, los valores binarios se muestran como Binary.createFromBase64( <base64String> ) en lugar Binary( Buffer.from( <base64String> ) ) de. Esto solo cambia la visualización de los valores binarios.
Ejemplo de salida, que muestra el número en base64:
{ _id: 0, binaryObject: Binary.createFromBase64("ZME6sI7fSKAIeTys") }