MongoDB扩展JSON（v2）_MonogDB 中文网

参考 > 介绍 > BSON类型 > MongoDB扩展JSON（v2）

在本页面

MongoDB扩展JSON v2用法
BSON数据类型和关联的表示形式
例

消歧

下一页讨论了MongoDB Extended JSON v2。有关旧版MongoDB扩展JSON v1的讨论，请参阅 MongoDB扩展JSON（v1）。

有关mongo类型的Shell包装器方法，请参阅 mongo Shell中的数据类型。

JSON只能直接表示 BSON支持的类型的子集。为了保留类型信息，MongoDB将以下扩展添加到JSON格式。

规范模式

一种字符串格式，该格式强调类型保留，但会牺牲可读性和互操作性。也就是说，从规范到BSON的转换通常会保留类型信息，除非在某些特定情况下。
放松模式

一种字符串格式，它以保留类型为代价来强调可读性和互操作性。也就是说，从宽松格式转换为BSON可能会丢失类型信息。

两种格式都符合JSON RFC，并且可以由各种MongoDB驱动程序和工具进行解析。

MongoDB扩展JSON v2用法¶

驱动程序¶

以下驱动程序使用扩展JSON v2.0

C C ++ 走	爪哇节点佩尔	PHPC python 斯卡拉

对于使用旧版MongoDB扩展JSON v1的C＃和Ruby，请参阅 MongoDB扩展JSON（v1）。

MongoDB命令行工具¶

从4.2版开始：

`bsondump`	使用扩展JSON v2.0（规范模式）格式。
`mongodump`	对元数据使用扩展的JSON v2.0（规范模式）格式。需要`mongorestore`支持扩展JSON v2.0（规范模式或宽松模式）格式的4.2+版本。小费在一般情况下，使用相应的版本 `mongodump`和`mongorestore`。也就是说，要还原使用特定版本创建的数据文件`mongodump`，请使用的相应版本`mongorestore`。
`mongoexport`	默认情况下，以扩展JSON v2.0（轻松模式）创建输出数据。如果与一起使用，则以扩展JSON v2.0（规范模式）创建输出数据。`--jsonFormat canonical`
`mongoimport`	预期导入数据默认为扩展JSON v2.0（轻松模式或规范模式）。如果`--legacy`指定了选项，则可以识别扩展JSON v1.0格式的数据。小费在一般情况下，的版本`mongoexport`和 `mongoimport`应该匹配。也就是说，要导入从创建的数据`mongoexport`，您应该使用的相应版本`mongoimport`。

BSON数据类型和关联的表示形式¶

下面介绍了一些常见的BSON数据类型以及Canonical和Relaxed中的相关表示形式。

`Array` `Binary` `Date`	`Decimal128` `Document` `Double`	`Int32` `Int64` `MaxKey`	`MinKey` `ObjectId` `Regular Expression` `Timestamp`

有关完整列表，请参见 https://github.com/mongodb/specifications/blob/master/source/extended-json.rst#conversion-table。

Array¶

典范	轻松
[ <elements> ]	<Same as Canonical>

其中数组元素如下：
`<elements>` 数组元素使用扩展JSON。要指定一个空数组，请省略content 。`[ ]`

Binary¶

典范	轻松
{ "$binary": { "base64": "<payload>", "subType": "<t>" } }	<Same as Canonical>

值如下：
`"<payload>"` Base64编码（填充为“ =”）有效负载字符串。 `"<t>"` 一个或两个字符的十六进制字符串，对应于BSON二进制子类型。有关可用的子类型，请参阅扩展的bson文档 http://bsonspec.org/spec.html。

Date¶

对于1970年和9999年之间的日期，包括：

典范	轻松
{"$date": {"$numberLong": "<millis>"}}	{"$date": "<ISO-8601 Date/Time Format>"}

对于1970年之前或9999年之后的日期：

典范	轻松
{"$date": {"$numberLong": "<millis>"}}	<Same as Canonical>

值如下：
`"<millis>"` 一个64位带符号整数作为字符串。该值表示相对于纪元的毫秒数。 `"<ISO-8601 Date/Time Format>"` 在日期ISO-8601上网日期/时间格式的字符串。日期/时间的最大时间精度为毫秒：如果小数部分不为零，则小数秒精确地保留小数点后3位。否则，如果为零，则应忽略小数秒。

Decimal128¶

3.4版的新功能。

典范	轻松
{ "$numberDecimal": "<number>" }	<Same as Canonical>

值如下：
`"<number>"` 一个高精度小数的字符串。

Document¶

典范	轻松
{ <content> }	<Same as Canonical>

