对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

创建、查看、更新和删除文档

可以使用 Atlas UI 管理集合中的文档。文档是 MongoDB 集合中的单个记录,同时也是 MongoDB 中的基本数据单位。

在 Atlas UI 中查看文档和集合可以提供数据库模式的高级概述。您可以使用 Atlas UI 确保遵循 MongoDB 的核心数据建模概念,例如利用嵌入式文档和数组。

要插入、编辑或删除文档,您必须通过以下角色获得访问权限:

要通过 Atlas UI 向集合中添加一个或多个文档,可以从头开始指定要插入的文档,也可以克隆现有文档,然后根据需要修改其中的字段和值。

要将文档插入集合,请在Atlas中使用以下方法之一:

  • shell 语法模式:写入或粘贴文档,使用 MongoDB shell 语法,该语法允许使用未加引号的字段名称和类型构造函数,例如 ObjectId() 和 ISODate()。使用此模式可将多个文档作为一个数组同时插入。

  • 逐字段编辑器:对于每个插入的文档,选择各自的字段值和类型。使用此方法,您一次只能插入一个文档。

  • JSON Mode: Write or paste documents in Extended JSON format, which requires quoted field names and represents BSON types as wrappers such as {"$oid": "..."}. Use this mode to insert multiple documents at once as an array.

1
  1. 如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。

  2. 如果尚未显示,请从导航栏的Projects菜单中选择所需的项目。

  3. 在侧边栏中,单击 Database 标题下的 Clusters。

会显示集群页面。

2
  1. 如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含项目的组织。

  2. 如果尚未显示,请从导航栏的 Projects 菜单中选择您的项目。

  3. 在侧边栏中,单击 Database 标题下的 Data Explorer。

    The Data Explorer displays.

重要提示:您还可以单击集群的名称以打开 Cluster侧边栏,然后单击Data Explorer Shortcuts标题下的 。

3

在下拉菜单中单击 Insert Document(复制视图)。

或者,您可以右键单击查询栏或其周围的空格,然后从下拉菜单中选择 Insert document...。

4

In the Insert Document modal, click the icon to use Shell Syntax mode to insert documents into your collection.

Shell Syntax 模式是默认视图。

5

在 MongoDB shell 语法中,键入或粘贴要插入到集合中的文档。要插入多个文档,请输入以逗号分隔的文档数组。

例子

以下示例将单个文档插入到集合中。字段名称不加引号,_id、copies 和 lastCheckedOut 值使用 ObjectId()、NumberInt() 和 ISODate() 类型构造函数,而不是 Extended JSON 类型包装器:

{
_id: ObjectId('507f1f77bcf86cd799439011'),
title: 'The Odyssey',
author: 'Homer',
copies: NumberInt('10'),
lastCheckedOut: ISODate('2025-03-14T09:30:00Z')
}

注意

If you do not specify an _id value in your document, Atlas automatically generates an ObjectId for the _id field.

6

可以通过克隆集合中现有文档的架构和值来插入新文档。

要克隆文档,请将鼠标悬停在所需文档上,然后单击 Clone 按钮。

“克隆”按钮
点击放大

当您单击 Clone 按钮时, Atlas会打开文档插入对话框,其模式和值与克隆的文档相同。在插入新文档之前,您可以编辑这些字段和值。

要查看和管理文档,您可以使用 Documents标签页中的以下视图之一:

  • 列表视图:默认文档视图。Atlas 显示文档列表。在该视图中,您可以展开嵌入式对象和数组。

  • JSON 视图:Atlas 将文档显示为格式正确的 JSON 对象。Atlas 使用扩展 JSON 来显示每个字段的数据类型。

  • 表格视图:Atlas 将文档显示为表格的行,文档字段显示在表格的列中。 通过该视图,您可以查看哪些文档包含特定字段值。

要展开嵌入式对象和大量元素,请将鼠标悬停在文档上,然后单击左上角的箭头。

展开嵌入式对象列表
点击放大

要将文档复制到剪贴板,请将鼠标悬停在文档上,然后单击复制 Copy 图标:

从列表视图中复制文档
点击放大

Atlas UI 限制每页显示的文档的总字节大小。因此,您可能会在每页看到不同数量的文档,尤其是当文档大小差异很大时。

When you edit a document in List or Table view, Atlas performs a findOneAndUpdate operation and updates only those fields that you have changed.

当您在JSON视图中编辑文档时, Atlas会执行findOneAndReplace操作并替换文档。

要修改文档,请将鼠标悬停在文档上,然后单击铅笔图标:

文档编辑选项
点击放大

单击铅笔图标后,文档将进入编辑模式。现在,您可以更改字段、值或值的数据类型。

要从文档中删除字段,请单击字段左侧的 图标:

文档删除
点击放大

选择后,该字段将被标记为删除,并以红色突出显示。Atlas要求您确认您要通过删除字段更新文档。

要在文档中的现有字段之后添加新字段,请将鼠标悬停在对话框中的行号上,然后单击加号。行号不是文档的一部分,而是对话框显示内容的一部分。

向文档添加字段
点击放大

当文本光标位于最后一个文档字段的值上时,您还可以按 Tab 键在文档末尾添加新字段。

要修改字段,请单击现有字段名称或值并进行更改。在此示例中,borough 从 Manhattan 更改为 Queens。更改的字段以黄色突出显示:

文档更新视图
点击放大

When you edit a document in List or Table view, Atlas performs a findOneAndUpdate operation and updates only those fields that you have changed.

如果Atlas检测到您更改了在Atlas外部修改的字段,它会通知您,防止您意外覆盖在Atlas外部所做的更改。您可以选择继续并单击 Replace 替换文档,也可以取消更改。

完成文档编辑后,单击 Update 按钮提交更改。

要恢复对文档的更改,请将鼠标悬停在已编辑字段上,然后单击字段行号左侧显示的 revert icon。

在列表视图中还原文档

您可以使用批量更新操作工作流程在Atlas中更新多个文档。有关详细信息,请参阅修改多个文档。

要通过 Atlas 用户界面从集合中删除文档:

要删除文档,请将鼠标悬停在文档上,然后单击 图标。

列表视图中的删除按钮
点击放大

单击删除按钮后,文档将被标记为删除。Atlas要求确认您要删除文档。

确认后, Atlas将从集合中删除该文档。