MongoDB Extended JSON (v2)

Uso de MongoDB Extended JSON v2

EJSON.serialize( db.<collection>.findOne() )

EJSON.deserialize( <serialized object> )

EJSON.stringify( <deserialized object> )

EJSON.parse( <string> )

Tipos de datos BSON y sus representaciones asociadas

A continuación, se presentan algunos tipos de datos BSON comunes y las representaciones asociadas en Canónico y Relajado.

La lista completa está aquí.

Array

[ <elements> ]

<Same as Canonical>

Donde los elementos del arreglo son los siguientes:

• <elements>

  • Los elementos del arreglo utilizan JSON extendido.

  • Para especificar un arreglo vacío, omita el contenido [ ].

Binary

{ "$binary":
   {
      "base64": "<payload>",
      "subType": "<t>"
   }
}

<Same as Canonical>

Donde los valores son los siguientes:

• "<payload>"

  • String de carga útil codificada en Base64 (con relleno como "=").

• "<t>"

  • Un string hexadecimal de uno o dos caracteres que corresponde a un subtipo binario de BSON. Consulta la documentación extendida de BSON http://bsonspec.org/spec.html para los subtipos disponibles.

Date

Para fechas entre los años 1970 y 9999, inclusive:

{"$date": {"$numberLong": "<millis>"}}

{"$date": "<ISO-8601 Date/Time Format>"}

Para fechas anteriores al año 1970 o después del año 9999:

{"$date": {"$numberLong": "<millis>"}}

<Same as Canonical>

Donde los valores son los siguientes:

• "<millis>"

  • Un entero con signo de 64 bits como string. El valor representa los milisegundos en relación con el Unix epoch.

• "<ISO-8601 Date/Time Format>"

  • Una fecha en formato de fecha/hora de Internet ISO-8601 como string.

  • La fecha/hora tiene una precisión máxima de tiempo de milisegundos:

    • Los segundos fraccionarios tienen exactamente 3 lugares decimales si la parte fraccionaria no es cero.

    • De lo contrario, los segundos fraccionarios DEBERÍAN omitirse si son cero.

Decimal128

{ "$numberDecimal": "<number>" }

<Same as Canonical>

Donde los valores son los siguientes:

• "<number>"

  • Un decimal de alta precisión como string.

Document

{ <content> }

<Same as Canonical>

Donde el contenido del documento es el siguiente:

• <content>

  • Nombre: pares de valor que utilizan JSON extendido.

  • Para especificar un documento vacío, omita el contenido { }.

Double

Para números finitos:

{"$numberDouble": "<decimal string>" }

<non-integer number>

Para números infinitos o NaN:

{"$numberDouble": <"Infinity"|"-Infinity"|"NaN"> }

<Same as Canonical>

Donde los valores son los siguientes:

• "<decimal string>"

  • Un número de punto flotante con signo de 64 bits como string.

• <non-integer number>

  • Un número no entero. Los números enteros se interpretan como un entero en lugar de un doble.

Int64

{ "$numberLong": "<number>" }

<integer>

Donde los valores son los siguientes:

• "<number>"

  • Un entero con signo de 64 bits como string.

• <integer>

  • Un entero con signo de 64 bits.

Int32

{ "$numberInt": "<number>" }

<integer>

Donde los valores son los siguientes:

• "<number>"

  • Un entero con signo de 32 bits como string.

• <integer>

  • Un entero con signo de 32 bits.

MaxKey

{ "$maxKey": 1 }

<Same as Canonical>

El tipo de dato MaxKey de BSON se considera mayor que todos los demás tipos. Consulte Comparación/Orden de clasificación para obtener más información sobre el orden de comparación para los BSON types.

MinKey

{ "$minKey": 1 }

<Same as Canonical>

El tipo de dato MinKey de BSON se considera menor que todos los demás tipos. Consulte Comparación/Orden de clasificación para obtener más información sobre el orden de comparación para los BSON types.

ObjectId

{ "$oid": "<ObjectId bytes>" }

<Same as Canonical>

Donde los valores son los siguientes:

• "<ObjectId bytes>"

  • Una string hexadecimal de 24 caracteres en formato big-endian que representa los bytes de ObjectId.

Regular Expression

{ "$regularExpression":
   {
      "pattern": "<regexPattern>",
      "options": "<options>"
  }
}

<Same as Canonical>

Donde los valores son los siguientes:

• "<regexPattern>"

  • Una string que corresponde al patrón de expresión regular. La string puede contener caracteres JSON válidos y comillas dobles no escapadas ("), pero no puede contener caracteres de barra inclinada no escapada (/).

• "<options>"

  • Un string que especifica las opciones de expresión regular BSON. Debe especificar las opciones en orden alfabético. Para obtener información sobre las opciones compatibles, consulte $options.

Timestamp

{"$timestamp": {"t": <t>, "i": <i>}}

<Same as Canonical>

Donde los valores son los siguientes:

• <t>

  • Un número entero positivo para los segundos desde la epoch.

• <i>

  • Un número entero positivo para el incremento.

Ejemplos

Los ejemplos de esta página utilizan datos del conjunto de datos de muestra sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en la implementación autogestionada de MongoDB, consultar Cargar el conjunto de datos de muestra. Si se realizó alguna modificación en las bases de datos de muestra, es posible que se deban descartar y volver a crear las bases de datos para ejecutar los ejemplos de esta página.

Los siguientes ejemplos ilustran el uso de JSON extendido.

serialized = EJSON.serialize(
   db.comments.find( {}, { _id: 1, date: 1 } ).sort( { _id: 1 } ).limit(1).next()
)

{
  _id: {
    '$oid': '5a9427648b0beebeb69579e7'
  },
  date: {
    '$date': '2002-08-18T04:56:07.000Z'
  }
}

EJSON.deserialize( serialized )

{
  _id: ObjectId('5a9427648b0beebeb69579e7'),
  date: ISODate('2002-08-18T04:56:07.000Z')
}

stringified = EJSON.stringify(
   db.comments.find( {}, { _id: 1, date: 1 } ).sort( { _id: 1 } ).limit(1).next()
)

{"_id":{"$oid":"5a9427648b0beebeb69579e7"},"date":{"$date":"2002-08-18T04:56:07.000Z"}}

EJSON.parse( stringified )

{
  _id: ObjectId('5a9427648b0beebeb69579e7'),
  date: ISODate('2002-08-18T04:56:07.000Z')
}