Intercalación

Variantes locales

Algunas localizaciones de intercalación tienen variantes que usan reglas específicas del lenguaje. Para especificar una variante de localización, utilice la siguiente sintaxis:

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

Por ejemplo, para utilizar la variante unihan de la intercalación china:

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

Para obtener una lista completa de todas las localizaciones de intercalación y sus variantes, consulte Localizaciones de intercalación.

Intercalación y vistas

• Puede especificar una intercalación por defecto para una vista al momento de su creación. Si no se especifica ninguna intercalación, la intercalación por defecto de la vista es el intercalador de comparación binaria "simple". Es decir, la vista no hereda la intercalación por defecto de la colección.

• Las comparaciones de string en la vista utilizan la intercalación por defecto de la vista. Una operación que intente cambiar o sobrescribir la intercalación por defecto de una vista fallará con un error.

• Si crea una vista a partir de otra vista, no puede especificar una intercalación que difiera de la intercalación de la vista de origen.

• Si realiza una agregación que implique varias vistas, como con $lookup o $graphLookup, las vistas deben tener la misma intercalación.

Uso de la intercalación y del índice

Para utilizar un índice para las comparaciones de cadenas, una operación también debe especificar la misma intercalación. Es decir, un índice con una intercalación no puede soportar una operación que realice comparaciones de strings en los campos indexados si la operación especifica una intercalación diferente.

Una colección restaurants tiene los siguientes documentos:

db.restaurants.insertMany( [
   { _id: 1, category: "café", status: "Open" },
   { _id: 2, category: "cafe", status: "open" },
   { _id: 3, category: "cafE", status: "open" }
] )

La colección restaurants tiene un índice en un campo de string category con la intercalación de la localización "fr".

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

La siguiente query, que especifica la misma intercalación que el índice, puede utilizar el índice:

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

Sin embargo, la siguiente operación de query, que por defecto utiliza el intercalador binario "simple", no puede usarse el índice:

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

Para un índice compuesto donde las claves prefijo del índice no son cadenas, arreglos ni documentos incrustados, una operación que especifique una intercalación diferente puede seguir utilizando el índice para soportar comparaciones en las claves prefijo del índice.

Por ejemplo, la colección restaurants tiene un índice compuesto en los campos numéricos score y price y el campo de string category; el índice se crea con la localización de intercalación "fr" para comparaciones de strings:

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

Las siguientes operaciones, que utilizan la intercalación binaria "simple" para las comparaciones de strings, pueden usar el índice:

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

La siguiente operación, que utiliza la intercalación binaria "simple" para las comparaciones de string en el campo category indexado, puede usar el índice para cumplir solo con la parte score: 5 de la query:

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

Para confirmar si una consulta ha utilizado un índice, ejecuta la consulta con la opción explain().

Ordenación numérica

Al especificar el numericOrdering como true, se aplican las siguientes restricciones:

• Solo se consideran en las comparaciones las substrings de enteros no negativos contiguos de dígitos.

  numericOrdering no soporta:

  • +

  • -

  • separadores decimales, como puntos y comas decimales

  • exponentes

• Solo los puntos de código Unicode en la categoría de Número o dígito decimal (Nd) se consideran dígitos.

• Si la longitud de un número supera los 254 caracteres, los caracteres excedentes se tratan como un número independiente.

Considere una colección con los siguientes valores de strings numéricas y decimales:

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" }
  ]
)

El siguiente query find utiliza un documento de intercalación que contiene el parámetro numericOrdering:

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

La operación devuelve los siguientes 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 ordena los valores de strings en orden ascendente como si fueran valores numéricos.

• Los dos valores negativos -2.1 y -10 no están ordenados en el orden de clasificación esperado porque tienen caracteres - no admitidos.

• El valor 2.2 se ordena antes que el valor 2.10, debido a que el parámetro numericOrdering no admite valores decimales.

• Como resultado, 2.2 y 2.10 se ordenan en orden lexicográfico.