照合

ローカル バリアント

一部の照合ロケールには、言語固有の特別なルールを使用するバリアントがあります。ロケール バリアントを指定するには、次の構文を使用します。

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

たとえば、中国語照合の unihan バリアントを使用するには、次のようにします。

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

すべての照合ロケールとそのバリエーションの完全なリストについては、「照合ロケール」を参照してください。

照合とビュー

• ビューの作成時にデフォルトの照合を指定できます。照合順序が指定されていない場合、ビューのデフォルトの照合は "simple" バイナリ比較照合子です。つまり、ビューはコレクションのデフォルトの照合を継承しません。

• ビューでの文字列比較では、ビューのデフォルトの照合方法が使用されます。ビューのデフォルトの照合方法を変更または上書きしようとする操作は、エラーとなり、失敗します。

• 別のビューからビューを作成する場合、ソース ビューの照合方法と異なる照合方法を指定することはできません。

• 複数のビューが関わる集計（$lookup や $graphLookup など）が実行される場合、それらのビューには同じ照合が含まれる必要があります。

照合とインデックスの使用

文字列の比較にインデックスを使用するには、操作で同じ照合も指定する必要があります。つまり、照合順序を持つインデックスでは、操作で異なる照合順序が指定されている場合、インデックス付きフィールドで文字列比較を実行する操作をサポートできません。

たとえば、コレクション myColl には、照合ロケール "fr" を持つ文字列フィールド category のインデックスがあります。

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

インデックスと同じ照合を指定する次のクエリ操作では、インデックスを使用できます。

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

ただし、デフォルトで「シンプル」なバイナリー コレータを使用する次のクエリ操作では、インデックスを使用できません。

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

インデックス プレフィックスキーが文字列、配列、および埋め込みドキュメントではない複合インデックスの場合でも、異なる照合を指定する操作では、インデックスを使用してインデックス プレフィックスキーの比較をサポートできます。

たとえば、myColl コレクションには、数値フィールドの score、price、および 文字列フィールドの category の複合インデックスがあります。このインデックスは、文字列比較用の照合ロケール "fr" を使用して作成されます。

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

文字列の比較に "simple" バイナリ照合を使用する次の操作では、インデックスを使用できます。

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

次の操作では、"simple" バイナリ照合を使用してインデックス付きの category フィールドで文字列を比較しますが、クエリの score: 5 部分の実行についてはインデックスが使用できます。

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

numericOrdering

numericOrdering を true と指定する場合、以下の制限が適用されます。

• 比較では、連続する負でない整数のサブストリングのみが考慮されます。

  numericOrdering は、以下をサポートしません。

  • +

  • -

  • 小数点記号（小数点や小数点カンマなど）

  • 指数

• 数値または 10 進数（ND）カテゴリの Unicode コード ポイントだけが数字として扱われます。

• 数字の長さが 254 文字を超える場合、超過文字は別の数字として扱われます。

次の文字列の数値および 10 進数値を含むコレクションを検討します。

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

次の find クエリは、numericOrdering パラメータを含む照合ドキュメントを使用します。

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

この操作は次の結果を返します。

[
    { 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 の場合、文字列値を数値のように昇順でソートします。

• 2 つの負の値 -2.1 と -10 は、サポート対象外の - の文字が使われているため、期待どおりのソート順序でソートされません。

• numericOrdering パラメータは 10 進数をサポートしていないため、値 2.2 は値 2.10 より前にソートされます。

• その結果、2.2 と 2.10 は辞書順にソートされます。