Binary.createFromBase64() (método mongosh)

Definición

Crea un objeto binario a partir de un valor base64.

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

Binary.createFromBase64( <base64String> [ , <subType> ] )

Campos de métodos

El método acepta los siguientes campos:

Campo

Tipo

Descripción

base64String

String

Especifica un string que contiene un valor base64. Por ejemplo, "SGVsbG8gV29ybGQhCg==".

subType

entero

opcional. Especifica un subtipo binario.

Valor	Descripción
0	Subtipo binario genérico
1	Función
2	Arreglo de bytes (obsoleta)
3	UUID antiguo (obsoleto)
4	UUID
5	md5
128 hasta 255	Definido por el usuario

Ejemplos

Los siguientes ejemplos muestran cómo agregar un objeto binario a un documento usando Binary.createFromBase64() y cómo aparece el objeto binario en la salida al recuperarlo.

Crear una colección que contenga un documento con un objeto binario

El siguiente ejemplo crea una colección llamada binaryObjectsFromBase64:

db.binaryObjectsFromBase64.insertOne( {
   _id: 0,
   binaryObject: Binary.createFromBase64( "SGVsbG8gV29ybGQhCg==" )
} )

El campo binaryObject contiene el objeto binario creado a partir de la cadena especificada en Binary.createFromBase64().

Recuperar documento de colección con objeto binario

El siguiente ejemplo recupera el documento:

db.binaryObjectsFromBase64.findOne( { _id: 0 } )

Nota

Comenzando en mongosh 2.0.0, los objetos binarios se muestran como valores Binary.createFromBase64( <base64String> ) en lugar de valores Binary( Buffer.from( <base64String> ) ). Esto solo cambia la visualización de los valores binarios.

Ejemplo de salida, a partir de mongosh 2.0.0:

{
   _id: 0,
   binaryObject: Binary.createFromBase64("SGVsbG8gV29ybGQhCg==")
}

Volver

sh.waitForPingChange

Binario.createFromHexString