当前位置：首页 > news >正文

MongoDB Integer

news 2025/9/20 5:51:41

核心概念：存储层 (BSON) vs. 交互层 (Mongo Shell)

要理解这个问题，你必须区分两件事：

MongoDB 的存储格式 (BSON): 这是数据实际在硬盘上存储的方式。在 BSON 规范中，整数类型被明确地分为两种：
- Int32: 32位有符号整数。
- Int64: 64位有符号整数。
你与 MongoDB 交互的方式 (Mongo Shell): 当你打开 mongosh 或旧的 mongo 命令行时，你进入的是一个 JavaScript 环境。JavaScript 语言本身在设计上没有独立的整数类型。它只有一种数字类型：Number，这是一个64位双精度浮点数（Double）。

这个区别就是所有困惑的根源。MongoDB 底层可以清晰地区分32位和64位整数，但你用来操作它的工具（Mongo Shell）默认情况下并不区分。

那么，到底能存多大的数据？

这取决于你希望数据以哪种 BSON 类型存储。

1. 32位整数 (`Int32`)

存储范围: 从 -2,147,483,648 到 2,147,483,647 (大约正负21亿)。
如何存入: 当你在 Mongo Shell 中输入一个在此范围内的整数时，MongoDB 会自动选择 Int32 类型来存储它，因为这是最高效的方式。
```
// 这个 age 会被存储为 BSON Int32 类型
db.users.insertOne({ name: "张三", age: 30 })
```

2. 64位整数 (`Int64`)

存储范围: 从 -9,223,372,036,854,775,808 到 9,223,372,036,854,775,807 (一个非常巨大的数字)。

如何存入 (重点！): 因为 Mongo Shell 默认使用浮点数，如果你直接输入一个超过32位范围的大整数，它默认会被存为 Double (浮点数)类型，而不是 Int64！

// 警告：这个 large_number 默认会被存储为 Double 类型，而不是 Int64！
db.stats.insertOne({ event_id: 3000000000 })
```这可能会导致精度问题或类型不匹配的查询问题。**正确的做法是，你必须显式地告诉 MongoDB 你想要存储一个64位整数。** 你需要使用 `NumberLong()` 这个辅助函数。```javascript
// 正确的方式：使用 NumberLong() 来指定存储为 BSON Int64 类型
db.stats.insertOne({ event_id: NumberLong("3000000000") })// 或者对于较小的数字，也可以这样写
db.inventory.insertOne({ quantity: NumberLong(500) })

解读 “根据你所采用的服务器”

这句话在现代MongoDB环境中已经不太准确了。现在可以理解为：

“MongoDB 支持 32位和64位两种整数类型，但你存入的数据具体是哪种类型，取决于你插入的数值大小以及你所使用的客户端/驱动程序（比如Mongo Shell）如何处理它。”

现代的MongoDB服务器（无论是32位还是64位操作系统上运行的）都完全支持 BSON 的 Int32 和 Int64。关键在于你作为开发者，如何清晰地表达你的意图。

总结与最佳实践

BSON 类型	范围	如何在 Mongo Shell 中插入	关键点
Int32	约 ±21 亿	直接输入整数 `123`	MongoDB 自动选择，是默认的小整数类型。
Double	(浮点数)	直接输入小数 `123.45` 或超过 `Int32` 范围的整数 `3000000000`	注意！大整数默认会变成浮点数。
Int64	约 ±9 x 10¹⁸	必须使用 `NumberLong("...")`	存储大整数（如ID、计数器、时间戳）的标准方式。