HexData() (método mongosh)

Definición

Crea un objeto de datos binarios a partir de datos hexadecimales.

Sintaxis

HexData() tiene la siguiente sintaxis:

HexData( <subType>, <buffer> )

Devuelve:	Objeto de datos binarios.

Campos de comandos

El comando acepta estos campos:

Campo

Tipo

Necesidad

Descripción

subType

entero

Requerido

Especifique un subtipo de datos:

Número	Descripción
0	Subtipo binario genérico
1	Datos de funciones
2	Binario (antiguo)
3	UUID (antiguo)
4	UUID
5	md5
6	Valor BSON cifrado
7	Datos de series de tiempo comprimidos Nuevo en la versión 5.2.
8	Datos sensibles, como una clave o un secreto. MongoDB no registra valores literales para datos binarios con subtipo 8. En cambio, MongoDB registra un valor de marcador de posición de `###`.
9	Datos vectoriales, que son arreglos densamente empaquetados de números del mismo tipo.
128	Datos personalizados

buffer

string

Requerido

Datos hexadecimales. La string se decodifica hasta el primer carácter que no es un dígito hexadecimal válido. Puedes usar letras mayúsculas o minúsculas en el string hexadecimal.

Nota

mongosh se detiene silenciosamente el análisis en el primer carácter no hexadecimal, a diferencia del shell heredado que rechaza los caracteres hexadecimales no válidos. Para determinar si tu salida de HexData() es válida, puedes utilizar el método .toString('hex') sobre la salida HexData() y comparar dicha string con la string de entrada original usando una comparación que no distingue mayúsculas de minúsculas.

Ejemplos

Crea la colección de ejemplo

Utilice HexData() para insertar un documento con datos binarios creados a partir de una cadena hexadecimal en una colección de prueba:

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

Retrieve the document

Para devolver el documento, ejecuta el siguiente comando find:

db.hexCollection.find()

La salida muestra el valor hexField como un número en base 64 usando Binary.createFromBase64():

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

Obtén más información

Volver

fecha

ObjectId