Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# \$1 natürlich
<a name="natural"></a>

Der `$natural` Operator in Amazon DocumentDB wird verwendet, um die Dokumente in ihrer natürlichen Reihenfolge zu sortieren, d. h. der Reihenfolge, in der sie in die Sammlung eingefügt wurden. Dies steht im Gegensatz zum Standard-Sortierverhalten, bei dem die Dokumente anhand der Werte der angegebenen Felder sortiert werden.

**Parameter**

Keine

## Beispiel (MongoDB Shell)
<a name="natural-examples"></a>

Das folgende Beispiel zeigt, wie der `$natural` Operator verwendet wird, um die Dokumente in einer Sammlung in ihrer natürlichen Reihenfolge zu sortieren.

**Erstellen Sie Beispieldokumente**

```
db.people.insertMany([
  { "_id": 1, "name": "María García", "age": 28 },
  { "_id": 2, "name": "Arnav Desai", "age": 32 },
  { "_id": 3, "name": "Li Juan", "age": 25 },
  { "_id": 4, "name": "Carlos Salazar", "age": 41 },
  { "_id": 5, "name": "Sofia Martínez", "age": 35 }
]);
```

**Beispiel für eine Abfrage**

```
db.people.find({}, { "_id": 1, "name": 1 }).sort({ "$natural": 1 });
```

**Ausgabe**

```
[
  { "_id": 1, "name": "María García" },
  { "_id": 2, "name": "Arnav Desai" },
  { "_id": 3, "name": "Li Juan" },
  { "_id": 4, "name": "Carlos Salazar" },
  { "_id": 5, "name": "Sofia Martínez" }
]
```

Die Abfrage sortiert die Dokumente in der Sammlung in ihrer natürlichen Reihenfolge, d. h. der Reihenfolge, in der sie eingefügt wurden.

## Codebeispiele
<a name="natural-code"></a>

Um ein Codebeispiel für die Verwendung des `$natural` Befehls anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten:

------
#### [ Node.js ]

```
const { MongoClient } = require('mongodb');

async function example() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const collection = db.collection('people');

  const documents = await collection.find({}, { projection: { _id: 1, name: 1 } })
    .sort({ $natural: 1 })
    .toArray();

  console.log(documents);

  await client.close();
}

example();
```

------
#### [ Python ]

```
from pymongo import MongoClient

def example():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client['test']
    collection = db['people']

    documents = list(collection.find({}, {'_id': 1, 'name': 1}).sort('$natural', 1))
    print(documents)

    client.close()

example()
```

------