/ /

Construtores de objetos

Página inicial do Docs

/ /

Métodos de mongosh

Construtores de objetos

Página inicial do Docs

Desenvolvimento

Referência

Métodos de mongosh

Construtores de objetos

HexData() (método mongosh)

Definição

Cria um objeto de dados binários a partir de dados hexadecimais.

Sintaxe

HexData() tem a seguinte sintaxe:

HexData( <subType>, <buffer> )

Retorna:	objeto de dados binários.

Campos de comando

O comando usa esses campos:

Campo

Tipo

necessidade

Descrição

subType

inteiro

Obrigatório

Especifique um subtipo de dados:

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

buffer

string

Obrigatório

Dados hexadecimais. A string é decodificada até o primeiro caractere que não é um dígito hexadecimal válido. Você pode usar letras maiúsculas ou minúsculas na string hexadecimal.

Observação

mongosh para silenciosamente de analisar no primeiro caractere não hexadecimal, ao contrário do shell legado que rejeita caracteres hexadecimais inválidos. Para determinar se a saída HexData() é válida, você pode usar o método .toString('hex') na saída HexData() e comparar essa string com a string de entrada original usando uma comparação sem distinção entre maiúsculas e minúsculas.

Exemplos

Criar a coleção de exemplo

Use HexData() para inserir um documento com dados binários criados a partir de uma string hexadecimal em uma collection de teste:

db.hexCollection.insertOne( {
   _id: 0, hexField: HexData( 0, "123456abcdef" )
} )

Retrieve the document

Para retornar o documento, execute o seguinte comando find :

db.hexCollection.find()

A saída mostra o valor hexField como um número 64 base usando Binary.createFromBase64():

[ { _id: 0, hexField: Binary.createFromBase64('EjRWq83v', 0) } ]

Saiba mais

Voltar

Data

ObjectId