Docs 菜单
Docs 主页
/
MongoDB Atlas
/
与数据交互

运行聚合管道

在此页面上

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

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

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

所需角色

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

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

访问聚合管道构建器

1

为该集合选择数据库。

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

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

从左侧或主面板中选择集合。

主面板显示 Find、Indexes 和 Aggregation 视图。

3

选择 视图。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">Aggregation

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

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

创建聚合管道

1

选择聚合阶段。

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

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

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

2

填充聚合阶段。

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

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

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

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

根据需要为管道添加其他阶段。

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

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

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

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

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

4

为每个其他阶段重复步骤 1 和 2。

排序规则

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

要指定排序规则文档，请点击管道构建器顶部的 Collation（排序规则）。

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

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

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

从文本导入 Aggregation Pipeline

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

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

1

打开New Pipeline from Text 对话框。

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

  2. 单击 New Pipeline from Text（连接）。

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

在对话框中键入或粘贴您的管道。

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

3

单击Create New 。

4

Confirm在随后的对话框中单击 。

重置管道

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

将聚合管道导出为驱动程序语言

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

要导出聚合管道，请执行以下操作：

1

构建聚合管道。

有关聚合管道的说明，请参阅创建聚合管道（Create an Aggregation Pipeline）。

2

Export to Language单击管道创建器顶部的 （更新视图）。

3

选择所需的导出语言。

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

左侧的 My Pipeline 以 mongosh 语法显示您的管道。

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

4

如果需要，可包括 import 语句。

（可选） ：选中 Include Import Statements 选项，以包含选定语言所需的导入语句。

5

Copy单击 按钮。

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

6

单击Close 返回聚合管道构建器。

配置聚合管道设置

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

限制

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

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

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

修改聚合管道设置

修改 aggregation pipeline 构建者设置：

1

单击管道构建器右上方的 <i class=\" \"> 图标。<a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">

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

根据需要修改管道设置。

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

设置
说明
默认
Comment Mode

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

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

On（开启）
Number of Preview Documents

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

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

10
3

单击Apply 保存更改。

后退

索引

来年

Triggers