$sort (estágio de agregação )

Desempenho

$sort é um estágio de bloqueio, que faz com que o pipeline espere que todos os dados de entrada sejam recuperados para o estágio de bloqueio antes de processar os dados. Um estágio de bloqueio pode reduzir o desempenho porque reduz o processamento paralelo de um pipeline com vários estágios. Um estágio de bloqueio também pode usar quantidades substanciais de memória para grandes conjuntos de dados.

Limites

• Você pode ordenar o máximo de 32 chaves.

• Fornecer um padrão de classificação com campos duplicados causa um erro.

Consistência da ordenação

O MongoDB não armazena documentos em uma collection em uma ordem específica. Ao ordenar em um campo que contém valores duplicados, os documentos que contêm esses valores podem ser retornados em qualquer ordem.

A operação $sort não é uma "classificação estável", o que significa que documentos com chaves de classificação equivalentes não têm garantia de permanecer na mesma ordem relativa na saída como estavam na entrada.

Se o campo especificado nos critérios de classificação não existir em dois documentos, então o valor pelo qual eles são classificados é o mesmo. Os dois documentos podem ser retornados em qualquer ordem.

Se desejar uma ordem de classificação consistente, inclua pelo menos um campo em sua ordenação que contenha valores exclusivos. A maneira mais fácil de garantir isso é incluir o campo _id em sua query de ordenação.

Considere a coleção movies no conjunto de dados de amostra sample_mflix. O comando a seguir classifica os filmes lançados em 1925 ou 1926 por year em ordem crescente:

db.movies.aggregate( [   { $match: { year: { $in: [ 1925, 1926 ] } } },   { $sort: { year: 1 } },   { $project: { _id: 0, title: 1, year: 1 } }] )

Como o campo year tem valores duplicados para 1925 e 1926, os documento com o mesmo valor podem ser classificados de forma diferente entre as execuções. Por exemplo, duas execuções do comando anterior produzem ordenações diferentes:

[   { title: "Clash of the Wolves", year: 1925 },   { title: "Lady Windermere's Fan", year: 1925 },   { title: "Grass: A Nation's Battle for Life", year: 1925 },   { title: "Beau Geste", year: 1926 },   { title: "The Black Pirate", year: 1926 },   { title: "Ella Cinders", year: 1926 },   { title: "For Heaven's Sake", year: 1926 },   { title: "The Son of the Sheik", year: 1926 },   { title: "The Strong Man", year: 1926 }]

[   { title: "Lady Windermere's Fan", year: 1925 },   { title: "Grass: A Nation's Battle for Life", year: 1925 },   { title: "Clash of the Wolves", year: 1925 },   { title: "The Strong Man", year: 1926 },   { title: "The Black Pirate", year: 1926 },   { title: "Ella Cinders", year: 1926 },   { title: "Beau Geste", year: 1926 },   { title: "The Son of the Sheik", year: 1926 },   { title: "For Heaven's Sake", year: 1926 }]

Uma operação classifica os valores para year em ordem crescente, mas a ordem dos documentos que contêm valores duplicados para year não é a mesma. Por exemplo, valores duplicados para 1925 e 1926.

Para obter uma ordenação consistente, adicione um campo que contenha apenas valores exclusivos à ordenação. O comando a seguir ordena tanto no campo year quanto no campo _id:

db.movies.aggregate( [   { $match: { year: { $in: [ 1925, 1926 ] } } },   { $sort: { year: 1, _id: 1 } }] )

O campo _id sempre contém valores exclusivos e a ordem de classificação é consistente para várias execuções de classificação.

Classificar por um Campo de Array

Quando o MongoDB classifica documentos por um campo de valor de matriz, a chave de classificação depende se a classificação é crescente ou decrescente:

• Em uma classificação ascendente, a chave de classificação é o menor valor na array.

• Em uma classificação decrescente, a chave de classificação é o valor mais alto na array.

