Intercalaciones

Overview

En esta guía, aprenderá a usar intercalaciones para ordenar los resultados de sus consultas o agregaciones por valores de cadena. Una intercalación es un conjunto de convenciones de ordenación de caracteres que se aplican a un idioma y una configuración regional específicos.

Intercalaciones en MongoDB

MongoDB ordena las cadenas mediante intercalación binaria de forma predeterminada. Este método de intercalación utiliza Valores de caracteres estándar ASCII para comparar y ordenar cadenas. Algunos idiomas y configuraciones regionales tienen convenciones específicas de ordenación de caracteres que difieren del estándar ASCII.

Por ejemplo, en francés canadiense, el carácter acentuado más a la derecha determina el orden de las cadenas cuando los demás caracteres son iguales. Considere las siguientes palabras en francés canadiense:

• redil

• coté

• côte

• côté

Al utilizar la intercalación binaria predeterminada, MongoDB los ordena en el siguiente orden:

cote
coté
côte
côté

Al utilizar la intercalación francesa canadiense, MongoDB los ordena en el siguiente orden:

cote
côte
coté
côté

Especifica una intercalación

Para especificar una intercalación, cree un Collation Objeto. Debe definir el campo Locale del objeto Collation; los demás campos son opcionales. Por ejemplo, el siguiente ejemplo de código especifica un objeto Collation con la intercalación de configuración regional "en_US":

myCollation := &options.Collation{Locale: "en_US"}

Para obtener una lista completa de los campos Collation de objeto, visite la documentación de la API de intercalación. Para ver todas las configuraciones regionales compatibles y los valores predeterminados de los Locale campos, visite Idiomas y configuraciones regionales compatibles.

Establecer una intercalación en una colección o vista

Puedes aplicar una intercalación al crear una nueva colección o vista. Esto define la intercalación predeterminada para cualquier operación realizada en esa colección o vista. Establece una intercalación mediante un objeto CreateCollectionOptions o CreateViewOptions. A continuación, llama al método CreateCollection() o CreateView() con el objeto de opciones como argumento.

myCollation := &options.Collation{Locale: "fr", Strength: 1}
opts := options.CreateCollection().SetCollation(myCollation)
err := db.CreateCollection(context.TODO(), "books", opts)
if err != nil {
   panic(err)
}

{"name" : "Emma", "length" : "474"}
{"name" : "Les Misérables", "length": "1462"}
{"name" : "Infinite Jest", "length" : "1104"}
{"name" : "Cryptonomicon", "length" : "918"}
{"name" : "Ça", "length" : "1138"}

filter := bson.D{{"name", bson.D{{"$lt", "Infinite Jest"}}}}
cursor, err := coll.Find(context.TODO(), filter)
if err != nil {
   panic(err)
}
var results []bson.D
if err = cursor.All(context.TODO(), &results); err != nil {
   panic(err)
}
for _, result := range results {
   res, _ := bson.MarshalExtJSON(result, false, false)
   fmt.Println(string(res))
}

{"name":"Emma","length":"474"}
{"name":"Cryptonomicon","length":"918"}
{"name":"Ça","length":"1138"}

{"name":"Emma","length":"474"}
{"name":"Cryptonomicon","length":"918"}

Establece una intercalación en un índice

Puedes aplicar una intercalación al crear un nuevo índice en una colección. El índice almacena una representación ordenada de los documentos de la colección, por lo que tu instancia de MongoDB no realiza la ordenación de las operaciones de ordenación en memoria.

Para usar el índice en una operación, esta debe usar la misma intercalación que la especificada en el índice. Además, asegúrese de que la operación esté cubierta por el índice que contiene la intercalación. Establezca una intercalación mediante un objeto IndexOptions y páselo como argumento al método CreateOne().

 myCollation := &options.Collation{Locale: "en_US"}
 opts := options.Index().SetCollation(myCollation)
 indexModel := mongo.IndexModel{
   Keys:    bson.D{{"name", 1}},
   Options: opts,
 }
 name, err := coll.Indexes().CreateOne(context.TODO(), indexModel)
 if err != nil {
   panic(err)
 }
 fmt.Println("Name of Index Created: " + name)

 Name of Index Created: name_1

Establecer una intercalación en una operación

Las operaciones que leen, actualizan y eliminan documentos de una colección pueden utilizar intercalaciones. Al aplicar una intercalación a una operación se anula cualquier intercalación por defecto previamente definida para una colección.

Si aplica una nueva intercalación a una operación que difiere de la intercalación de un índice, no podrá usar ese índice. Como resultado, la operación podría no funcionar tan bien como una que esté cubierta por un índice. Para obtener más información sobre las desventajas de las operaciones de ordenación no cubiertas por un índice, consulte "Usar índices para ordenar los resultados de consultas". Consulte el manual de MongoDB para obtener una lista de las operaciones que admiten la intercalación.

filter := bson.D{{"length", bson.D{{"$gt", "1000"}}}}
myCollation := &options.Collation{Locale: "en_US", NumericOrdering: true}
opts := options.Find().SetCollation(myCollation)
cursor, err := coll.Find(context.TODO(), filter, opts)
if err != nil {
   panic(err)
}
var results []bson.D
if err = cursor.All(context.TODO(), &results); err != nil {
   panic(err)
}
for _, result := range results {
   res, _ := bson.MarshalExtJSON(result, false, false)
   fmt.Println(string(res))
}

{"name":"Les Misérables","length":"1462"}
{"name":"Infinite Jest","length":"1104"}
{"name":"Ça","length":"1138"}

{"name":"Emma","length":"474"}
{"name":"Les Misérables","length":"1462"}
{""name":"Infinite Jest","length":"1104"}
{"name":"Cryptonomicon","length":"918"}
{"name":"Ça","length":"1138"}

Información Adicional

Para obtener más información sobre el Find() método, consulte la guía Recuperar datos.

Para obtener más información sobre las intercalaciones, visite las siguientes páginas del manual:

• Intercalación

• Configuraciones regionales de intercalación y parámetros predeterminados