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-update"></a>

L'`$unset`opérateur dans Amazon DocumentDB est utilisé pour supprimer un champ spécifique d'un document. Lorsqu'un champ est supprimé à l'aide de`$unset`, le champ est supprimé du document et la taille du document est réduite en conséquence. Cela peut être utile lorsque vous souhaitez supprimer des données inutiles de vos documents.

**Paramètres**
+ `field`: champ à supprimer du document. Il peut s'agir d'un champ unique ou d'un chemin en pointillé vers un champ imbriqué.

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

L'exemple suivant montre comment utiliser l'`$unset`opérateur pour supprimer le `Words` champ d'un document de la `example` collection.

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

```
db.example.insert({
    "DocName": "Document 1",
    "Date": {
        "Month": 4,
        "Day": 18,
        "Year": 1987,
        "DoW": "Saturday"
    },
    "Words": 2482
})
```

**Exemple de requête**

```
db.example.update(
    { "DocName" : "Document 1" },
    { $unset: { Words:1 } }
)
```

**Sortie**

```
{
    "DocName": "Document 1",
    "Date": {
        "Month": 4,
        "Day": 18,
        "Year": 1987,
        "DoW": "Saturday"
    }
}
```

Dans cet exemple, l'`$unset`opérateur est utilisé pour supprimer le `Words` champ du document dont le nom est `DocName` égal à « Document 1 ». Le document obtenu ne contient plus le `Words` champ.

## Exemples de code
<a name="unset-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 removeField() {
  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('example');

  const result = await collection.updateOne(
    { "DocName": "Document 1" },
    { $unset: { "Words": 1 } }
  );

  console.log(`Modified ${result.modifiedCount} document(s)`);
  client.close();
}

removeField();
```

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

```
from pymongo import MongoClient

def remove_field():
    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['example']

    result = collection.update_one(
        {"DocName": "Document 1"},
        {"$unset": {"Words": 1}}
    )

    print(f"Modified {result.modified_count} document(s)")
    client.close()

remove_field()
```

------