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.

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

Der `$literal` Operator in Amazon DocumentDB wird verwendet, um einen Literalwert innerhalb einer Aggregationspipeline-Phase darzustellen. Er ermöglicht es Ihnen, einen bestimmten Wert einzubeziehen, z. B. eine Zahl, eine Zeichenfolge oder einen booleschen Wert, ohne ihn als Feldverweis oder Ausdruck zu interpretieren.

Dieser Operator ist besonders nützlich, wenn Sie einen Literalwert als Teil einer komplexeren Aggregationspipeline einbeziehen müssen, z. B. beim Erstellen dynamischer Abfragefilter oder beim Durchführen von Berechnungen.

**Parameter**

Keine

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

Das folgende Beispiel zeigt die Verwendung des `$literal` Operators, um einen Literalwert in eine Aggregationspipeline aufzunehmen. Der `$literal` Operator wird verwendet, um den Wert 18 als Literalwert in den \$1gt-Ausdruck aufzunehmen. Auf diese Weise kann die Aggregationspipeline das Altersfeld mit dem Literalwert 18 vergleichen, um festzustellen, ob es sich bei der Person um einen Erwachsenen handelt.

**Erstellen Sie Beispieldokumente**

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

**Beispiel für eine Abfrage**

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

**Ausgabe**

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

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

Um ein Codebeispiel für die Verwendung des `$literal` 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('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()
```

------