MongoDB-Query-Tester
Probiere MongoDB-Abfragen ohne Datenbank aus. Füge Dokumente ein (oder nutze die Beispielprodukte und -bestellungen), schreib einen find()-Filter oder eine Aggregation-Pipeline in normaler mongosh-Syntax und sieh die passenden Dokumente sofort – auf Wunsch Stufe für Stufe.
Zuletzt aktualisiert:
Ein JSON-Array ist eine Collection; ein Objekt aus Arrays wie {"products": [...], "orders": [...]} ergibt mehrere Collections für $lookup. Extended JSON ($oid, $date) und Shell-Syntax (ObjectId(), ISODate()) funktionieren beide.
Anleitung: MongoDB-Query-Tester
- Lade Dokumente: Behalte die Beispielprodukte und -bestellungen, füge ein JSON-Array ein (zum Beispiel aus mongoexport --jsonArray oder Compass) oder lade eine .json-Datei hoch.
- Wähle find() oder aggregate() und die Collection, die abgefragt werden soll.
- Schreib die Abfrage in mongosh-Syntax, etwa
{ price: { $lt: 50 } }, oder klicke auf einen Beispiel-Chip. - Lies die Ergebnisse als JSON oder als Tabelle. Im Aggregate-Modus nutze Ausgabe zeigen nach, um jede Stufe zu prüfen.
- Kopiere den mongosh-Befehl, um dieselbe Abfrage gegen deine echte Datenbank auszuführen.
Spickzettel für MongoDB-Abfrageoperatoren
| Operator | Passt auf Dokumente, bei denen… | Beispiel |
|---|---|---|
$eq / einfacher Wert | das Feld dem Wert entspricht (oder ein Array-Element) | { status: "shipped" } |
$ne | das Feld ungleich ist, einschließlich Dokumenten ohne das Feld | { status: { $ne: "cancelled" } } |
$gt $gte $lt $lte | der Wert in einem Bereich liegt (nur gleicher Typ) | { price: { $gte: 10, $lt: 50 } } |
$in / $nin | der Wert (nicht) in einer Liste enthalten ist | { category: { $in: ["home", "kitchen"] } } |
$exists | das Feld vorhanden (true) oder nicht vorhanden (false) ist | { discontinued: { $exists: true } } |
$type | der Wert einen bestimmten BSON-Typ hat | { price: { $type: "number" } } |
$regex oder /re/ | ein String zu einem regulären Ausdruck passt | { name: /^cast/i } |
$and $or $nor | Kombinationen ganzer Filter | { $or: [ { stock: 0 }, { price: { $gt: 70 } } ] } |
$not | ein Operatorausdruck falsch ist | { price: { $not: { $gt: 50 } } } |
$all | ein Array jeden aufgeführten Wert enthält | { tags: { $all: ["wood", "kitchen"] } } |
$elemMatch | ein Array-Element alle Bedingungen erfüllt | { ratings: { $elemMatch: { user: "ana", score: 5 } } } |
$size | ein Array genau n Elemente hat | { ratings: { $size: 0 } } |
$expr | ein Aggregationsausdruck wahr ist (zwei Felder vergleichen) | { $expr: { $gt: ["$qty", "$stock"] } } |
Aggregationsstufen im Überblick
| Stufe | Zweck | Tipp |
|---|---|---|
$match | Dokumente mit derselben Syntax wie find() filtern | Stell sie an den Anfang, damit spätere Stufen weniger Dokumente verarbeiten |
$project / $addFields | Umformen: Felder behalten, entfernen, umbenennen oder berechnen | $addFields behält jedes vorhandene Feld |
$group | Nach einem Schlüssel aggregieren mit $sum, $avg, $min, $max, $push, $addToSet, $first, $last | _id: null fasst alle Dokumente zusammen |
$unwind | Ein Dokument pro Array-Element ausgeben | Füge preserveNullAndEmptyArrays: true hinzu, um leere Arrays zu behalten |
$lookup | Left Outer Join mit einer anderen Collection | Das Ergebnis ist immer ein Array; folge mit $unwind für einen einzelnen Treffer |
$sort, $skip und $limit | Sortieren und paginieren | Sortiere zusätzlich nach einem eindeutigen Feld für stabile Seiten |
$facet | Mehrere Sub-Pipelines auf derselben Eingabe ausführen | Ideal für eine Anzahl plus eine Ergebnisseite in einer Abfrage |
$bucket, $sortByCount und $count | Histogramme, Häufigkeitstabellen und Summen | $sortByCount: "$tags" nach $unwind ordnet Tags nach Häufigkeit |
Regeln, die oft überraschen
- Type Bracketing:
{ price: { $gt: "10" } }vergleicht nur Strings und passt daher nie auf numerische Preise. Speichere und frage Zahlen als Zahlen ab. - null passt auf fehlende Felder:
{ discontinued: null }liefert Dokumente, in denen das Feld null ist oder fehlt. Nutze{ $exists: false }oder{ $type: "null" }, um beides zu unterscheiden. - Projektionen: Du kannst
1und0nicht in einer Projektion mischen, außer_id: 0._idist enthalten, solange du es nicht ausschließt. - Exakter Unterdokument-Treffer:
{ dims: { w: 12, h: 20 } }verlangt dieselben Felder in derselben Reihenfolge; nutze Punktnotation wie{ "dims.w": 12 }, um ein einzelnes Feld abzugleichen. - Sortieren von Arrays: Eine aufsteigende Sortierung nach einem Array-Feld verwendet sein kleinstes Element, eine absteigende sein größtes.
- Datumswerte: Bereichsabfragen auf Datumswerte brauchen echte Datumswerte (
ISODate()oder{"$date": ...}). Als einfacher Text gespeicherte ISO-Strings werden nur als Strings verglichen.
Häufige Fragen
Brauche ich dafür einen MongoDB-Server?
Nein. Der Tester enthält eine eigene, in JavaScript geschriebene Abfrage-Engine, die den Regeln von MongoDB für Matching, Projektion, Sortierung und Aggregation folgt, und läuft daher in deinem Browser auf den eingefügten Dokumenten. Nichts wird an einen Server gesendet, was ihn auch für aus der Produktion kopierte Beispieldaten sicher macht.
Welche Syntax kann ich verwenden?
Alles, was du in mongosh eingeben würdest: Feldnamen ohne Anführungszeichen, einfache oder doppelte Anführungszeichen, reguläre Ausdrücke wie /^abc/i, ObjectId("..."), ISODate("..."), new Date(...), NumberInt(...), Kommentare und abschließende Kommas. Striktes JSON und MongoDB Extended JSON ($oid, $date, $numberLong) werden ebenfalls akzeptiert.
Wie funktioniert das Matching bei Arrays?
Wie in MongoDB passt eine Bedingung auf ein Array-Feld, wenn irgendein Element sie erfüllt; { tags: "camping" } findet also Dokumente, deren tags-Array camping enthält. Nutze $all, um mehrere Werte zu verlangen, $size für eine exakte Länge und $elemMatch, wenn ein einzelnes Element mehrere Bedingungen gleichzeitig erfüllen muss. Punktnotation wie "ratings.score" greift in Arrays von Unterdokumenten.
Wie verbinde ich zwei Collections mit $lookup?
Füge ein Objekt mit einem Array pro Collection ein, zum Beispiel {"orders": [...], "products": [...]}, wähle die Collection, auf der die Pipeline läuft, und füge eine Stufe wie { $lookup: { from: "products", localField: "productId", foreignField: "_id", as: "product" } } hinzu. Die Pipeline-Form mit let und pipeline wird ebenfalls unterstützt.
Sind die Ergebnisse identisch mit meinem MongoDB-Server?
Für die unterstützten Operatoren folgen die Ergebnisse dem dokumentierten Verhalten von MongoDB, einschließlich Type Bracketing bei Vergleichen, null-Treffern bei fehlenden Feldern und Array-Sortierschlüsseln. Unterschiede können bei Funktionen auftreten, die einen Server brauchen, etwa Text- oder Geodaten-Indizes, Collation, $where, Schreibvorgänge und die Reihenfolge der $group-Ausgabe, die auch MongoDB nicht garantiert. Zahlen verwenden JavaScript-Doubles, daher bleibt die Genauigkeit von NumberDecimal nicht erhalten.
Warum liefert mein Filter keine Dokumente?
Häufige Ursachen: Ein String wird mit einer Zahl verglichen ("42" ist nicht gleich 42, und Bereichsoperatoren vergleichen nur Werte desselben Typs), Datumswerte sind als einfache Strings statt als ISODate- oder $date-Werte gespeichert, ein Tippfehler oder falsche Groß-/Kleinschreibung im Feldnamen, oder ein Operator-Objekt wurde verwendet, wo ein verschachteltes Dokument gemeint war. Das Fehlerfeld erklärt Syntaxprobleme mit Zeile und Spalte.
Kann ich meine eigenen exportierten Daten verwenden?
Ja. Füge die Ausgabe von mongoexport (sowohl --jsonArray als auch das Standardformat mit einem Dokument pro Zeile), Compass-Exporte oder ein beliebiges JSON-Array ein oder lade sie hoch. Große Dateien mit mehreren Megabyte funktionieren, der Tester ist aber für Stichproben statt für vollständige Collections gedacht.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.