Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# \$1unset
<a name="unset-stage"></a>

Nouveau depuis la version 8.0

Non pris en charge par le cluster Elastic.

La phase `$unset` d'agrégation dans Amazon DocumentDB vous permet de supprimer des champs de documents.

**Paramètres**
+ `expression`: nom de champ ou liste de plusieurs noms de champs.

## Exemple (MongoDB Shell)
<a name="unset-stage-examples"></a>

L'exemple suivant illustre l'utilisation de la phase d'`$unset`agrégation pour supprimer le `price` champ.

**Création d'exemples de documents**

```
db.inventory.insertMany([
  { item: "pencil", quantity: 100, price: 0.24},
  { item: "pen", quantity: 204, price: 1.78 }
]);
```

**Exemple d'agrégation**

```
db.inventory.aggregate([
  {
    $unset: "price"
  }
])
```

**Sortie**

```
[
  {
    _id: ObjectId('69248951d66dcae121d2950d'),
    item: 'pencil',
    quantity: 100
  },
  {
    _id: ObjectId('69248951d66dcae121d2950e'),
    item: 'pen',
    quantity: 204
  }
]
```

## Exemples de code
<a name="unset-stage-code"></a>

Pour afficher un exemple de code d'utilisation de la `$unset` commande, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

------
#### [ 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 inventory = db.collection('inventory');

  const result = await inventory.aggregate([
      {
        $unset: "price"
      }
  ]).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']
    inventory = db['inventory']

    result = list(inventory.aggregate([
      {
        "$unset": "price"
      }
    ]))

    print(result)
    client.close()

example()
```

------