Find (en.)

The find-query is based on the syntax of the MongoDB JavaScript driver (http://mongodb.github.io/node-mongodb-native/api-generated/collection.html#find). At least one query object is required. Optionally you can also specify an options object.

{query}[, {options}]

A special feature of Mongo Management Studio is to enter the queries as quickly and easily as possible. The following example queries refer to the collection zipcode from the Getting started tutorial.

// Search all cities in the U.S. State of California. (CA)
// all the following queries return the same result
 
// standard MongoDB query
{state: "CA"}
 
// If there is no options object, the curly braces can be omitted
state: "CA"
 
// You can also write everything in quotation marks
"state": "CA"
 
// Or use single quotes
state: 'CA'

MongoDB unterscheidet bei Abfragen immer zwischen Groß- und Kleinschreibung. Um dies zu umgehen, kann man Regular Expressions verwenden.

MongoDB queries always distinguishes between upper and lowercase. To work around this, you can use regular expressions.

Natürlich lassen sich auf diese Art und Weise auch komplexere Abfragen gestalten.

// Suche alle Städte aus dem US-Bundesstaat Alabama (AL) mit mehr als 40000 Einwohnern
 
// Standard MongoDB Abfrage
{
	state: "AL",
	pop: {
		$gt: 40000
	}
}
 
// verkürzte Abfrage
state: "AL", pop: {$gt: 40000}
 
// verkürzte Abfrage mit ohne Leerzeichen
state:"AL",pop:{$gt:40000}

Verwendung von Optionen

// Suche alle Städte aus dem US-Bundesstaat Alabama (AL) mit mehr als 40000 Einwohnern, und liefere in der Ergebnismenge nur die Städtenamen
{state: "AL", pop: {$gt: 40000}}, {fields: {city: 1}}

// Array Syntax
{state: "AL", pop: {$gt: 40000}}, {fields: ['city']}

// auch id Feld weglassen
{state: "AL", pop: {$gt: 40000}}, {fields: {city: 1, _id: 0}}
 
// Suche alle Städte aus dem US-Bundesstaat Alabama (AL) mit mehr als 10000 Einwohnern und sortiere aufsteigend nach Städtenamen
{state: "AL", pop: {$gt: 10000}}, {sort: {city: 1}}
 
// Suche alle Städte aus dem US-Bundesstaat Alabama (AL) mit mehr als 10000 Einwohnern und liefere 10 Datensätze und überspringe die ersten 20 Datensätze
{state: "AL", pop: {$gt: 10000}}, {limit: 10, skip: 20}

Bei der Verwendung eines options Objekts müssen auch bei dem query Objekt geschweifte Klammern verwendet werden.

In der Tabellenansicht kann auch Sortieren, ohne dass man eine sort option verwenden muss. Dazu genügt es, auf den Namen einer Spalte zu klicken, um nach dieser zu sortieren. Beim nochmaligen Klick auf den Spaltennamen wird die Sortierung umgekehrt.

Spezielle Datentypen

ObjectId

Folgende Abfragen liefern jeweils das gleiche Ergebnis, wenn man nach einer bestimmten ObjectId sucht

{_id: ObjectId('52bd27ebf370afe931001364')}
{_id: ObjectId("52bd27ebf370afe931001364")}
_id: ObjectId('52bd27ebf370afe931001364')
_id: ObjectId("52bd27ebf370afe931001364")
_id: "52bd27ebf370afe931001364"
_id: '52bd27ebf370afe931001364'

Mongo Management Studio erkennt Strings, die das Format einer MongoDB ObjectId haben und konvertiert dieses dann. Sollte es passieren, dass in einer Collection _ids als Strings gespeichert und diese MongoDB ObjectId konform sind, muss man für die Suchabfrage über den Konsolenmodus verwenden. Ansonsten werden keine Daten gefunden.

// finde Person mit id '52bd27ebf370afe931001364'
db.persons.find{_id: '52bd27ebf370afe931001364'}

Datumswerte

Datumswerte müssen in einer bestimmten Syntax eingegeben werden, da diese nicht automatisch konvertiert werden können.

// als ISO-String
start: ISODate('2013-08-02T08:20:38.993Z')
 
// als Datums-String
start: {$gte: {ISODate('dec 11, 1989')}}
start: {$gte: {ISODate("1989, 12, 11")}}
 
// als timestamp in ms
start: ISODate(629379488000)

JavaScript arbeitet in Millisekunden, UNIX timestamps müssen mit 1000 multipliziert werden, um korrekt umgerechnet oder angezeigt werden zu können.

Regex als Wertzuweisung eines Datenfeldes

Besitzt ein Feld eines Datensatzes als Wert einen Regex-Ausdruck kann man diesen wie folgt abfragen.

pattern: /abc/

Es muss der komplette Regex-Ausdruck angegeben werden, um den entsprechenen Datensatz mit dem richtigen Wert zu erhalten.

Regex-Abfragen für Felder mit Strings

Man kann Regex auch verwenden, um Felder abzufragen.

// Suche alle Städte, die mit FLO beginnen
city: {$regex: '^FLO'}
 
// ignoriere Groß- und Kleinschreibung
city: {$regex: '^flo', $options: 'i'}
 
// kurze Schreibweise
city: /^flo/i

In der derzeitigen Version werden lediglich die Parameter "i" sowie "m" als Optionen bei der Kurzschreibweise unterstützt. Die Parameter "s" und "x" folgen in einer späteren Version.

Genauere Informationen zum Gebrauch von Regex-Ausdrücken in Abfragen kann man hier nachlesen http://docs.mongodb.org/manual/reference/operator/query/regex/