其中文件内容如下：
`<content>` 名称：使用扩展JSON的值对。要指定一个空文档，请省略content 。`{ }`

Double¶

对于有限数：

典范	轻松
{"$numberDouble": "<decimal string>" }	<non-integer number>

对于无限数或NAN：

典范	轻松
{"$numberDouble": <"Infinity"\|"-Infinity"\|"NaN"> }	<Same as Canonical>

值如下：
`"<decimal string>"` 一个64位带符号浮点数作为字符串。 `<non-integer number>` 非整数。整数被解析为整数，而不是双精度。

Int64¶

典范	轻松
{ "$numberLong": "<number>" }	<integer>

值如下：
`"<number>"` 一个64位带符号整数作为字符串。 `<integer>` 一个64位有符号整数。

Int32¶

典范	轻松
{ "$numberInt": "<number>" }	<integer>

值如下：
`"<number>"` 一个32位带符号整数作为字符串。 `<integer>` 一个32位有符号整数。

MaxKey¶

典范	轻松
{ "$maxKey": 1 }	<Same as Canonical>

MaxKey BSON数据类型比所有其他类型的数据类型比较高。有关BSON类型的比较顺序的更多信息，请参见比较/排序顺序。

MinKey¶

典范	轻松
{ "$minKey": 1 }	<Same as Canonical>

MinKey BSON数据类型的比较低于所有其他类型。有关BSON类型的比较顺序的更多信息，请参见比较/排序顺序。

ObjectId¶

典范	轻松
{ "$oid": "<ObjectId bytes>" }	<Same as Canonical>

值如下：
`"<ObjectId bytes>"` 一个24个字符的大端十六进制字符串，表示ObjectId字节。

Regular Expression¶

典范	轻松
{ "$regularExpression": { "pattern": "<regexPattern>", "options": "<options>" } }	<Same as Canonical>

值如下：
`"<regexPattern>"` 对应于正则表达式模式的字符串。该字符串可以包含有效的JSON字符和未转义的双引号（`"`）字符，但不能包含未转义的正斜杠（`/`）字符。 `"<options>"` 指定BSON正则表达式选项的字符串（“ g”，“ i”，“ m”和“ s”）或空字符串`""`。转换为该表示形式时，除（'g'，'i'，'m'和's'）以外的其他选项将被删除。重要选项必须按字母顺序排列。

Timestamp¶

典范	轻松
{"$timestamp": {"t": <t>, "i": <i>}}	<Same as Canonical>

值如下：
`<t>` 从纪元以来的秒数的正整数。 `<i>` 增量的正整数。

例子¶

示例字段名称	规范格式	宽松格式
“_ID：”	{“ $ oid”：“ 5d505646cf6d4fe581014ab2”}}	{“ $ oid”：“ 5d505646cf6d4fe581014ab2”}}
“ arrayField”：	[“ hello”，{“ $ numberInt”：“ 10”}]	[“你好”，10]
“ dateField”：	{“ $ date”：{“ $ numberLong”：“ 1565546054692”}}	{“ $ date”：“ 2019-08-11T17：54：14.692Z”}
“ dateBefore1970”：	{“ $ date”：{“ $ numberLong”：“-1577923200000”}}	{“ $ date”：{“ $ numberLong”：“-1577923200000”}}
“ decimal128Field”：	{“ $ numberDecimal”：“ 10.99”}	{“ $ numberDecimal”：“ 10.99”}
“ documentField”：	{“ a”：“ hello”}	{“ a”：“ hello”}
“ doubleField”：	{“ $ numberDouble”：“ 10.5”}	10.5
“ infiniteNumber”	{“ $ numberDouble”：“ Infinity”}	{“ $ numberDouble”：“ Infinity”}
“ int32field”：	{“ $ numberInt”：“ 10”}	10
“ int64Field”：	{“ $ numberLong”：“ 50”}	50
“ minKeyField”：	{“ $ minKey”：1}	{“ $ minKey”：1}
“ maxKeyField”：	{“ $ maxKey”：1}	{“ $ maxKey”：1}
“ regexField”：	{“ $ regularExpression”：{“ pattern”：“ ^ H”，“ options”：“ i”}}	{“ $ regularExpression”：{“ pattern”：“ ^ H”，“ options”：“ i”}}
“ timestampField”：	{“ $ timestamp”：{“ t”：1565545664，“ i”：1}}	{“ $ timestamp”：{“ t”：1565545664，“ i”：1}}

MongoDB 中文手册

MongoDB扩展JSON（v2）

MongoDB扩展JSON v2用法¶

驱动程序¶

MongoDB命令行工具¶

BSON数据类型和关联的表示形式¶

例子¶