mongo extend json
json 只能表示 bson 支持的类型的子集。
为了保留类型信息, mongodb 将以下扩展添加到 json 格式:
- 严格模式。
bson 类型的严格模式表示符合 json rfc。
任何 json 解析器都可以将这些严格的模式表示解析为 key/值对;但是, 只有 mongodb 内部 json 解析器才能识别格式传递的类型信息。
- 蒙戈外壳模式。
mongodb 内部 json 解析器和 mongo shell 可以分析此模式。
用于各种数据类型的表示形式取决于在其中分析 json 的上下文。
Parsers and Supported Format
严格模式下的输入
下面的内容可以在严格模式下分析表示, 并识别类型信息。
-
REST Interfaces
-
mongoimport
-
–query option of various MongoDB tools
-
MongoDB Compass
其他 json 解析器 (包括 mongo shell 和 db.eval ()) 可以将严格模式表示解析为 key/value 对, 但不识别类型信息。
Input in mongo Shell Mode
下面的内容可以在mongo shell 模式下分析表示, 并识别类型信息。
-
REST Interfaces
-
mongoimport
-
–query option of various MongoDB tools
-
mongo shell
严格模式下的输出
在严格模式下输出数据。
Output in mongo Shell Mode
mongo shell 模式下的 bsondump 输出。
BSON Data Types and Associated Representations
下面介绍了 “严格” 模式和 mongo 命令行模式下的 bson 数据类型和关联的表示形式。
Binary
- 严格
{ "$binary": "<bindata>", "$type": "<t>" }
- mongo shell
BinData ( <t>, <bindata> )
<bindata> 是二进制字符串的 base64 表示形式。
<t> 是指示数据类型的单个字节的表示形式。
在严格模式下, 它是一个十六进制字符串, 在命令行管理程序模式下, 它是一个整数。
请参阅扩展 bson 文档。http://bsonspec.org/spec.html
Date
- 严格模式
{ "$date": "<date>" }
- mongo shell 模式
new Date ( <date> )
在严格模式下, <date> 是一种 iso-8601 日期格式, 其时区字段遵循模板 yyyy-mm-ddthh:mm <+/-Offset>。
mongodb json 解析器目前不支持加载表示 unix 时代之前日期的 iso-8601 字符串。
当格式化前世纪日期和日期超过您的系统的时间 _t 类型可以容纳, 使用以下格式:
{ "$date" : { "$numberLong" : "<dateAsMilliseconds>" } }
在 shell 模式下, <date> 是64位带符号整数的 json 表示形式, 给出自世纪 utc 以来的毫秒数。
Timestamp
- 严格模式
{ "$timestamp": { "t": <t>, "i": <i> } }
- mongo shell 模式
Timestamp( <t>, <i> )
Regular Expression
- 严格模式
{ "$regex": "<sRegex>", "$options": "<sOptions>" }
- mongo shell 模式
/<jRegex>/<jOptions>
OID
- Strict Mode
{ "$oid": "<id>" }
- mongo Shell Mode
ObjectId( "<id>" )
<id> 是一个24个字符的十六进制字符串。
DB Reference
- 严格模式
{ "$ref": "<name>", "$id": "<id>" }
- mongo Shell Mode
DBRef("<name>", "<id>")
Undefined Type
- 严格模式
{ "$undefined": true }
- mongo Shell Mode
undefined
未定义类型的表示形式。
不能在查询文档中使用未定义的。请考虑插入到人员集合中的以下文档:
db.people.insert( { name : "Sally", age : undefined } )
下面的操作将返回异常
db.people.find( { age : undefined } )
db.people.find( { age : { $gte : undefined } } )
MinKey
- 严格模式
{ "$minKey": 1 }
- mongo Shell Mode
MinKey
比较低于所有其他类型的 minkey bson 数据类型的表示形式。
有关 bson 类型的比较顺序的详细信息, 请参阅比较排序顺序。
MaxKey
- 严格模式
{ "$maxKey": 1 }
- mongo Shell Mode
MaxKey
比较高于所有其他类型的 maxkey bson 数据类型的表示形式。
有关 bson 类型的比较顺序的详细信息, 请参阅比较排序顺序。
NumberLong
New in version 2.6.
- 严格模式
{ "$numberLong": "<number>" }
- mongo Shell Mode
NumberLong( "<number>" )
数字龙是一个64位带符号的整数。您必须包括引号, 否则它将被解释为浮点数, 从而导致准确性的损失。
例如, 以下命令插入92233736364477807作为一个具有和不带引号的整数值:
db.json.insert( { longQuoted : NumberLong("9223372036854775807") } )
db.json.insert( { longUnQuoted : NumberLong(9223372036854775807) } )
检索文档时, “长” 取消引用 “的值已更改, 而” 长期引用 “保留其准确性:
db.json.find()
{ "_id" : ObjectId("54ee1f2d33335326d70987df"), "longQuoted" : NumberLong("9223372036854775807") }
{ "_id" : ObjectId("54ee1f7433335326d70987e0"), "longUnQuoted" : NumberLong("-9223372036854775808") }
NumberDecimal
New in version 3.4.
- 严格模式
{ "$numberDecimal": "<number>" }
- mongo Shell Mode
NumberDecimal( "<number>" )
数字十进制是一个高精度的十进制。您必须包括引号, 否则输入编号将被视为双引号, 从而导致数据丢失。
例如, 以下命令将123.40 插入为数字十进制, 其值周围有引号和不带引号:
db.json.insert( { decimalQuoted : NumberDecimal("123.40") } )
db.json.insert( { decimalUnQuoted : NumberDecimal(123.40) } )
检索文档时, 抽取的值已更改, 而抽取保留其指定的精度:
db.json.find()
{ "_id" : ObjectId("596f88b7b613bb04f80a1ea9"), "decimalQuoted" : NumberDecimal("123.40") }
{ "_id" : ObjectId("596f88c9b613bb04f80a1eaa"), "decimalUnQuoted" : NumberDecimal("123.400000000000") }
参考资料
https://docs.mongodb.com/manual/reference/mongodb-extended-json/
