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.

$unset

L'$unsetopé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

Exemple (MongoDB Shell)

L'exemple suivant montre comment utiliser l'$unsetopé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'$unsetopé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

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()