[mongo] 1.3 Documents（文档）

Field名称

Field名称是字符串。

文档对字段名称有以下限制：

• 字段名称_id保留用作主键；它的值在集合中必须是唯一的，不可变的，并且可以是数组以外的任何类型。

• 字段名称不能包含null字符。

• 顶级字段名称不能以美元符号（$）字符开头。

  否则，从MongoDB 3.6开始，服务器允许存储包含点（即.）和美元符号（即 $）的字段名称。

  重要

  MongoDB查询语言不能总是有效地表达对字段名称包含这些字符的文档的查询（请参阅SERVER-30575）。

  尽管支持在查询语句中添加$和 .，MongoDB的官方驱动程序不推荐也不支持在字段名称使用$和 .。

BSON文档可能有多个具有相同名称的字段。但是，大多数MongoDB接口使用不支持重复字段名称的结构（例如，哈希表）来表示MongoDB。如果需要处理具有多个同名字段的文档，请参见驱动程序的驱动程序文档。

通过内部的MongoDB进程创建的有些文件可能有重复的字段，但是没有MongoDB进程会不断地添加重复字段到现有的用户文档。

字段值限制

MongoDB 2.6至MongoDB版本，并将featureCompatibilityVersion（fCV）设置为"4.0"或更早版本

对于索引集合，索引字段的值有一个。有关详细信息，请参见 。Maximum Index Key LengthMaximum Index Key Length

数组（arrays）

要通过从零开始的索引位置指定或访问数组的元素，请将数组名称与点（.）和从零开始的索引位置连接起来，并用引号引起来：

"<array>.<index>" 

例如，给定文档中的以下字段：

{
   ...
   contribs: [ "Turing machine", "Turing test", "Turingery" ],
   ...
} 

要指定contribs数组中的第三个元素，请使用点符号"contribs.2"。

有关查询数组的示例，请参见：

• 查询数组
• 查询嵌入式文档数组

嵌入式文件

要使用点符号指定或访问嵌入式文档的字段，请将嵌入式文档名称与点（.）和字段名称连接在一起，并用引号引起来：

"<embedded document>.<field>" 

例如，给定文档中的以下字段：

{
   ...
   name: { first: "Alan", last: "Turing" },
   contact: { phone: { type: "cell", number: "111-222-3333" } },
   ...
} 

• 要指定在字段中命名last的name字段，请使用点符号"name.last"。
• 要在在phone文档中contact字段的number，请使用点号"contact.phone.number"。

有关查询嵌入式文档的示例，请参见：

• 查询嵌入/嵌套文档
• 查询嵌入式文档数组

文件大小限制

BSON文档的最大大小为16 MB。

最大文档大小有助于确保单个文档不会使用过多的RAM或在传输过程中占用过多的带宽。要存储大于最大大小的文档，MongoDB提供了GridFS API。有关GridFS的更多信息，请参见mongofiles和驱动程序的文档。

文档字段顺序

除以下情况外，MongoDB会在执行写操作后保留文档字段的顺序：

• 该_id字段始终是文档中的第一个字段。
• 包含renaming字段名称的更新可能会导致文档中字段的重新排序。

_id段

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

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

_id字段具有以下特性和约束：

• 默认情况，MongoDB_id在创建集合期间会在字段上创建唯一索引。

• _id字段始终是文档中的第一个字段。如果服务器首先接收到没有该_id字段的文档，则服务器会将字段移到开头。

• _id字段可以包含除数组以外的任何BSON数据类型的值。

  警告

  为确保复制正常进行，务必在_id 字段中存储BSON正则表达式类型的值。

以下是用于存储的值的常用选项_id：

• 使用一个ObjectId。

• 使用自然的唯一标识符（如果有）。这样可以节省空间并避免附加索引。

• 生成一个自动递增的数字。

• 在您的应用程序代码中生成一个UUID。为了在集合和_id 索引中更有效地存储UUID值，请将UUID存储为BSONBinData类型的值。

  在以下情况下，BinData更有效地将类型为索引的键存储在索引中：

  • 二进制子类型的值在0-7或128-135的范围内，并且
  • 字节数组的长度为：0、1、2、3、4、5、6、7、8、10、12、14、16、20、24或32。

• 使用驱动程序的BSON UUID工具生成UUID。请注意，驱动程序实现可能会以不同的方式实现UUID序列化和反序列化逻辑，这可能与其他驱动程序不完全兼容。请参阅您的驱动程序文档，以获取有关UUID互操作性的信息。

查询过滤器

查询过滤器文档指定确定用于选择哪些记录以进行读取，更新和删除操作的条件。

您可以使用<field>:<value>表达式来指定相等条件和查询运算符 表达式。

{
  <field1>: <value1>,
  <field2>: { <operator>: <value> },
  ...
}

有关示例，请参见：

• 查询文件
• 查询嵌入/嵌套文档
• 查询数组
• 查询嵌入式文档数组

更新规范文件

更新规范文档使用更新运算符来指定要在db.collection.update()操作期间在特定字段上执行的数据修改。

{
  <operator1>: { <field1>: <value1>, ... },
  <operator2>: { <field2>: <value2>, ... },
  ...
} 

有关示例，请参阅更新规范。

索引规范文档

索引规范文档定义了要索引的字段和索引类型：

{ <field1>: <type1>, <field2>: <type2>, ...  }