Startseite › Entwickler-Tools › MongoDB-Query-Tester

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.

mongosh-Befehl

Anzeige
Anzeige

Anleitung: MongoDB-Query-Tester

  1. 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.
  2. Wähle find() oder aggregate() und die Collection, die abgefragt werden soll.
  3. Schreib die Abfrage in mongosh-Syntax, etwa { price: { $lt: 50 } }, oder klicke auf einen Beispiel-Chip.
  4. Lies die Ergebnisse als JSON oder als Tabelle. Im Aggregate-Modus nutze Ausgabe zeigen nach, um jede Stufe zu prüfen.
  5. Kopiere den mongosh-Befehl, um dieselbe Abfrage gegen deine echte Datenbank auszuführen.

Spickzettel für MongoDB-Abfrageoperatoren

OperatorPasst auf Dokumente, bei denen…Beispiel
$eq / einfacher Wertdas Feld dem Wert entspricht (oder ein Array-Element){ status: "shipped" }
$nedas Feld ungleich ist, einschließlich Dokumenten ohne das Feld{ status: { $ne: "cancelled" } }
$gt $gte $lt $lteder Wert in einem Bereich liegt (nur gleicher Typ){ price: { $gte: 10, $lt: 50 } }
$in / $ninder Wert (nicht) in einer Liste enthalten ist{ category: { $in: ["home", "kitchen"] } }
$existsdas Feld vorhanden (true) oder nicht vorhanden (false) ist{ discontinued: { $exists: true } }
$typeder 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 $norKombinationen ganzer Filter{ $or: [ { stock: 0 }, { price: { $gt: 70 } } ] }
$notein Operatorausdruck falsch ist{ price: { $not: { $gt: 50 } } }
$allein Array jeden aufgeführten Wert enthält{ tags: { $all: ["wood", "kitchen"] } }
$elemMatchein Array-Element alle Bedingungen erfüllt{ ratings: { $elemMatch: { user: "ana", score: 5 } } }
$sizeein Array genau n Elemente hat{ ratings: { $size: 0 } }
$exprein Aggregationsausdruck wahr ist (zwei Felder vergleichen){ $expr: { $gt: ["$qty", "$stock"] } }

Aggregationsstufen im Überblick

StufeZweckTipp
$matchDokumente mit derselben Syntax wie find() filternStell sie an den Anfang, damit spätere Stufen weniger Dokumente verarbeiten
$project / $addFieldsUmformen: Felder behalten, entfernen, umbenennen oder berechnen$addFields behält jedes vorhandene Feld
$groupNach einem Schlüssel aggregieren mit $sum, $avg, $min, $max, $push, $addToSet, $first, $last_id: null fasst alle Dokumente zusammen
$unwindEin Dokument pro Array-Element ausgebenFüge preserveNullAndEmptyArrays: true hinzu, um leere Arrays zu behalten
$lookupLeft Outer Join mit einer anderen CollectionDas Ergebnis ist immer ein Array; folge mit $unwind für einen einzelnen Treffer
$sort, $skip und $limitSortieren und paginierenSortiere zusätzlich nach einem eindeutigen Feld für stabile Seiten
$facetMehrere Sub-Pipelines auf derselben Eingabe ausführenIdeal für eine Anzahl plus eine Ergebnisseite in einer Abfrage
$bucket, $sortByCount und $countHistogramme, 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 1 und 0 nicht in einer Projektion mischen, außer _id: 0. _id ist 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.

Ähnliche Tools

Alle Code-Playgrounds & Tester ansehen →