MongoDB Compass 中的聚合管道构建器MongoDB Compass帮助您创建聚合管道用于处理集合或视图中的文档并返回计算结果。
MongoDB Compass提供了不同的模式来创建聚合管道
阶段视图模式,一个基于所选阶段的预加载管道语法的可视化管道编辑器。
阶段向导,阶段视图模式的一个功能,提供一组用于简单聚合阶段用例的模板。阶段向导仅包括简单用例,帮助您开始使用聚合管道。
焦点模式,阶段视图模式的一个功能,一次编辑一个管道阶段。焦点模式有助于您管理复杂或深度嵌套的聚合管道阶段。
文本视图模式,接受原始管道语法的基于文本的管道编辑器。
要构建聚合管道,请选择一个集合并单击聚合选项卡。指南针显示一个空聚合管道。在“集合中文档的预览”部分显示了从所选集合中随机抽取的10个文档。
要了解如何创建聚合管道,请选择您选择的视图模式对应的选项卡
在聚合管道窗格中,确保已选中 {} 阶段 切换按钮。
在聚合阶段卡的左上角,点击选择下拉菜单,并选择用作管道第一个阶段的聚合管道阶段。
填写您所选的阶段。您可以通过拖动阶段的边框向右调整管道阶段的宽度。
注意
每个管道阶段名称右侧的切换按钮决定该阶段是否包含在管道中。切换管道阶段也会更新管道预览,根据该阶段是否包含而更新。
例如,以下管道排除了第一个$match阶段,只包括$project阶段
要添加一个额外的管道阶段到您的最后一个聚合阶段之后,点击添加阶段。要添加一个聚合阶段到您最近添加的阶段之前,点击阶段卡片上方的+图标。
对于每个附加阶段,重复步骤 3 和 4。
注意
您可以通过拖动每个阶段卡的标题来改变管道阶段的顺序。
在管道构建器的右上角,点击 运行。指南针将在文档视图中返回您的结果。
警告
某些聚合运算符,如 $merge
和 $out
,可以修改您的集合数据。
如果您的聚合管道包含可以修改您集合数据的运算符,则在执行管道之前会提示您进行确认。
在聚合管道窗格中,确保已选中 {} 阶段 切换按钮。
在视图模式切换按钮的右侧,点击魔杖图标以打开 阶段向导 卡片。
在“阶段向导”卡片中,您可以通过搜索与用例或聚合阶段相关的关键词来过滤用例。
在“阶段向导”卡片中,选择您管道的第一阶段的阶段用例。您可以通过点击阶段卡片将其添加到管道末尾,或将其拖动到您希望的位置。
选择用例后,指南针将根据所选的聚合管道阶段自动填充阶段卡片中的表单。
阶段向导用例包括以下聚合阶段
填写所选阶段的表单,然后点击应用。点击应用后,表单将转换为阶段卡片,您可以在阶段视图模式、焦点模式或文本视图模式下进行编辑。
指南针用最多十份样本输出文档填充阶段输出。
注意
您不能通过阶段向导编辑现有阶段。阶段向导只能添加新阶段。要编辑现有阶段,请使用阶段视图模式、焦点模式或文本视图模式。
要向管道添加更多聚合阶段,为每个额外的阶段重复步骤3和4。
提示
您可以通过拖动每个阶段卡的标题来改变管道阶段的顺序。
在管道构建器的右上角,点击 运行。指南针将在文档视图中返回您的结果。
在聚合管道窗格中,确保已选中 {} 阶段 切换按钮。
如果您尚未创建聚合阶段,请点击聚合管道窗格底部的+ 添加阶段按钮。
点击选择下拉菜单,然后选择用于管道第一个阶段的聚合管道阶段。
填写你的所选阶段。指南针将最多十个样本输出文档填充到阶段输出中。
您可以通过拖动它们的边框来调整阶段输入、阶段编辑器和阶段输出的宽度。
注意
每个管道阶段名称右侧的切换按钮决定该阶段是否包含在管道中。切换管道阶段也会更新管道预览,根据该阶段是否包含而更新。
点击添加阶段下拉菜单,在您的最后一个聚合阶段之前或之后添加额外的聚合阶段。为每个额外阶段重复步骤 4 和 5。
您可以使用以下键盘快捷键添加阶段
要导航到不同的阶段,请从Focus Mode模式的左上角的阶段下拉菜单中选择您想要编辑的阶段。
您可以使用以下键盘快捷键在阶段之间导航
点击x退出Focus Mode模式,然后在管道构建器右上角选择运行。指南针将在文档视图中返回您的结果。
在聚合管道面板中,点击</> Text切换开关以启用文本模式以进行管道编辑。
将有效的聚合语法输入到文本编辑器中。文本编辑器提供实时语法检查和调试信息。
您还可以使用文本视图模式通过在文本编辑器中输入或粘贴您的管道来导入聚合管道。
例如,以下管道将查询结果限制为4
个文档。
注意
要展开预览结果中的所有嵌套字段和文档,请点击输出选项并选择展开所有字段。
在管道构建器的右上角点击运行。指南针将在文档视图中返回您的结果。