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" 這類字串當作欄位名稱。