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

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

`$literal`Operator di Amazon DocumentDB digunakan untuk mewakili nilai literal dalam tahap pipeline agregasi. Ini memungkinkan Anda untuk memasukkan nilai tertentu, seperti angka, string, atau boolean, tanpa menafsirkannya sebagai referensi bidang atau ekspresi.

Operator ini sangat berguna ketika Anda perlu menyertakan nilai literal sebagai bagian dari pipeline agregasi yang lebih kompleks, seperti saat membuat filter kueri dinamis atau melakukan perhitungan.

**Parameter**

Tidak ada

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

Contoh berikut menunjukkan penggunaan `$literal` operator untuk menyertakan nilai literal dalam pipeline agregasi. `$literal`Operator digunakan untuk memasukkan nilai 18 sebagai nilai literal dalam ekspresi \$1gt. Hal ini memungkinkan jalur agregasi untuk membandingkan bidang usia dengan nilai literal 18 untuk menentukan apakah orang tersebut dewasa.

**Buat dokumen sampel**

```
db.collection.insertMany([
  { "name": "John Doe", "age": 30, "city": "New York" },
  { "name": "Jane Doe", "age": 25, "city": "Los Angeles" },
  { "name": "Bob Smith", "age": 35, "city": "Chicago" }
]);
```

**Contoh kueri**

```
db.collection.aggregate([
  {
    $project: {
      name: 1,
      age: 1,
      city: 1,
      isAdult: { $gt: ["$age", { $literal: 18 }] }
    }
  }
]);
```

**Keluaran**

```
[
  {
    "_id": ObjectId("601234567890abcdef012345"),
    "name": "John Doe",
    "age": 30,
    "city": "New York",
    "isAdult": true
  },
  {
    "_id": ObjectId("601234567890abcdef012346"),
    "name": "Jane Doe",
    "age": 25,
    "city": "Los Angeles",
    "isAdult": true
  },
  {
    "_id": ObjectId("601234567890abcdef012347"),
    "name": "Bob Smith",
    "age": 35,
    "city": "Chicago",
    "isAdult": true
  }
]
```

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

Untuk melihat contoh kode untuk menggunakan `$literal` 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('collection');

  const result = await collection.aggregate([
    {
      $project: {
        name: 1,
        age: 1,
        city: 1,
        isAdult: { $gt: ["$age", { $literal: 18 }] }
      }
    }
  ]).toArray();

  console.log(result);
  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.collection

    result = list(collection.aggregate([
        {
            '$project': {
                'name': 1,
                'age': 1,
                'city': 1,
                'isAdult': { '$gt': ["$age", { '$literal': 18 }] }
            }
        }
    ]))

    print(result)
    client.close()

example()
```

------