BSON类型

二进制数据

BSON 二进制binData值是字节数组。 binData值有一个子类型，用于指示如何解释二进制数据。 下表显示了子类型：

ObjectId

ObjectId（对象标识符）很小，可能是唯一的，生成速度快并且是有序的。ObjectId 值的长度为 12 个字节，包含：

• 一个 4 字节时间戳，它表示 ObjectId 的创建时间，并以自 UNIX 纪元以来的秒数为单位进行测量。

• 每个进程会生成一次 5 字节随机值。这个随机值对于机器和进程是唯一的。

• 三字节递增计数器（初始化为随机值）。

对于时间戳和计数器值，最高有效字节在字节序列中最先出现（大端字节序）。对于其他 BSON 值，最低有效字节最先出现（小端字节序）。

如果使用整数值创建对象标识符（ObjectId），则该整数将替换时间戳。

在MongoDB中，存储在标准集合中的每个文档都需要一个唯一的_id字段作为主键。如果插入的文档省略了_id 字段，则MongoDB驾驶员会自动为 _id字段生成 ObjectId。

这也适用于通过执行 upsert: true 的更新操作插入的文档。

MongoDB 客户端应添加一个具有唯一 ObjectId 的 _id 字段。为 _id 字段使用 ObjectId 还能带来以下好处：

• 您可以使用 ObjectId.getTimestamp() 方法访问 mongosh 中的 ObjectId 创建时间。

• ObjectID 大致按创建时间排序，但并非完全有序。在包含 ObjectId 值的 _id 字段上对集合排序，大致相当于按创建时间排序。

  重要

  虽然 ObjectId 值会随着时间的推移而增加，但它们不一定是单调的。这是因为它们：

  • 仅有一秒的时间分辨率，因此在同一秒内创建的 ObjectId 值不能保证顺序，并且

  • 由可能具有不同系统时钟的客户端生成。

使用 ObjectId() 方法可设置和检索 ObjectId 值。

从 MongoDB 5.0 开始，mongosh 将取代旧版的 mongo shell。ObjectId() 方法在 mongosh 中的运行方式与在旧版的 mongo shell 中的运行方式不同。有关旧版方法的更多信息，请参阅旧版的 mongo Shell。

字符串

BSON 字符串是 UTF-8 编码。通常，在序列化和反序列化 BSON 时，每种编程语言的驱动程序会从该语言的字符串格式转换为 UTF-8。这样就可以在 BSON 字符串中轻松存储大多数国际字符。[1]此外，MongoDB$regex 查询支持在正则表达式字符串中使用 UTF-8。

时间戳

BSON 具一种特殊的时间戳类型，供 MongoDB 内部使用，与常规的 Date 类型无关。此内部时间戳类型是 64 位值，其中：

• 最高的 32 位有效位则是 time_t 值（自 UNIX 纪元以来的秒数）

• 对于给定秒内的操作，最低有效的 32 位是递增的 ordinal。

虽然 BSON 格式是小端字节序，因此首先存储最低有效位，但在所有平台上，mongod 实例始终先比较 time_t 值，然后再比较 ordinal 值，不受字节序的影响。

在复制中，oplog 有一个 ts 字段。该字段的值反映利用 BSON 时间戳值确定的操作时间。

在单个 mongod 实例中，oplog 中的时间戳值总是唯一的。

Date

“BSON Date”（BSON 日期）是一个 64 位整数，它表示自 UNIX 纪元（1970 年 1 月 1 日）以来的毫秒数。因此，过去与未来的可表示日期范围便可达到约 2.9 亿年。

官方 BSON 规范将 BSON 日期类型称为 UTC 日期时间。

BSON Date 类型为有符号值。[2] 负值代表 1970 年之前的日期。

要在 mongosh 中构造 Date，您可以使用 new Date() 或 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 BSON数据类型

decimal128 是 128 位十进制表示形式，用于在四舍五入很重要的情况下存储非常大或非常精确的数字。它创建于 2009 8 月，作为 IEEE 754-2008 浮点修订版的一部分。使用BSON数据类型时如果需要高精度，则应使用 decimal128。

decimal128 支持 34 位十进制数的精度或有效数以及 -6143 到 +6144 的指数范围。有效数在 decimal128 标准中未进行规范化，从而允许有多种可能的表示形式：10 x 10^-1 = 1 x 10^0 = .1 x 10^1 = .01 x 10^2 等。能力分别以 10^6144 和 10^-6143 的顺序存储最大值和最小值，从而允许精度很高。

NumberDecimal("9823.1297")

NumberDecimal(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