Binary.createFromBase64() (método mongosh)

Definição

Cria um objeto binário a partir de um valor base64.

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Sintaxe

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

Campos de método

O método aceita os seguintes campos:

Campo	Tipo	Descrição
`base64String`	String	Especifica uma string que contém um valor base64. Por exemplo, `"SGVsbG8gV29ybGQhCg=="`.
`subType`	Inteiro	Opcional. Especifica um subtipo binário. `0`Subtipo binário genérico `1`: Função `2`: Array de bytes (obsoleto) `3`: UUID antigo (obsoleto) `4`: UUID `5`: MD5 `128` por meio de `255`: Definido pelo usuário

Exemplos

Os exemplos a seguir mostram como adicionar um objeto binário a um documento usando Binary.createFromBase64() e como o objeto binário aparece na saída quando recuperado.

Criar collection contendo documento com objeto binário

O exemplo a seguir cria uma collection chamada binaryObjectsFromBase64:

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

O campo binaryObject contém o objeto binário criado a partir da string especificada em Binary.createFromBase64().

Recuperar documento da coleção com objeto binário

O exemplo a seguir recupera o documento:

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

Observação

Starting in mongosh 2.0.0, binary objects are shown as Binary.createFromBase64( <base64String> ) values instead of Binary( Buffer.from( <base64String> ) ) values. This only changes the display of binary values.

Exemplo de saída, começando em mongosh 2.0.0:

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

Voltar

sh.waitForPingChange

Binary.createFromHexString