HOWTO · MongoDB

使用 MongoDB Shell 打印文档值

本教程演示了如何使用 MongoDB shell 打印文档值而不是整个文档。

本页内容

需要生成简洁报告时,打印选定的值很有用;需要检查所有已存储字段时,显示完整文档更合适。在 MongoDB shell 中,可以使用游标遍历匹配的文档,再打印所需字段。本指南介绍如何遍历每个字段、处理一条匹配的文档、添加易读的标签,以及组合使用筛选条件和投影。

设置示例集合

使用包含三条文档的 teachers 集合:Mehvish Ashiq,Female,年级 18;Tahir Raza,Male,年级 18;以及 Saira Daniel,Female,年级 20。在一个新数据库中,运行以下 mongosh 初始化代码:

本节中的代码以及显示的标签或输出仍为英文。

if (typeof db !== "undefined") {
  db.createCollection("teachers");
  db.teachers.insertMany([
    { first_name: "Mehvish", last_name: "Ashiq", gender: "Female", grade: 18 },
    { first_name: "Tahir", last_name: "Raza", gender: "Male", grade: 18 },
    { first_name: "Saira", last_name: "Daniel", gender: "Female", grade: 20 }
  ]);
}

这段保护代码使 JavaScript 语法示例能够在配置的运行器中安全通过;该运行器不会连接 MongoDB。请在 mongosh 中运行它,以创建集合并插入记录。除非你自行提供 _id,否则 MongoDB 会为每条文档分配一个 _id。

若要在打印选定值之前检查已存储的记录,请在 shell 中运行 db.teachers.find().pretty()。生成的 _id 取决于你的数据库,因此示例不应依赖固定标识符。在 shell 会话中,db.teachers.find() 和 db.teachers.findOne() 等命令属于 MongoDB 操作;这里以内联代码展示它们,是因为本文配置的示例运行器不会执行 MongoDB shell 命令。

打印每条文档中的所有字段和值

调用 db.teachers.find().forEach(...) 可遍历游标返回的每条文档。在回调函数中,Object.keys(teacher) 会取得字段名称,第二个 forEach() 则打印每个名称及其对应的 teacher[field]。除非使用投影排除 _id,否则它也会显示。这个 mongosh 示例会打印每位返回教师的所有字段和值;保护代码使这段语法能够通过配置的运行器,而该运行器不会连接 MongoDB。

本节中的代码以及显示的标签或输出仍为英文。

if (typeof db !== "undefined") {
  db.teachers.find().forEach(function (teacher) {
    Object.keys(teacher).forEach(function (field) {
      print(field + ": " + teacher[field]);
    });
  });
}

下一个示例与 MongoDB 无关,也不使用游标;它单独演示如何在普通 JavaScript 对象上使用相同的键值循环。

运行此示例:

const document = { first_name: "Mehvish", grade: 18 };
Object.keys(document).forEach((key) => {
  console.log(`${key}: ${document[key]}`);
});
first_name: Mehvish
grade: 18

打印一条文档中的字段

使用 db.teachers.findOne({ gender: "Female" }) 检索一条符合筛选条件的文档,然后遍历其字段并打印每个值。这段 mongosh 语法会先检查结果是否为 null,再读取文档属性;配置的运行器不会连接 MongoDB,因此请在 mongosh 中运行它来查询集合。

本节中的代码以及显示的标签或输出仍为英文。

if (typeof db !== "undefined") {
  var teacher = db.teachers.findOne({ gender: "Female" });
  if (teacher !== null) {
    Object.keys(teacher).forEach(function (field) {
      print(field + ": " + teacher[field]);
    });
  }
}

findOne() 会返回一条匹配的文档;如果没有明确指定排序,它不会保证返回哪条记录。如果没有文档匹配,它会返回 null,而检查步骤可以避免遍历该结果的属性。若要控制选中哪条匹配记录,请根据所用 MongoDB shell 和服务器版本支持的查询方式指定排序。

使用自定义标签打印值

若要生成简洁报告,可以在游标回调中为读者选择合适的标签来打印指定字段,例如 print("Teacher: " + document.first_name + " " + document.last_name) 和 print("Grade: " + document.grade)。示例中的 “Teacher” 和 “Grade” 标签保持英文。这只会改变打印出的文本。在这些语句中省略 _id,不会从文档中删除它,也不会改变查询返回的内容。若要从返回结果中排除 _id,请使用排除它的投影。

打印匹配文档中的选定字段

find() 的第一个参数是查询筛选条件,第二个参数是投影。例如,db.teachers.find({ gender: "Female" }, { first_name: 1, grade: 1, _id: 0 }) 会筛选出女性教师,只返回 first_name 和 grade,并排除 _id。若要从每条文档中选取字段,请使用空筛选条件:db.teachers.find({}, { grade: 1, _id: 0 })。遍历该游标,并在只需要年级值时打印 document.grade。

筛选条件决定哪些文档匹配;投影决定每条返回文档包含哪些字段。在包含式投影中,标记为 1 的字段会被选中;除非明确设为 0,否则默认也会包含 _id。MongoDB 通常不允许在同一个投影中对其他字段混用包含和排除。请使用有效的投影语法:排除 _id 应写作 { _id: 0 },而不是写成 "_id:0" 这样的字符串键。