Agrupamentos

Variantes locais

Algumas localidades de agrupamento têm variantes, que empregam regras especiais específicas de idioma. Para especificar uma variante de localidade, use a seguinte sintaxe:

{ "locale" : "<locale code>@collation=<variant>" }

Por exemplo, para usar a variante unihan do agrupamento chinês:

{ "locale" : "zh@collation=unihan" }

Para obter uma lista completa de todas as localidades de agrupamento e suas variantes, consulte Localidades de agrupamento.

Agrupamentos e visualizações

• Você pode especificar um agrupamento padrão para uma visualização no momento da criação. Se nenhum agrupamento for especificado, o agrupamento padrão da visualização será o coletor de comparação binária "simples". Ou seja, a visualização não herda o agrupamento padrão da collection.

• As comparações de strings na visualização usam o agrupamento padrão da visualização. Uma operação que tenta alterar ou substituir a coleta padrão de uma visualização falhará com um erro.

• Se estiver criando um modo de exibição a partir de outro modo de exibição, você não poderá especificar um agrupamento que difere do agrupamento do modo de exibição de origem.

• Se executar uma agregação que envolve múltiplas visualizações, como com $lookup ou $graphLookup, as visualizações deverão ter o mesmo agrupamento.

Agrupamento e uso do índice

Para usar um índice para comparações de strings, uma operação também deve especificar o mesmo agrupamento. Ou seja, um índice com ordenação não pode suportar uma operação que executa comparações de strings nos campos indexados se a operação especificar uma ordenação diferente.

Por exemplo, a coleta myColl possui um índice em um campo de sequência category com o código do idioma de ordenação "fr".

db.myColl.createIndex( { category: 1 }, { collation: { locale: "fr" } } )

A seguinte operação de consulta, que especifica o mesmo agrupamento que o índice, pode usar o índice:

db.myColl.find( { category: "cafe" } ).collation( { locale: "fr" } )

No entanto, a seguinte operação de consulta, que por padrão usa o agrupador binário "simples", não pode usar o índice:

db.myColl.find( { category: "cafe" } )

Para um índice composto em que as chaves de prefixo do índice não são strings, matrizes e documentos incorporados, uma operação que especifica um agrupamento diferente ainda pode usar o índice para dar suporte a comparações nas chaves de prefixo do índice.

Por exemplo, a coleta myColl possui um índice composto nos campos numéricos score e price e no campo de string category; o índice é criado com a localidade de ordenação "fr" para comparações de strings:

db.myColl.createIndex(
   { score: 1, price: 1, category: 1 },
   { collation: { locale: "fr" } } )

As operações a seguir, que usam agrupamento binário "simple" para comparações de strings, podem usar o índice:

db.myColl.find( { score: 5 } ).sort( { price: 1 } )
db.myColl.find( { score: 5, price: { $gt: NumberDecimal( "10" ) } } ).sort( { price: 1 } )

A operação a seguir, que usa agrupamento binário "simple" para comparações de strings no campo category indexado, pode usar o índice para preencher apenas a parte score: 5 da query:

db.myColl.find( { score: 5, category: "cafe" } )

numericOrdering

Ao especificar numericOrdering como true as seguintes restrições se aplicam:

• Somente substrings contíguos de números inteiros não negativos são considerados nas comparações.

  numericOrdering não suporta:

  • +

  • -

  • separadores decimais, como pontos decimais e vírgulas decimais

  • expoentes

• Somente pontos de código Unicode na categoria Número ou Dígito Decimal (Nd) são tratados como dígitos.

• Se o comprimento de um dígito exceder 254 caracteres, o excesso de caracteres será tratado como um número separado.

Considere uma coleta com o seguinte número de string e valores decimais:

db.c.insertMany(
  [
      { "n" : "1" },
      { "n" : "2" },
      { "n" : "2.1" },
      { "n" : "-2.1" },
      { "n" : "2.2" },
      { "n" : "2.10" },
      { "n" : "2.20" },
      { "n" : "-10" },
      { "n" : "10" },
      { "n" : "20" },
      { "n" : "20.1" }
  ]
)

A query find a seguir usa um documento de agrupamento que contém o parâmetro numericOrdering:

db.c.find(
   { }, { _id: 0 }
).sort(
  { n: 1 }
).collation( {
  locale: 'en_US',
  numericOrdering: true
} )

A operação retorna os seguintes resultados:

[
    { n: '-2.1' },
    { n: '-10' },
    { n: '1' },
    { n: '2' },
    { n: '2.1' },
    { n: '2.2' },
    { n: '2.10' },
    { n: '2.20' },
    { n: '10' },
    { n: '20' },
    { n: '20.1' }
]

• numericOrdering: true ordenar os valores da string em ordem crescente como se fossem valores numéricos.

• Os dois valores negativos -2.1 e -10 não são classificados na ordem de classificação esperada porque têm - caracteres não suportados.

• O valor 2.2 é classificado antes do valor 2.10, devido ao fato de que o parâmetro numericOrdering não suporta valores decimais.

• Como resultado, 2.2 e 2.10 são ordenados em ordem lexicográfica.