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.

# $SortArray
<a name="sortArray"></a>

Nouveau depuis la version 8.0

Non pris en charge par le cluster Elastic.

L'`$sortArray`opérateur dans Amazon DocumentDB trie les éléments d'un tableau. Pour les tableaux de valeurs scalaires, le tableau est trié par valeur d'élément. Pour les tableaux de documents, le tableau est trié en fonction du ou des champs spécifiés. L'opérateur renvoie le tableau trié par ordre croissant (`1`) ou décroissant (`-1`).

**Note**  
`$sortArray`est pris en charge au `$project` stade du pipeline d'agrégation avec le planificateur de requêtes version 3.

**Syntaxe**

```
{ $sortArray: { input: <array>, sortBy: <sort specification> } }
```

**Paramètres**
+ `input`: le tableau à trier.
+ `sortBy`: L'ordre de tri. Pour un tableau de valeurs scalaires, spécifiez `1` une valeur ascendante ou `-1` descendante. Pour un tableau de documents, spécifiez un document du formulaire `{ field: 1 }` ou `{ field: -1 }` pour chaque champ à trier.

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

L'exemple suivant montre comment utiliser l'`$sortArray`opérateur pour trier les éléments d'un tableau par ordre croissant.

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

```
db.miles.insertMany([
  { "_id" : 1, "member_since" : ISODate("1987-01-01T00:00:00Z"), "credit_card" : false, "flight_miles" : [ 1205, 2560, 880 ]},
  { "_id" : 2, "member_since" : ISODate("1982-01-01T00:00:00Z"), "credit_card" : true, "flight_miles" : [ 1205, 2560, 890, 2780]},
  { "_id" : 3, "member_since" : ISODate("1999-01-01T00:00:00Z"), "credit_card" : true, "flight_miles" : [ 1205, 880]}
]);
```

**Exemple de requête**

```
db.miles.aggregate([
  {
    $project: {
      _id: 1,
      member_since: 1,
      credit_card: 1,
      sorted_flight_miles: { $sortArray: { input: "$flight_miles", sortBy: 1 } }
    }
  }
]);
```

**Sortie**

```
{ "_id" : 1, "member_since" : ISODate("1987-01-01T00:00:00Z"), "credit_card" : false, "sorted_flight_miles" : [ 880, 1205, 2560 ] }
{ "_id" : 2, "member_since" : ISODate("1982-01-01T00:00:00Z"), "credit_card" : true, "sorted_flight_miles" : [ 890, 1205, 2560, 2780 ] }
{ "_id" : 3, "member_since" : ISODate("1999-01-01T00:00:00Z"), "credit_card" : true, "sorted_flight_miles" : [ 880, 1205 ] }
```

Dans cet exemple, l'`$sortArray`opérateur trie le `flight_miles` tableau par ordre croissant. Le `sorted_flight_miles` champ obtenu dans la sortie affiche les éléments du tableau dans un ordre trié.

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

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

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

Voici un exemple d'utilisation de l'`$sortArray`opérateur dans une Node.js application :

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

async function sortArray() {
  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('miles');

  const result = await collection.aggregate([
    {
      $project: {
        _id: 1,
        member_since: 1,
        credit_card: 1,
        sorted_flight_miles: { $sortArray: { input: '$flight_miles', sortBy: 1 } }
      }
    }
  ]).toArray();

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

sortArray();
```

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

Voici un exemple d'utilisation de l'`$sortArray`opérateur dans une application Python :

```
from pymongo import MongoClient

def sort_array():
    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.miles

    result = list(collection.aggregate([
        {
            '$project': {
                '_id': 1,
                'member_since': 1,
                'credit_card': 1,
                'sorted_flight_miles': { '$sortArray': { 'input': '$flight_miles', 'sortBy': 1 } }
            }
        }
    ]))

    print(result)
    client.close()

sort_array()
```

------