(mongodb >=1.16.0)
MongoDB\Driver\ClientEncryption::encryptExpression â Chiffre une expression de correspondance ou d'agrĂ©gation
$expr, ?array $options = null): objectChiffre une expression de correspondance ou d'agrégation pour interroger un index de plage.
Pour interroger avec une charge utile chiffrĂ©e par plage, l'option de pilote MongoDB\Driver\Manager doit ĂȘtre configurĂ©e avec l'option de pilote "autoEncryption". L'option de chiffrement automatique "bypassQueryAnalysis" peut ĂȘtre true. L'option de chiffrement automatique "bypassAutoEncryption" doit ĂȘtre false.
Note: L'extension ne prend pas encore en charge les requĂȘtes de plage pour les types de champ BSON Decimal128.
expr$gt, $gte,
$lt ou $lte. Un opérateur $and
de premier niveau est requis, mĂȘme si un seul opĂ©rateur de comparaison est utilisĂ©.
Un exemple d'expression de correspondance prise en charge (s'applique aux requĂȘtes et Ă l'Ă©tape d'agrĂ©gation
$match) est le suivant :
[
'$and' => [
[ '<field>' => [ '$gt' => '<value1>' ] ],
[ '<field>' => [ '$lte' => '<value2>' ] ],
],
]
[
'$and' => [
[ '$gte' => [ '<fieldPath>', '<value1>' ] ],
[ '$lt' => [ '<fieldPath>', '<value2>' ] ],
],
]
options
| Option | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| algorithm | string |
L'algorithme de chiffrement à utiliser. Cette option est requise. Spécifiez l'une des constantes suivantes de
ClientEncryption :
|
||||||||||||||||||
| contentionFactor | int |
Le facteur de contention pour Ă©valuer les requĂȘtes avec des charges utiles chiffrĂ©es indexĂ©es.
Cette option s'applique uniquement et ne peut ĂȘtre spĂ©cifiĂ©e que lorsque
algorithm est
MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED ou
MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
|
||||||||||||||||||
| keyAltName | string |
Identifie un document de collection de coffre à clés par keyAltName. Cette option est mutuellement exclusive
avec keyId et l'une des deux est requise.
|
||||||||||||||||||
| keyId | MongoDB\BSON\Binary |
Identifie une clé de données par _id. La valeur est un UUID (sous-type binaire 4). Cette option est mutuellement
exclusive avec keyAltName et l'une des deux est requise.
|
||||||||||||||||||
| queryType | string |
Le type de requĂȘte pour Ă©valuer les requĂȘtes avec des charges utiles chiffrĂ©es indexĂ©es. SpĂ©cifiez l'une des constantes suivantes de
ClientEncryption :
algorithm est
MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED ou
MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
|
||||||||||||||||||
| rangeOpts | array |
Options d'index pour un champ de chiffrement interrogeable prenant en charge les requĂȘtes "range". Les options ci-dessous doivent correspondre
aux valeurs définies dans encryptedFields de la collection cible. Pour les types de champ BSON double et decimal128,
min, max et precision doivent ĂȘtre tous dĂ©finis ou tous non dĂ©finis.
|
Renvoie l'expression chiffrée en tant qu'objet.
| Version | Description |
|---|---|
| PECL mongodb 1.20.0 |
Ajouté l'option de plage "trimFactor". L'option de plage
"sparsity" est désormais optionnelle.
|