Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

BinData()

Nesta página

  • Definição
  • Compatibilidade
  • Comportamento
  • Exemplos

Cria um objeto de dados binários.

BinData tem a seguinte sintaxe:

BinData(<sub_type>,<buffer>)
Parâmetro
Tipo
Descrição
sub_type
inteiro
Osubtipo binário
buffer
string
O objeto de buffer contendo dados binários. Deve ser um valor de string codificada 64 base.
Retorna:Um objeto de dados binários.

Especifique um dos seguintes valores para sub_type:

Número
Descrição
0
Subtipo binário genérico
1
Dados de Função
2
Binário (antigo)
3
UUID (antigo)
4
UUID
5
md5
6
Valor BSON criptografado
7

Dados de série temporal compactados

Novidades na versão 5.2.

8
Dados confidenciais, como uma chave ou segredo. O MongoDB não registra valores literais para dados binários com subtipo 8. Em vez disso, o MongoDB registra um valor de espaço reservado de ###.
9
Dados vetoriais, que são arrays densamente compactadas de números do mesmo tipo.
128
Dados personalizados

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

  • MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

  • 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

A endianidade do seu sistema depende da arquitetura da sua máquina. Os números nos dados BSON são sempre armazenados como little-endian, se o seu sistema for big-endian , isso significa que os dados numéricos são convertidos entre big e little endian.

No contexto dos operadores de expressão de correspondência de teste de bit:

BinData Os valores atuam como bitmasks e são interpretados como se fossem números little-endian sem sinal de comprimento arbitrário. O byte endereçável mais baixo é sempre interpretado como o byte menos significativo. Da mesma forma, o byte endereçável de maior valor no BinData é sempre interpretado como o byte mais significativo.

Utilize o construtor BinData() para criar a variável bdata.

var bdata = BinData(0, "gf1UcxdHTJ2HQ/EGQrO7mQ==")

Insira o objeto na coleção testbin.

db.testbin.insertOne( { _id : 1, bin_data: bdata } )

Consulte a coleção testbin para obter o documento inserido.

db.testbin.find()

Você pode ver o buffer binário armazenado na coleção.

{
_id: 1,
bin_data: Binary(Buffer.from("81fd547317474c9d8743f10642b3bb99", "hex"), 0)
}

Utilize o construtor BinData() para criar a variável bdata.

var bdata = BinData(0, "gf1UcxdHTJ2HQ/EGQrO7mQ==")

Use .length() para retornar o comprimento em bits do objeto.

bdata.length()

O valor devolvido é:

16

Voltar

Binary.createFromHexString