BSON类型
在本页面
BSON是一种二进制序列化格式，用于在MongoDB中存储文档和进行远程过程调用。BSON规范位于 bsonspec.org。
每种BSON类型都具有整数和字符串标识符，如下表所示：
| 类型 Type | 对应数字 Number | 别名 Alias | 备注 Notes |
|---|---|---|---|
| 双精度浮点型Double | 1 | “double” | |
| 字符串String | 2 | “string” | |
| 对象Object | 3 | “object” | |
| 数组Array | 4 | “array” | |
| 二进制数据Binary data | 5 | “binData” | |
| 未定义Undefined | 6 | “undefined” | 不推荐使用。 |
| 对象编号ObjectId | 7 | “objectId” | |
| 布尔型Boolean | 8 | “bool” | |
| 日期Date | 9 | “date” | |
| 空值Null | 10 | “null” | |
| 正则表达式Regular Expression | 11 | “regex” | |
| DBPointer | 12 | “dbPointer” | 不推荐使用。 |
| JavaScript | 13 | “javascript” | |
| Symbol | 14 | “symbol” | 不推荐使用。 |
| JavaScript (带范围) | 15 | “javascriptWithScope” | |
| 32位整数 32-bit integer | 16 | “int” | |
| 时间戳 Timestamp | 17 | “timestamp” | |
| 64位整数 64-bit integer | 18 | “long” | |
| 小数128 Decimal128 | 19 | “decimal” | 3.4版的新功能。 |
| 最小键 Min key | -1 | “minKey” | |
| 最大键 Max key | 127 | “maxKey” |
$type操作符支持使用这些值按BSON类型查询字段。$type还支持数字别名，它匹配整数、十进制、双精度和长BSON类型。$type聚合运算符返回其参数的BSON类型如果
$isNumber聚合运算符的参数是BSON整数、十进制、双精度或长值，则返回true。4.4新版功能.要确定字段的类型，请参见Type Checking.。
如果要将BSON转换为JSON，请参阅Extended JSON。
以下部分描述了特定BSON类型的特殊注意事项。
二进制数据
BSON二进制binData值是一个字节数组。binData值具有指示如何解释二进制数据的子类型。下表显示了子类型。
| Number | 子类型 |
|---|---|
| 0 | 泛型二进制子类型 |
| 1 | Function data |
| 2 | 二进制(旧) |
| 3 | UUID (旧) |
| 4 | UUID |
| 5 | MD5 |
| 6 | 加密后的BSON值 |
| 7 | 压缩时间序列数据(5.2版本新功能) |
| 128 | 自定义数据 |
ObjectId
ObjectId很小，可能唯一，可以快速生成并有序。ObjectId值的长度为12个字节，包括：
- 一个
4字节的时间戳记值，代表自Unix时代以来以秒为单位的ObjectId的创建 - 每个进程生成一次的
5字节随机值。这个随机值对于机器和过程是唯一的 3字节递增计数器，初始化为随机值
虽然BSON格式本身是低位优先的，但时间戳和 计数器值却是高位优先的，最高有效字节在字节序列中排在最前面。
如果使用整数值创建ObjectId，则该整数值将替换时间戳。
在MongoDB中，存储在集合中的每个文档都需要一个唯一的 _id字段作为主键。如果插入的文档省略了该_id字段，则MongoDB驱动程序会自动为该字段生成一个ObjectId_id。
这也适用于通过upsert：true通过更新操作插入的文档。
MongoDB客户端应添加一个_id具有唯一ObjectId 的字段。在该_id字段中使用ObjectIds 还可以带来以下好处：
在
mongosh中，你可以使用ObjectId.getTimestamp()方法访问ObjectId的创建时间在存储
ObjectId值的_id字段上按大致相当于创建时间进行排序。**重要** 尽管[ObjectId](https://docs.mongodb.com/v4.2/reference/bson-types/objectid)值应随时间增加，但不一定是单调的。这是因为他们： 1. 仅包含一秒的时间分辨率，因此 在同一秒内创建的[ObjectId](https://docs.mongodb.com/v4.2/reference/bson-types/objectid)值没有保证的顺序，并且 2. 由客户端生成，客户端可能具有不同的系统时钟。
也可以看看
字符串
BSON字符串为UTF-8。通常，在对BSON进行序列化和反序列化时，每种编程语言的驱动程序都会从该语言的字符串格式转换为UTF-8。这样就可以轻松地将大多数国际字符存储在BSON字符串中。此外，MongoDB $regex查询在正则表达式字符串中支持UTF-8。
给定使用UTF-8字符集的sort()字符串，在字符串上使用将是合理正确的。但是，由于内部 sort()使用C ++ strcmpAPI，因此排序顺序可能会错误地处理某些字符。 |
|
|---|---|
时间戳
BSON有一个特殊的时间戳类型给MongoDB内部使用，而非常规相关的日期 类型。此内部时间戳记类型是64位值，其中：
- 最重要的32位是一个
time_t值（自Unix时代以来的秒数） - 最低有效32位是
ordinal给定秒内的操作增量。
虽然BSON格式是低位优先的，因此首先存储了最低有效位，但是无论字节序如何，在所有平台上mongod实例始终将time_t值与ordinal值比较。
在单个mongod实例中，时间戳记值始终是唯一的。
在复制中，操作日志具有一个ts字段。该字段中的值反映了使用BSON时间戳值的操作时间。
注意
BSON时间戳类型供MongoDB*内部* 使用。在大多数情况下，在应用程序开发中，您将需要使用BSON日期类型。有关更多信息，请参见[日期](https://docs.mongodb.com/v4.2/reference/bson-types/document-bson-type-date)。
当插入包含带有空时间戳值的顶级字段的文档时，MongoDB会将空时间戳值替换为当前时间戳值，但以下情况除外。如果_id 字段本身包含空的时间戳记值，则将始终按原样插入而不替换它。
示例
插入带有空时间戳值的文档：
db.test.insertOne( { ts: new Timestamp() } );
运行db.test.find() 然后将返回类似于以下内容的文档：
{ "_id" : ObjectId("542c2b97bac0595474108b48"), "ts" : Timestamp(1412180887, 1) }
服务器已使用插入时的时间戳值替换了ts的空时间戳值。
数据
BSON Date是一个64位整数，代表自Unix纪元（1970年1月1日）以来的毫秒数。这导致可以追溯到过去和未来约2.9亿年的日期范围。
该官方BSON规范 指的是BSON Date类型为UTC日期时间。
BSON日期类型是有符号整数。负值表示1970年之前的日期。
示例
在 mongo shell中使用构造函数 new Date() 构造一个Date ：
var mydate1 = new Date()
示例
在 mongo shell中使用构造函数ISODate()构造一个Date ：
var mydate2 = ISODate()
示例
以字符串形式返回Date值：
mydate1.toString()
示例
返回日期值的月份部分；月是零索引，因此一月是0月：
mydate1.getMonth()
在2.0版之前，Date值被错误地解释为无符号整数，这会影响排序，范围查询和Date字段索引。由于升级时不会重新创建索引，因此，如果您早期版本使用Date值创建了索引，请对与应用相关的、1970年前的日期进行重新索引。 |
|
|---|---|
原文链接：https://www.mongodb.com/docs/v6.0/reference/bson-types/
译者：杨帅