排序规则(Collations)

Overview

在本指南中，您可以了解如何使用排序规则按字符串值对查找或聚合操作结果进行排序。 排序规则是与特定语言和区域设置相对应的一组字符排序约定。

本指南包括以下部分：

• MongoDB排序规则描述MongoDB如何根据默认排序规则和自定义排序规则对string值进行排序

• 指定排序规则描述了如何创建 Collation结构体实例

• 在集合上设置排序规则描述了如何为新集合设置排序规则

• 在索引上设置排序规则描述了如何为索引设立排序规则

• 对操作设置排序规则描述了如何将排序规则应用于某些 CRUD 操作

• 附加信息提供了本指南中提到的类型和方法的资源和 API 文档链接

MongoDB 排序规则

MongoDB 默认使用二进制排序规则对字符串进行排序。 此排序规则方法使用 ASCII 标准字符值对字符串进行比较和排序。 某些语言和区域设置具有与 ASCII 标准不同的特定字符排序约定。

例如，在加拿大法语中，当其他字符相同时，最右边的重音字符决定字符串的顺序。 考虑以下加拿大法语单词：

• cote

• coté

• côte

• côté

使用默认的二进制排序规则时，MongoDB 按以下顺序对单词进行排序：

cote
coté
côte
côté

在此排序顺序中，“coté”位于“côte”之前，因为 ASCII 标准将字符“o”置于字符“ô”之前。

使用加拿大法语排序规则时，MongoDB 按以下顺序对单词进行排序：

cote
côte
coté
côté

在此排序顺序中，“coté”位于“côte”之后，因为加拿大法语排序规则将字符“e”置于字符“é”之前。

指定排序规则

您可以通过在Collation结构实例中指定排序规则区域设置和其他选项来定义排序规则。 要开始构建Collation实例，请调用Collation::builder()方法。

下表描述了可用于设置Collation实例字段的构建器方法。 您必须使用locale()方法构建有效的Collation结构体，但所有其他构建器方法都是可选的：

let collation = Collation::builder()
    .locale("en_US")
    .build();

对collection设置排序规则

创建新集合时，可以为将来对该集合调用的操作定义排序规则。 通过将collation()函数链接到create_collection()方法，将Collation实例作为参数传递给collation()来设置排序规则。

let collation = Collation::builder()
    .locale("fr")
    .strength(CollationStrength::Primary)
    .build();
let result = my_db.create_collection("books")
    .collation(collation)
    .await?;

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

let query = doc! { "name": doc! { "$lt": "Infinite Jest" } };
let mut cursor = my_coll.find(query).await?;
while let Some(doc) = cursor.try_next().await? {
   println!("{}", doc);
}

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

对索引设置排序规则

在collection上创建新索引时，可以为索引涵盖的操作定义排序规则。要运行使用索引及其排序规则的操作，操作和索引必须指定相同的排序规则。

使用collation()函数构建IndexOptions实例来设置索引排序规则。 然后，将IndexOptions作为参数传递给IndexModel构建器函数，并将IndexModel作为参数传递给create_index()方法。

let collation = Collation::builder()
    .locale("en_US")
    .build();
let index_opts = IndexOptions::builder()
    .collation(collation)
    .build();
let index = IndexModel::builder()
    .keys(doc! { "name": 1 })
    .options(index_opts)
    .build();
let result = my_coll.create_index(index).await?;
println!("Created index: {}", result.index_name);

 Created index: name_1

为操作设置排序规则

从collection中读取、更新和删除文档的操作可以使用排序规则。 将排序规则应用于操作会覆盖之前为collection或索引定义的任何排序规则。

如果对操作应用的排序规则与索引的排序规则不同，则无法使用该索引。 因此，该操作的执行效率可能不如索引所涵盖的操作。 有关索引未涵盖的排序操作缺点的更多信息，请参阅服务器手册中的使用索引对查询结果进行排序。

let collation = Collation::builder()
    .locale("en_US")
    .numeric_ordering(true)
    .build();
let filter = doc! { "length": doc! { "$gt": "1000" } };
let mut cursor = my_coll.find(filter)
    .collation(collation)
    .await?;
while let Some(result) = cursor.try_next().await? {
    println!("{}", result);
};

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

更多信息

要了解有关find()方法的更多信息，请参阅检索数据指南。

要了解有关排序规则的更多信息，请参阅以下服务器手册页：

• 排序规则

• 排序规则区域设置和默认参数