Documents文件

Field Name字段名称s

Field names are strings.字段名称是字符串。

Documents文件 have the following restrictions on field names:对字段名称有以下限制：

• The field name _id is reserved for use as a primary key; its value must be unique in the collection, is immutable, and may be of any type other than an array. 字段名称_id被保留用作主键；它的值在集合中必须是唯一的，是不可变的，并且可以是数组以外的任何类型。If the _id contains subfields, the subfield names cannot begin with a ($) symbol.如果_id包含子字段，则子字段名称不能以（$）符号开头。

• Field names cannot contain the null character.字段名称不能包含null字符。
• The server permits storage of field names that contain dots (.) and dollar signs ($).服务器允许存储包含点（.）和美元符号（$）的字段名。
• MongodB 5.0 adds improved support for the use of ($) and (.) in field names. MongodB 5.0增加了对字段名称中使用（$）和（.）的改进支持。There are some restrictions. 有一些限制。See Field Name Considerations for more details.有关更多详细信息，请参阅字段名称注意事项。

BSON documents may have more than one field with the same name. BSON文档可能有多个具有相同名称的字段。Most MongoDB interfaces, however, represent MongoDB with a structure (e.g. a hash table) that does not support duplicate field names. 然而，大多数MongoDB接口使用不支持重复字段名的结构（例如哈希表）来表示MongoDB。If you need to manipulate documents that have more than one field with the same name, see the driver documentation for your driver.如果需要操作具有多个同名字段的文档，请参阅驱动程序的驱动程序文档。

Some documents created by internal MongoDB processes may have duplicate fields, but no MongoDB process will ever add duplicate fields to an existing user document.内部MongoDB进程创建的一些文档可能有重复的字段，但任何MongoDB进程都不会向现有用户文档添加重复的字段。

Field Value Limit字段值限制

MongoDB 2.6 through MongoDB versions with featureCompatibilityVersion (fCV) set to "4.0" or earlierMongoDB 2.6至MongoDB版本，featureCompatibilityVersion（fCV）设置为“4.0”或更早版本

For indexed collections, the values for the indexed fields have a Maximum Index Key Length. See Maximum Index Key Length for details.对于索引集合，索引字段的值具有最大索引键长度。有关详细信息，请参阅最大索引键长度。

Arrays数组

To specify or access an element of an array by the zero-based index position, concatenate the array name with the dot (.) and zero-based index position, and enclose in quotes:要通过从零开始的索引位置指定或访问数组的元素，请将数组名称与点（.）和从零开始索引位置连接起来，并用引号括起来：

"<array>.<index>"

For example, given the following field in a document:例如，给定文档中的以下字段：

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

To specify the third element in the contribs array, use the dot notation "contribs.2".要指定contribs数组中的第三个元素，请使用点号"contribs.2"。

For examples querying arrays, see:有关查询数组的示例，请参阅：

• Query an Array查询数组
• Query an Array of Embedded Documents查询嵌入文档的数组

Embedded Documents嵌入式文档

To specify or access a field of an embedded document with dot notation, concatenate the embedded document name with the dot (.) and the field name, and enclose in quotes:要使用句点表示法指定或访问嵌入文档的字段，请将嵌入文档名称与句点（.）和字段名称连接起来，并用引号括起来：

"<embedded document>.<field>"

For example, given the following field in a document:例如，给定文档中的以下字段：

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

• To specify the field named last in the name field, use the dot notation "name.last".要指定name字段中命名字段last，请使用点表示法"name.last"。
• To specify the number in the phone document in the contact field, use the dot notation "contact.phone.number".要在contact字段中指定phone文档中的number，请使用点表示法"contact.phone.number"。

For examples querying embedded documents, see:有关查询嵌入文档的示例，请参阅：

• Query on Embedded/Nested Documents查询嵌入/嵌套文档
• Query an Array of Embedded Documents查询嵌入文档的数组

Document Size Limit文档大小限制

The maximum BSON document size is 16 megabytes.BSON文档的最大大小为16兆字节。

The maximum document size helps ensure that a single document cannot use excessive amount of RAM or, during transmission, excessive amount of bandwidth. 最大文档大小有助于确保单个文档不会使用过多的RAM，或者在传输过程中不会使用过大的带宽。To store documents larger than the maximum size, MongoDB provides the GridFS API. 为了存储大于最大大小的文档，MongoDB提供了GridFSneneneba API。See mongofiles and the documentation for your driver for more information about GridFS.有关GridFS的更多信息，请参阅mongofiles和驱动程序的文档。

