

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

`$natural`Operator di Amazon DocumentDB digunakan untuk mengurutkan dokumen dalam urutan alami mereka, yang merupakan urutan di mana mereka dimasukkan ke dalam koleksi. Ini berbeda dengan perilaku penyortiran default, yaitu mengurutkan dokumen berdasarkan nilai bidang yang ditentukan.

**Parameter**

Tidak ada

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

Contoh berikut menunjukkan bagaimana menggunakan `$natural` operator untuk mengurutkan dokumen dalam koleksi dalam urutan alami mereka.

**Buat dokumen sampel**

```
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 }
]);
```

**Contoh kueri**

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

**Keluaran**

```
[
  { "_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" }
]
```

Kueri mengurutkan dokumen dalam koleksi dalam urutan alami mereka, yang merupakan urutan di mana mereka dimasukkan.

## Contoh kode
<a name="natural-code"></a>

Untuk melihat contoh kode untuk menggunakan `$natural` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:

------
#### [ 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()
```

------