$toHashedIndexKey（式演算子）

定義

$toHashedIndexKey

MongoDB がハッシュインデックスを作成するのと同じハッシュ関数を使用して、入力式のハッシュ値を計算して返します。 ハッシュ関数は、キーまたは string を固定サイズの数値にマッピングします。

注意

ハッシュされたインデックスとは異なり、 $toHashedIndexKey集計演算子は照合を考慮しません。 つまり、 演算子では、同じデータに基づいてハッシュされたインデックスのハッシュと一致しないハッシュを生成できます。

構文

$toHashedIndexKey の構文は次のとおりです。

{ $toHashedIndexKey: <key or string to hash> }

例

$toHashedIndexKey を使用して、集計パイプラインでstringのハッシュ値を計算できます。 この例では、string "string to hash"のハッシュされた値を計算します。

db.aggregate(
   [
      { $documents: [ { val: "string to hash" } ] },
      { $addFields: { hashedVal: { $toHashedIndexKey: "$val" } } }
   ]
 )

出力例:

[ { val: 'string to hash', hashedVal: Long("763543691661428748") } ]

詳細

$hash集計パイプラインでの汎用ハッシュについては、$hexHash と を参照してください。これらの演算子は次のように$toHashedIndexKey と異なります。

• $hashと$hexHash は汎用ハッシュ式です。入力がnull nullまたは欠落している場合、式は を返します。

• $toHashedIndexKey は ハッシュされたインデックスセマンティクス を適用します。 $hash と $hexHash とは異なり、null を返すのではなく、null と欠損値を Long の数値にハッシュします。

詳しくは以下を参照してください。

• $hash

• $hexHash

• convertShardKeyToHashed()