cursor.collat​​ion（）

定义¶

cursor.collation（<归类文档> ）¶

mongo 壳法

此页面记录了mongoshell方法，并且 没有引用MongoDB Node.js驱动程序（或任何其他驱动程序）方法。对于相应的MongoDB驱动程序API，请改为参考您特定的 MongoDB驱动程序文档。

3.4版的新功能。

指定由返回的游标的排序规则db.collection.find()。要使用，请附加到 db.collection.find()。

所述cursor.collation()接受下列整理文件：

复制

{
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

指定排序规则时，该locale字段为必填字段；所有其他排序规则字段都是可选的。有关字段的说明，请参见整理文档。

领域	类型	描述
locale	串	ICU语言环境。有关支持的语言环境的列表，请参见支持的语言和语言环境。 要指定简单的二进制比较，请指定的locale值 "simple"。
strength	整数	可选的。要执行的比较级别。对应于ICU比较级别。可能的值为： 值 描述 1个 主要比较水平。归类仅对基本字符进行比较，而忽略了其他区别，如变音符号和大小写。 2 二级比较。归类进行比较直到次要差异，例如变音符号。即，归类执行基本字符（主要区别）和变音符号（次要区别）的比较。基本字符之间的差异优先于次要差异。 3 第三层次的比较。排序规则进行比较直到三级差异，例如大小写和字母变体。也就是说，排序规则将比较基本字符（主要区别），变音符号（次要区别）以及大小写和变体（三次区别）。基本字符之间的差异优先于次要差异，次要差异优先于三次差异。 这是默认级别。 4 第四级。仅限于特定用例，以在1-3级忽略标点符号时处理标点符号或用于处理日语文本。 5 相同级别。仅限于平局决胜局的特定用例。 有关 详细信息，请参见ICU整理：比较级别。
caseLevel	布尔值	可选的。用于确定是否在strength级别1或包括案例比较的标志 2。 如果true，包括案例比较；即 与结合使用时strength:1，排序规则比较基本字符和大小写。 与搭配使用时strength:2，排序规则会比较基本字符，变音符号（以及其他可能的次要区别）和大小写。 如果是false，则不包括在1或 级别的案例比较2。默认值为false。 有关更多信息，请参阅ICU整理：案例级别。
caseFirst	串	可选的。在第三级比较期间确定大小写差异的排序顺序的字段。 可能的值为： 值 描述 “上” 大写在小写之前排序。 “降低” 小写在大写之前排序。 “关闭” 默认值。相似之处"lower"略有不同。有关 差异的详细信息，请参见 http://userguide.icu-project.org/collat​​ion/customization。
numericOrdering	布尔值	可选的。用于确定将数字字符串比较为数字还是字符串的标志。 如果为true，则比较为数字；即"10"大于 "2"。 如果为false，则比较为字符串；否则为。即"10"小于"2"。 默认值为false。
alternate	串	可选的。确定排序规则是否应将空格和标点符号视为基本字符以便进行比较的字段。 可能的值为： 值 描述 "non-ignorable" 空格和标点符号被认为是基本字符。 "shifted" 空格和标点符号不被视为基本字符，仅在强度级别大于3时才被区分。 有关 更多信息，请参见ICU整理：比较级别。 默认值为"non-ignorable"。
maxVariable	串	可选的。确定时哪些字符可忽略的字段。如果没有效果 alternate: "shifted"alternate: "non-ignorable" 可能的值为： 值 描述 "punct" 空格和标点符号都是“可忽略的”，即不被视为基本字符。 "space" 空格是“可忽略的”，即不被视为基本字符。
backwards	布尔值	可选的。用于确定是否带有变音符号的字符串从字符串的后面进行排序的标志，例如某些法语词典的排序。 如果为true，则从前到后进行比较。 如果为false，则从前到后进行比较。 默认值为false。
normalization	布尔值	可选的。用于确定是否检查文本是否需要规范化并执行规范化的标志。通常，大多数文本不需要此规范化处理。 如果为true，请检查是否已完全标准化，然后执行标准化以比较文本。 如果为false，则不检查。 默认值为false。 有关详细信息，请参见 http://userguide.icu-project.org/collat​​ion/concepts#TOC-Normalization。

例子¶

考虑foo包含以下文档的集合：

{ "_id" : 1, "x" : "a" }
{ "_id" : 2, "x" : "A" }
{ "_id" : 3, "x" : "á" }

以下操作将查询过滤器指定为。该操作还包括一个排序规则选项，带有 （美国英语语言环境）和（仅比较基本字符；即忽略大小写和变音符号）：x: "a"locale: "en_US"strength: 1

db.foo.find( { x: "a" } ).collation( { locale: "en_US", strength: 1 } )

该操作返回以下文档：

{ "_id" : 1, "x" : "a" }
{ "_id" : 2, "x" : "A" }
{ "_id" : 3, "x" : "á" }

如果您未指定排序规则，即查询仅匹配以下文档：db.collection.find( { x: "a" } )

db.foo.find( { x: "a" } )

您可以将其他游标方法（例如cursor.sort() 和cursor.count()）链接到cursor.collation()：

db.collection.find({...}).collation({...}).sort({...});
db.collection.find({...}).collation({...}).count();