BSON Types

Datos binarios

Un valor binario BSON binData es una matriz de bytes. Un valor binData tiene un subtipo que indica cómo interpretar los datos binarios. La siguiente tabla muestra los subtipos.

ObjectId

Los ObjectIds son pequeños, probablemente únicos, rápidos de generar y ordenados. Los valores de ObjectId tienen una longitud de 12 bytes y consisten en:

• Una marca de tiempo de 4 bytes, que representa la creación del ObjectId, medida en segundos desde la Unix epoch.

• Un valor aleatorio de 5bytes generado una vez por cada proceso del lado del cliente. Este valor aleatorio es único para la máquina y el proceso. Si el proceso se reinicia o el nodo primario del proceso cambia, este valor se vuelve a generar.

• Un contador de 3bytes que se incrementa por cada proceso del lado del cliente, inicializado a un valor aleatorio. El contador se restablece cuando un proceso se reinicia.

Para los valores de marca de tiempo y contador, los bytes más significativos aparecen primero en la secuencia de bytes (big-endian). Esto es diferente de otros valores de BSON, donde los bytes menos significativos aparecen primero (little-endian).

Si se utiliza un valor entero para crear un ObjectId, el entero reemplaza la marca de tiempo.

En MongoDB, cada documento almacenado en una colección estándar requiere un campo _id único que actúa como llave primaria. Si un documento insertado omite el campo _id, el controlador de MongoDB genera automáticamente un ObjectId para el campo _id.

Esto también se aplica a los documentos insertados mediante operaciones de actualización con inserción: true.

Los clientes de MongoDB deben añadir un campo _id con un ObjectId único. El uso de ObjectIds para el campo _id ofrece los siguientes beneficios adicionales:

• Puedes acceder al tiempo de creación de ObjectId en mongosh utilizando el método ObjectId.getTimestamp().

• Los ObjectIds están ordenados de forma aproximada por el tiempo de creación, pero no están perfectamente ordenados. Ordenar una colección en un campo _id que contiene valores ObjectId es aproximadamente equivalente a ordenar por tiempo de creación.

  Importante

  Aunque los valores de ObjectId deberían aumentar con el tiempo, no son necesariamente monotónicos. Esto es porque ellos:

  • Solo contienen un segundo de resolución temporal, por lo que los valores ObjectId creados dentro del mismo segundo no tienen un orden garantizado y

  • Son generados por los clientes, que pueden tener relojes del sistema diferentes.

Utilice los ObjectId() métodos para establecer y recuperar valores de ObjectId.

A partir de MongoDB 5.0, mongosh reemplaza el shell heredado mongo. Los métodos ObjectId() funcionan de manera diferente en mongosh que en el shell mongo heredado. Para más información sobre los métodos heredados, consultar el Shell mongo heredado.

String

Las cadenas BSON son UTF-8. En general, los controladores de cada lenguaje de programación convierten del formato de string del lenguaje a UTF-8 al serializar y deserializar BSON. Esto hace posible almacenar con facilidad la mayoría de los caracteres internacionales en cadenas BSON. [1] Además, los query $regex de MongoDB admiten UTF-8 en la cadena regex.

Marcas de tiempo

BSON tiene un tipo especial de marca de tiempo para uso interno de MongoDB y no está asociado con el tipo Date normal. Este tipo de marca de tiempo interno es un valor de 64 bits donde:

• los 32 bits más significativos son un valor time_t (segundos desde la Unix epoch)

• los 32 bits menos significativos son un ordinal que incrementa para operaciones dentro de un segundo dado.

Aunque el formato BSON es de tipo little-endian y, por lo tanto, almacena primero los bits menos significativos, la instancia de mongod siempre compara el valor time_t antes que el valor ordinal en todas las plataformas, independientemente de la endianness.

En la replicación, el oplog tiene un campo ts. Los valores de este campo reflejan el operation time, que utiliza un valor de marca de tiempo BSON.

Dentro de una sola instancia de mongod, los valores de marca de tiempo en el oplog siempre son únicos.

fecha

BSON Date es un entero de 64 bits que representa la cantidad de milisegundos desde la Unix epoch (1 de enero de 1970). Esto da como resultado un rango de fechas representable de aproximadamente 290 millones de años hacia el pasado y el futuro.

La especificación oficial de BSON se refiere al tipo de dato BSON como fecha y hora UTC.

El tipo de fecha BSON es con signo. [2] Los valores negativos representan fechas anteriores a 1970.

Para crear una Date en mongosh, puedes usar el constructor new Date() o ISODate().

var mydate1 = new Date()

mydate1

ISODate("2020-05-11T20:14:14.796Z")

var mydate2 = ISODate()

mydate2

ISODate("2020-05-11T20:14:14.796Z")

mydate1.toString()

Mon May 11 2020 13:14:14 GMT-0700 (Pacific Daylight Time)

mydate1.getMonth()

4

decimal128 Tipo de dato BSON

decimal128 Es una 128representación decimal de bits para almacenar números muy grandes o muy precisos, siempre que sea importante redondear decimales. Se creó en agosto de 2009 como parte de la revisión IEEE 754-2008 de coma flotante. Si necesita alta precisión al trabajar con tipos de datos BSON, debe decimal128 usar.

decimal128 soporta 34 cifras decimales de precisión, o significand junto con un rango de exponente de -6143 a +6144. El significando no está normalizado en el estándar decimal128, lo que permite múltiples representaciones posibles: 10 x 10^-1 = 1 x 10^0 = .1 x 10^1 = .01 x 10^2, etc. Tener la capacidad de almacenar valores máximos y mínimos en el orden de 10^6144 y 10^-6143, respectivamente, permite mucha precisión.

Decimal128("9823.1297")

Decimal128.fromStringWithRounding("1234.99999999999")

> 0.1
0.1
> 0.2
0.2
> 0.1 * 0.2
0.020000000000000004
> 0.1 + 0.1
0.010000000000000002

1
class Main {
2
   public static void main(String[] args) {
3
      System.out.println("0.1 * 0.2:");
4
      System.out.println(0.1 * 0.2);
5
   }
6
}

1
0.1 * 0.2:
2
0.020000000000000004

BSON con controladores MongoDB

Para ver cómo controladores específicos manejan BSON, consulte la documentación de su controlador:

• C: BSON

• C++: Trabajando con BSON

• C#: Operaciones BSON

• Ir: Trabajar con BSON

• Java Sync: Document Data Format: BSON

• Kotlin: Formato de datos del documento: BSON

• PHP: Tipos de datos personalizados

• Node.js: Trabajar con datos BSON

• PyMongo: BSON

• Ruby: Formato de datos BSON

• Rust: ¿Cómo convierto entre tipos BSON y Rust?