$toHashedIndexKey (operador de expresión)

Definición

$toHashedIndexKey

Calcula y devuelve el valor hash de la expresión de entrada utilizando la misma función hash que MongoDB utiliza para crear un índice encriptado. Una función hash asigna una clave o string a un valor numérico de tamaño fijo.

Nota

A diferencia de los índices con hash, el operador de agregación $toHashedIndexKey no tiene en cuenta la intercalación. Esto significa que el operador puede generar un hash que no coincida con el de un índice hash basado en los mismos datos.

Sintaxis

$toHashedIndexKey tiene la siguiente sintaxis:

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

Ejemplo

Se puede utilizar $toHashedIndexKey para calcular el valor encriptada de una string en un pipeline de agregación. Este ejemplo calcula el valor encriptada de la string "string to hash":

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

Ejemplo de salida:

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

Obtén más información

Para hash de propósito general en un pipeline de agregación, consulte $hash y $hexHash. Estos operadores difieren de $toHashedIndexKey de la siguiente manera:

• $hash y $hexHash son expresiones de hashing de propósito general. Las expresiones devuelven null cuando el input es null o falta.

• $toHashedIndexKey aplica la semántica de índices encriptadas. A diferencia de $hash y $hexHash, aplica un hash a null y a los valores faltantes para dar un valor numérico Long en vez de devolver null.

Para obtener más información, consulta:

• $hash

• $hexHash

• convertShardKeyToHashed()