O filtro de consulta não afeta a seleção da chave de classificação.

Por exemplo, considere estes documento da coleção movies no conjunto de dados de amostra sample_mflix:

{  _id: ObjectId("573a1395f29313caabce166c"),  title: "The Comancheros",  genres: [ "Action", "Western", "Adventure" ]}{  _id: ObjectId("573a1391f29313caabcd8521"),  title: "The Son of the Sheik",  genres: [ "Adventure", "Drama" ]}

As seguintes consultas classificam os documentos pelo campo genres em ordem crescente e decrescente:

// Ascending sortdb.movies.aggregate( [   {      $match: {         title: { $in: [            "The Comancheros", "The Son of the Sheik"         ] }      }   },   {      $sort: { genres: 1 }   }] )

// Descending sortdb.movies.aggregate( [   {      $match: {         title: { $in: [            "The Comancheros", "The Son of the Sheik"         ] }      }   },   {      $sort: { genres: -1 }   }] )

Ambas as consultas anteriores retornam The Comancheros primeiro porque Action e Western são as entradas mais baixas e mais altas em sua matriz genres, respectivamente.

Filtrar e ordenar por um campo de Array

Quando você filtra e ordena por um campo que contém um array, o filtro não altera o valor utilizado como chave de ordenação. A ordenação sempre considera todos os valores do array como possíveis chaves de ordenação.

Por exemplo, a query a seguir encontra filmes cujo array genres inclui "Drama" ou "Western" e ordena os resultados por genres em ordem crescente:

db.movies.aggregate( [   {      $match: {         title: { $in: [            "The Comancheros", "The Son of the Sheik"         ] },         genres: { $in: [ "Drama", "Western" ] }      }   },   {      $sort: { genres: 1 }   }] )

A ordenação é crescente. A chave de classificação é o primeiro valor no array genres quando classificado alfabeticamente:

• Em The Comancheros, o primeiro elemento genres é Action. Este valor é utilizado como chave de ordenação, mesmo que não corresponda ao filtro { genres: { $in: [ "Drama", "Western" ] } }.

• Em The Son of the Sheik, o primeiro elemento genres é Adventure. Da mesma forma, esta operação utiliza Adventure como chave de ordenação, mesmo que não corresponda ao filtro.

A query retorna The Comancheros primeiro.

Operador $sort e memória

Otimização de memória com $sort e $limit

Quando um $sort precede um $limit e não há estágios intermediários que modifiquem o número de documentos, o otimizador pode unir o $limit ao $sort. Isso permite que a operação $sort mantenha somente os principais resultados n conforme progride, onde n é o limite especificado, e garante que o MongoDB somente precise armazenar itens n na memória. Essa otimização ainda se aplica quando allowDiskUse for true e os itens n excederem o limite de memória de agregação.

As otimizações estão sujeitas a alterações entre as versões.

$sort e Restrições de Memória

Estágios de pipeline que exigem mais de 100 megabytes de memória para executar, gravam arquivos temporários em disco por padrão. Esses arquivos temporários duram durante a execução do pipeline e podem influenciar o espaço de armazenamento em sua instância.

Somente find e aggregate comandos podem substituir o parâmetro allowDiskUseByDefault por um ou outro:

• Usando { allowDiskUse: true } para permitir a gravação de arquivos temporários no disco quando allowDiskUseByDefault estiver definido como false

• Usando { allowDiskUse: false } para proibir a gravação de arquivos temporários no disco quando allowDiskUseByDefault estiver definido como true

Para obter mais detalhes, consulte Limites do pipeline de agregação.

Uso de $sort e índice

O operador $sort pode usar um índice quando for o primeiro estágio em um pipeline ou for precedido apenas por um estágio $match.

Ao usar $sort em um cluster, cada shard ordena seus documentos de resultado usando um índice, quando disponível. Em seguida, mongos ou um dos fragmentos executa uma ordenação de mesclagem transmitida.