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\$1PRUNE
<a name="PRUNE"></a>

Die `$$PRUNE` Systemvariable wird zusammen mit der `$redact` Phase in der Aggregationspipeline verwendet, um Dokumente oder eingebettete Dokumentebenen aus den Ergebnissen auszuschließen. Wenn eine Bedingung als Ergebnis ausgewertet wird`$$PRUNE`, wird das aktuelle Dokument oder Unterdokument aus der Ausgabe entfernt. Es wird normalerweise zusammen mit `$$DESCEND` (um das Dokument zu behalten und zu durchsuchen) oder `$$KEEP` (um das Dokument auf allen Ebenen beizubehalten) verwendet.

**Parameter**

Keine. Die `$$PRUNE` Systemvariable wird ohne Parameter verwendet und muss mit `$redact` verwendet werden.

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

Das folgende Beispiel zeigt, wie Sie `$$PRUNE` mit with Benutzer`$redact`, die älter als 30 Jahre sind, von den Ergebnissen ausschließen können.

**Erstellen Sie Beispieldokumente**

```
db.users.insert([
  { _id:1, name: "Carlos Salazar", age: 35, address: { street: "123 Main St", city: "Anytown", state: "CA" } },
  { _id:2, name: "Saanvi Sarkar", age: 28, address: { street: "456 Oak Rd", city: "Someplace", state: "NY" } },
  { _id:3, name: "Li Juan", age: 42, address: { street: "789 Pine Ave", city: "Springfield", state: "TX" } }
])
```

**Beispiel für eine Abfrage**

```
db.users.aggregate([
  {
    $redact: {
      $cond: {
        if: { $gt: ["$age", 30] },
        then: "$$PRUNE",
        else: "$$DESCEND"
      }
    }
  }
])
```

**Ausgabe**

```
[
  {
    "_id": 2,
    "name": "Saanvi Sarkar",
    "age": 28,
    "address": {
      "street": "456 Oak Rd",
      "city": "Someplace",
      "state": "NY"
    }
  }
]
```

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

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

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

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

const client = new MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');

async function main() {
  await client.connect();
  const db = client.db('test');
  const users = db.collection('users');

  const result = await users.aggregate([
    {
      $redact: {
        $cond: {
          if: { $gt: ["$age", 30] },
          then: "$$PRUNE",
          else: "$$DESCEND"
        }
      }
    }
  ]).toArray();

  console.log(result);
  await client.close();
}

main();
```

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

```
from pymongo import MongoClient

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

result = list(users.aggregate([
    {
        '$redact': {
            '$cond': {
                'if': { '$gt': ['$age', 30] },
                'then': '$$PRUNE',
                'else': '$$DESCEND'
            }
        }
    }
]))

print(result)
client.close()
```

------