$unwind - Amazon DocumentDB
Exemple (MongoDB Shell)Exemples de code

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.

$unwind

L'$unwindopérateur est utilisé pour déconstruire un champ de tableau à partir des documents d'entrée afin de générer un document pour chaque élément. Cela peut être utile lorsque vous souhaitez effectuer des opérations sur les éléments individuels d'un tableau, telles que le filtrage, le tri ou la transformation des données.

Paramètres

  • path: chemin d'accès au champ du tableau à dérouler.

  • includeArrayIndex: (facultatif) Spécifie le nom du nouveau champ contenant l'index de l'élément du tableau.

  • preserveNullAndEmptyArrays: (facultatif) Détermine si l'opération conserve le document original lorsque le champ du tableau est nul ou s'il s'agit d'un tableau vide.

Exemple (MongoDB Shell)

L'exemple suivant montre comment utiliser l'$unwindopérateur pour déconstruire un champ de tableau et effectuer d'autres opérations sur les éléments individuels.

Création d'exemples de documents

db.people.insertMany([
  { _id: 1, name: "jon", hobbies: ["painting", "dancing", "singing"] },
  { _id: 2, name: "jane", hobbies: ["reading", "swimming"] },
  { _id: 3, name: "jack", hobbies: [] }
])

Exemple de requête

db.people.aggregate([
  { $unwind: "$hobbies" }
])

Sortie

[
  { _id: 1, name: 'jon', hobbies: 'painting' },
  { _id: 1, name: 'jon', hobbies: 'dancing' },
  { _id: 1, name: 'jon', hobbies: 'singing' },
  { _id: 2, name: 'jane', hobbies: 'reading' },
  { _id: 2, name: 'jane', hobbies: 'swimming' }
]

Exemples de code

Pour afficher un exemple de code relatif à l'utilisation de la $unwind 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 collection = db.collection('people');

  const result = await collection.aggregate([
    { $unwind: '$hobbies' }
  ]).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['people']

    result = list(collection.aggregate([
        { '$unwind': '$hobbies' }
    ]))

    print(result)
    client.close()

example()