Docs 菜单
Docs 主页
/
Atlas
/

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

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

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

提示

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

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

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

  • JSON模式 :icon-lg:`CurlyBraces` :允许您在编辑器中写入或粘贴JSON文档。使用此模式可将多个文档作为一个大量同时插入。

  • Field-by-Field Editor:icon-lg:`Menu`:允许您为每个插入的文档选择单独的字段值和类型。使用此方法一次只能插入一个文档。

1

警告

导航改进正在进行中

我们目前正在推出改进的全新导航体验。如果以下步骤与Atlas用户界面中的视图不匹配,请参阅预览文档。

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

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

  3. 如果尚未出现,请单击侧边栏中的 Clusters(集群)。

    会显示集群页面。

2

单击集群的对应 Browse Collections 按钮。

显示数据浏览器

3

在下拉菜单中,选择 Insert Document

文档编辑器将显示,其中包含 _id字段,其中包含一个ObjectId 值,该值反映文档的创建时间,而不是插入时间。因此,ObjectId 并不代表严格的插入顺序。

4

输入或粘贴要插入到集合中的文档。要插入多个文档,请输入以逗号分隔的JSON文档大量。

示例,以下大量将 5 文档插入到集合中:

[
{ "_id" : 8752, "title" : "Divine Comedy", "author" : "Dante", "copies" : 1 },
{ "_id" : 7000, "title" : "The Odyssey", "author" : "Homer", "copies" : 10 },
{ "_id" : 7020, "title" : "Iliad", "author" : "Homer", "copies" : 10 },
{ "_id" : 8645, "title" : "Eclogues", "author" : "Dante", "copies" : 2 },
{ "_id" : 8751, "title" : "The Banquet", "author" : "Dante", "copies" : 2 }
]
5
1

警告

导航改进正在进行中

我们目前正在逐步推出改进的全新导航体验。如果以下步骤与您在 Atlas UI 中的视图不符,请参阅预览文档

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

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

  3. 如果尚未出现,请单击侧边栏中的 Clusters(集群)。

    会显示集群页面。

2

单击集群的对应 Browse Collections 按钮。

显示数据浏览器

3

在下拉菜单中,选择 Insert Document

文档编辑器将显示,其中包含 _id字段,其中包含一个ObjectId 值,该值反映文档的创建时间,而不是插入时间。因此,ObjectId 并不代表严格的插入顺序。

4

在文档编辑器中,单击 View 切换开关中的 图标。

5

要添加新字段,请将鼠标悬停在现有字段的字段行号上,然后单击图标。

6

对于文档中的每个字段,填写字段名称,设立字段值,然后选择字段类型。

注意

要将 _id字段更改为自定义值,请将字段类型从 ObjectId 更改为 string。然后,您可以覆盖 _id 值。

7

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

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

“克隆”按钮
点击放大

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

“克隆”按钮JSON
点击放大

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

“克隆”按钮“表”视图
点击放大

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

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

  • 列表视图 :icon-lg:`Menu` :默认文档视图。Atlas以列表形式显示文档。在此视图中,您可以展开嵌入式对象和数组。

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

  • 表视图 :icon-lg:`Table` : Atlas将文档显示为表的行,文档字段显示在表的列中。使用此视图,您可以查看哪些文档包含特定字段值。

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

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

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

要展开单个对象和数组,请单击所需字段左侧的箭头。

展开嵌入式对象 JSON
点击放大

要查看嵌套对象字段和数组元素,请将游标悬停在值类型为ObjectArray的字段上,然后单击该字段右侧显示的带有向外箭头的按钮。

Atlas在与嵌套元素对应的表视图中打开一个新标签页。

在表视图中查看嵌套元素
点击放大

以下示例显示嵌套在 restaurants 集合文档中的 address 对象。新标签页显示 address 对象的五个属性:

嵌套文档
点击放大

要返回到原始表显示,请单击表视图中显示集合名称的第一个标签页。

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

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

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

从 JSON 视图复制文档
点击放大

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

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

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

当您在列表视图或表视图中编辑文档时, Atlas会执行findOneAndUpdate操作并仅更新您已更改的字段。

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

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

文档编辑选项
点击放大

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

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

文档删除
点击放大

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

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

向文档添加字段
点击放大

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

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

文档更新视图
点击放大

当您在列表视图或表视图中编辑文档时, Atlas会执行findOneAndUpdate操作并仅更新您已更改的字段。

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

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

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

在列表视图中还原文档

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

JSON 视图中的选择文档选项
点击放大

单击铅笔图标后,文档将进入编辑模式。您现在可以通过修改 JSON 文档来添加、删除和编辑字段值。

默认情况下,此视图将隐藏嵌入式对象和数组。要展开嵌入式对象和数组元素,请将鼠标悬停在目标文档上,然后单击文档左侧的顶部箭头。

要展开单个对象和数组,请单击所需字段左侧的箭头。

在 JSON 视图中展开嵌入式对象
点击放大

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

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

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

表格视图中的文档编辑选项
点击放大

单击铅笔图标后,文档进入编辑模式。

当您在列表视图或表视图中编辑文档时, Atlas会执行findOneAndUpdate操作并仅更新您已更改的字段。

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

要从文档中删除字段,请执行以下操作:

  1. 单击要删除的字段的值。

  2. 单击 图标。

  3. 单击 Update 以确认更改。

要向文档添加新字段,请执行以下操作:

  1. 单击要在其后添加新字段的字段。

  2. 单击 图标。

  3. 单击 Add Field after <Field Name>(连接)。

  4. 填充新创建的字段。

  5. 单击 Update 以确认更改。

修改文档时,您可以选择在保存修改后的文档之前恢复对字段所做的更改。

点击已编辑表元素右侧的 revert icon

表视图中的文档还原更改

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

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

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

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

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

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

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

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

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

删除按钮表视图
点击放大

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

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

后退

视图

在此页面上