Docs 菜单
Docs 主页
/
MongoDB Atlas
/

运行聚合管道

在此页面上

  • 所需角色
  • 访问聚合管道构建器
  • 创建聚合管道
  • 将聚合管道导出为驱动程序语言
  • 配置聚合管道设置

您可以使用 Atlas 用户界面,通过构建 聚合管道来处理数据。聚合管道根据选定的管道阶段将文档转换为汇总结果。

Atlas 聚合管道构建器主要用于构建管道,而不是执行管道。管道构建器提供了一种导出管道以便在驱动程序中执行的简便方法。

要在 Atlas 用户界面中创建并执行聚合管道,您必须具有 Project Data Access Read Only 角色或更高级别。

要在管道中使用 $out 阶段,您必须具有 Project Data Access Read/Write 角色。

1

主面板和左侧的 Namespaces 列出了数据库中的集合。

突出显示 Atlas 用户界面中的数据库的屏幕截图。
点击放大
2

主面板显示 FindIndexesAggregation 视图。

3

当您首次打开Aggregation视图时,Atlas 会显示一个空的聚合管道。

聚合管道构建器的初始视图。
点击放大
1

从左下角面板的 Select(选择)下拉菜单中选择聚合阶段。

显示选择管道阶段的屏幕截图。
点击放大

下拉列表右侧的切换指示是否已启用该阶段。

2

用适当的值填充您的阶段。如果启用了评论模式,则管道构建器会为所选阶段提供语法指南。

修改阶段时,Atlas 会根据当前阶段的结果更新右侧的预览文档。

不包含写入阶段(如 $out$merge)的聚合管道会自动在后面加一个 $limit 阶段,该阶段默认将输出限制为 10 个文档。您可以通过 $limit 阶段,更新聚合管道设置Number of Preview Documents 的值字段,从而更改所允许的文档数。

显示管道阶段结果的屏幕截图。
点击放大
3

有两种方法可以向管道添加附加阶段:

  • 单击管道底部的 Add Stage 按钮,在管道末端添加新阶段:

  • 单击一个阶段上的 按钮可在该阶段之后直接添加新阶段。

突出显示"Add Stage"(添加阶段)按钮的屏幕截图。

要删除某一管道阶段,请对所需阶段单击 Delete

4

使用排序规则来指定特定语言的字符串比较规则,如字母大小写和重音符号规则。

要指定排序规则文档,请点击管道构建器顶部的 Collation(排序规则)。

排序规则文档包含以下字段:

{
locale: <string>,
caseLevel: <boolean>,
caseFirst: <string>,
strength: <int>,
numericOrdering: <boolean>,
alternate: <string>,
maxVariable: <string>,
backwards: <boolean>
}

locale 字段为必需字段;所有其他排序规则字段均为可选字段。有关字段说明,请参阅排序规则文档

您可以将聚合管道从纯文本导入到管道构建器中,以轻松修改和验证管道。

要从纯文本导入管道,请执行以下操作:

1
  1. 单击管道构建器顶部加号图标旁边的箭头。

  2. 单击 New Pipeline from Text(连接)。

    从文本对话框打开新管道的截图。
    点击放大
2

您的管道必须与 db.collection.aggregate() 方法的 pipeline 参数的语法一致。

3
4

要使管道返回到初始空白状态,单击管道构建器顶部的“+”图标。

您可以使用聚合管道构建器,将已完成的管道导出为支持的驱动程序语言之一:Java、Node、C# 和 Python 3。使用此功能可以格式化和导出管道,以便在应用程序中使用。

要导出聚合管道,请执行以下操作:

1

有关聚合管道的说明,请参阅创建聚合管道(Create an Aggregation Pipeline)。

2
3

Export Pipeline To 下拉菜单中,选择所需的语言。

左侧的 My Pipelinemongosh 语法显示您的管道。

右侧窗格将以所选语言显示您的管道。

4

(可选) :选中 Include Import Statements 选项,以包含选定语言所需的导入语句。

5

单击管道右上方的 Copy(复制)按钮,从而将所选语言的管道复制到剪贴板。现在,您可将管道集成到应用程序中。

6

您可以在 Atlas 用户界面中配置聚合管道设置。

Atlas 将以下阶段的预览输入文档数量限制为 100,000 个:

此限制支持预览更快地运行。当管道运行时,Atlas 不会应用限制。

您无法在 Atlas UI 中更改预览输入文档的限制。要使用 Compass 更改输入文档的限制,请参阅聚合管道构建器设置。

修改 aggregation pipeline 构建者设置:

1
突出显示管道“设置”按钮的屏幕截图。
2

您可以在 Atlas 用户界面中修改以下设置:

设置
说明
默认

Comment Mode

启用后,Atlas 会向每个阶段添加助手注释。

更改此设置仅影响新阶段,而不会修改已添加到管道中的阶段。

On(开启)

Number of Preview Documents

每个阶段的预览中所显示的文档数。

每个阶段最多只能预览 20 个文档。

10

3

后退

索引