$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 collection 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, documentos com o mesmo valor podem ser classificados de forma diferente entre 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 classificação consistente, adicione um campo que contenha apenas valores únicos à classificação. O comando a seguir classifica o campo year e o 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 documentos da collection 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 sort
db.movies.aggregate( [
   {
      $match: {
         title: { $in: [
            "The Comancheros", "The Son of the Sheik"
         ] }
      }
   },
   {
      $sort: { genres: 1 }
   }
] )

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

Ambas as queries anteriores retornam The Comancheros primeiro porque Action e Western são as entradas mais baixa e mais alta em sua array 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 consulta a seguir encontra filmes cuja array genres inclui "Drama" ou "Western" e classifica 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 classificação é ascendente. A chave de classificação é o primeiro valor na array genres quando classificada alfabeticamente:

• Em The Comancheros, o primeiro elemento genres é Action. Este valor é utilizado como a chave de classificaçã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 a chave de classificação mesmo que não corresponda ao filtro.

A query retorna The Comancheros primeiro.

Operador e memória $sort

$sort e $limit Otimização de Memória

Quando um$sortprecede um$limite não há estágios intermediários que modifiquem o número de documentos, o otimizador pode unir o$limitao$sort. Isso permite que a operação$sortmantenha 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 também 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 do Índice $sort

O operador $sort pode usar um índice quando ele é o primeiro estágio de um pipeline ou é precedido somente por um estágio$match.

Quando você usa $sort em um cluster fragmentado, cada shard ordena seus documentos de resultado usando um índice, quando disponível. Em seguida,mongos ou um dos shards executa uma ordenação de mesclagem transmitida.