HOWTO · MongoDB
Dokumentwerte mit der MongoDB-Shell drucken
Dieses Tutorial zeigt, wie Sie mithilfe der MongoDB-Shell Dokumentwerte anstelle ganzer Dokumente drucken.
Auf dieser Seite
Die Ausgabe ausgewählter Werte ist nützlich, wenn Sie einen kompakten Bericht benötigen; vollständige Dokumente eignen sich besser, wenn Sie alle gespeicherten Felder prüfen möchten. Verwenden Sie in der MongoDB-Shell einen Cursor, um passende Dokumente zu durchlaufen, und geben Sie anschließend die benötigten Felder aus. Diese Anleitung zeigt, wie Sie alle Felder durchlaufen, ein passendes Dokument behandeln, lesbare Beschriftungen vergeben und einen Filter mit einer Projektion kombinieren.
Beispielsammlung einrichten
Verwenden Sie eine Sammlung namens teachers mit drei Dokumenten: Mehvish Ashiq, Female, Note 18; Tahir Raza, Male, Note 18; und Saira Daniel, Female, Note 20. Führen Sie in einer neuen Datenbank diese Einrichtung mit mongosh aus:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
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 }
]);
}
Durch die Schutzabfrage bleibt dieses JavaScript-Syntaxbeispiel im konfigurierten Runner unbedenklich, da dieser keine Verbindung zu MongoDB herstellt. Führen Sie es in mongosh aus, um die Sammlung zu erstellen und die Datensätze einzufügen. MongoDB weist jedem Dokument ein _id zu, sofern Sie keines angeben.
Um die gespeicherten Datensätze vor der Ausgabe ausgewählter Werte zu prüfen, führen Sie db.teachers.find().pretty() in der Shell aus. Die generierten _id-Werte hängen von Ihrer Datenbank ab; Beispiele sollten sich daher nicht auf feste Kennungen stützen. In einer Shell-Sitzung sind Befehle wie db.teachers.find() und db.teachers.findOne() MongoDB-Operationen. Hier stehen sie im Fließtext, weil der konfigurierte Beispiel-Runner dieses Artikels keine MongoDB-Shell-Befehle ausführt.
Alle Felder und Werte jedes Dokuments ausgeben
Rufen Sie db.teachers.find().forEach(...) auf, um jedes vom Cursor zurückgegebene Dokument zu durchlaufen. In der Callback-Funktion liefert Object.keys(teacher) die Feldnamen; ein zweiter Aufruf von forEach() gibt jeden Namen zusammen mit teacher[field] aus. Das Feld _id wird ebenfalls ausgegeben, sofern es nicht durch eine Projektion ausgeschlossen wird. Dieses mongosh-Beispiel gibt jedes Feld und jeden Wert der zurückgegebenen Lehrkräfte aus. Die Schutzabfrage ermöglicht es, die Syntax im konfigurierten Runner zu verwenden, der keine Verbindung zu MongoDB herstellt.
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
if (typeof db !== "undefined") {
db.teachers.find().forEach(function (teacher) {
Object.keys(teacher).forEach(function (field) {
print(field + ": " + teacher[field]);
});
});
}
Das nächste Beispiel ist davon getrennt: Es veranschaulicht dieselbe Schlüssel-Wert-Schleife mit einem einfachen JavaScript-Objekt, ohne MongoDB oder einen Cursor.
Führen Sie dieses Beispiel aus:
const document = { first_name: "Mehvish", grade: 18 };
Object.keys(document).forEach((key) => {
console.log(`${key}: ${document[key]}`);
});
first_name: Mehvish
grade: 18
Felder eines Dokuments ausgeben
Verwenden Sie db.teachers.findOne({ gender: "Female" }), um ein Dokument abzurufen, das einem Filter entspricht. Durchlaufen Sie anschließend seine Felder und geben Sie jeden Wert aus. Diese mongosh-Syntax prüft vor dem Zugriff auf Dokumenteigenschaften, ob das Ergebnis null ist. Da der konfigurierte Runner keine Verbindung zu MongoDB herstellt, führen Sie die Abfrage in mongosh aus.
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
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() gibt ein passendes Dokument zurück. Ohne explizite Sortierung ist kein bestimmter Datensatz garantiert. Wenn kein Dokument dem Filter entspricht, wird null zurückgegeben; die Prüfung verhindert dann, dass Eigenschaften dieses Ergebnisses durchlaufen werden. Um festzulegen, welcher passende Datensatz ausgewählt wird, geben Sie eine Sortierung mit der von Ihrer MongoDB-Shell- und Serverversion unterstützten Abfragemethode an.
Werte mit eigenen Beschriftungen ausgeben
Für einen kompakten Bericht können Sie ausgewählte Felder mit leserfreundlichen Beschriftungen ausgeben, zum Beispiel mit print("Teacher: " + document.first_name + " " + document.last_name) und print("Grade: " + document.grade) innerhalb einer Cursor-Callback-Funktion. Die im unveränderten Beispiel verwendeten Beschriftungen „Teacher“ und „Grade“ bleiben englisch. Dadurch ändert sich nur der ausgegebene Text. Wenn Sie _id in diesen Anweisungen weglassen, wird das Feld weder aus dem Dokument entfernt noch verändert sich dadurch das Abfrageergebnis. Soll _id in den zurückgegebenen Ergebnissen fehlen, verwenden Sie eine Projektion, die es ausschließt.
Ausgewählte Felder passender Dokumente ausgeben
find() erwartet zuerst einen Abfragefilter und danach eine Projektion. Beispielsweise filtert db.teachers.find({ gender: "Female" }, { first_name: 1, grade: 1, _id: 0 }) nach Lehrkräften mit gender gleich Female und gibt nur first_name und grade zurück; _id wird ausgeschlossen. Wenn Sie Felder aus allen Dokumenten auswählen möchten, verwenden Sie einen leeren Filter: db.teachers.find({}, { grade: 1, _id: 0 }). Durchlaufen Sie diesen Cursor und geben Sie document.grade aus, wenn nur der Notenwert benötigt wird.
Der Filter bestimmt, welche Dokumente übereinstimmen; die Projektion bestimmt, welche Felder jedes zurückgegebene Dokument enthält. Bei einer Einschlussprojektion werden die mit 1 markierten Felder ausgewählt. _id ist standardmäßig enthalten, sofern es nicht ausdrücklich auf 0 gesetzt wird. MongoDB erlaubt im Allgemeinen nicht, bei anderen Feldern Einschluss und Ausschluss in derselben Projektion zu mischen. Achten Sie auf eine gültige Projektionssyntax: Der Ausschluss von _id wird als { _id: 0 } geschrieben, nicht als Zeichenfolgeschlüssel wie "_id:0".