Document Field Order文档字段顺序

Unlike JavaScript objects, the fields in a BSON document are ordered.与JavaScript对象不同，BSON文档中的字段是按顺序排列的。

The _id Field_id字段

In MongoDB, each document stored in a collection requires a unique _id field that acts as a primary key. 在MongoDB中，存储在集合中的每个文档都需要一个唯一的_id字段作为主键。If an inserted document omits the _id field, the MongoDB driver automatically generates an ObjectId for the _id field.如果插入的文档省略了_id字段，MongoDB驱动程序会自动为_id字段生成一个ObjectId。

This also applies to documents inserted through update operations with upsert: true.这也适用于通过upsert:true的更新操作插入的文档。

The _id field has the following behavior and constraints:_id字段具有以下行为和约束：

• By default, MongoDB creates a unique index on the _id field during the creation of a collection.默认情况下，MongoDB在创建集合的过程中会在_id字段上创建一个唯一的索引。
• The _id field is always the first field in the documents. _id字段始终是文档中的第一个字段。If the server receives a document that does not have the _id field first, then the server will move the field to the beginning.如果服务器首先接收到一个没有_id字段的文档，那么服务器将把该字段移到开头。

If the _id contains subfields, the subfield names cannot begin with a ($) symbol.如果_id包含子字段，则子字段名称不能以（$）符号开头。

• The _id field may contain values of any BSON data type, other than an array, regex, or undefined._id字段可以包含除数组、正则表达式或未定义之外的任何BSON数据类型的值。
  Warning

  To ensure functioning replication, do not store values that are of the BSON regular expression type in the _id field.为确保复制正常运行，请不要在_id字段中存储BSON正则表达式类型的值。

The following are common options for storing values for _id:以下是用于存储_id值的常见选项：

• Use an ObjectId.使用ObjectId。
• Use a natural unique identifier, if available. 如果可用，请使用自然的唯一标识符。This saves space and avoids an additional index.这样可以节省空间并避免额外的索引。
• Generate an auto-incrementing number.生成一个自动递增的数字。
• Generate a UUID in your application code. 在应用程序代码中生成UUID。For a more efficient storage of the UUID values in the collection and in the _id index, store the UUID as a value of the BSON BinData type.为了在集合和_id索引中更有效地存储UUID值，请将UUID存储为BSON BinData类型的值。

  Index keys that are of the BinData type are more efficiently stored in the index if:如果出现以下情况，BinData类型的索引键将更有效地存储在索引中：

  • the binary subtype value is in the range of 0-7 or 128-135, and二进制子类型值在0-7或128-135的范围内，并且
  • the length of the byte array is: 0, 1, 2, 3, 4, 5, 6, 7, 8, 10, 12, 14, 16, 20, 24, or 32.字节数组的长度为：0、1、2、3、4、5、6、7、8、10、12、14、16、20、24或32。
• Use your driver's BSON UUID facility to generate UUIDs. 使用驾驶员的BSON UUID功能生成UUID。Be aware that driver implementations may implement UUID serialization and deserialization logic differently, which may not be fully compatible with other drivers. 请注意，驱动程序实现可能以不同的方式实现UUID序列化和反序列化逻辑，这可能与其他驱动程序不完全兼容。See your driver documentation for information concerning UUID interoperability.有关UUID互操作性的信息，请参阅驱动程序文档。

Query Filter Documents查询筛选文档

Query filter documents specify the conditions that determine which records to select for read, update, and delete operations.查询筛选文档指定条件，这些条件决定要选择哪些记录进行读取、更新和删除操作。

You can use <field>:<value> expressions to specify the equality condition and query operator expressions.您可以使用<field>:<value>表达式来指定相等条件和查询运算符表达式。

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

For examples, see:有关示例，请参阅：

• Query Documents查询文档
• Query on Embedded/Nested Documents查询嵌入/嵌套文档
• Query an Array查询数组
• Query an Array of Embedded Documents查询嵌入文档的数组

Update Specification Documents更新规范文档

Update specification documents use update operators to specify the data modifications to perform on specific fields during an update operation.更新规范文档使用更新运算符指定在更新操作期间要对特定字段执行的数据修改。

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

For examples, see Update specifications.有关示例，请参阅更新规范。

Index Specification Documents索引规范文件

Index specification documents define the field to index and the index type:索引规范文档定义了要索引的字段和索引类型：

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