(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
L'expression de correspondance ou d'agrégation à chiffrer. Les expressions doivent
utiliser au moins un des opérateurs $gt
, $gte
,
$lt
ou $lte
. Un opérateur de
comparaison unique 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>' ] ], ], ]
Un exemple d'expression d'agrégation prise en charge est le suivant :
[ '$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
|
||||||||||||||||||
keyAltName | string |
Identifie un document de collection de coffre à clés par |
||||||||||||||||||
keyId | MongoDB\BSON\Binary |
Identifie une clé de données par |
||||||||||||||||||
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 :
Cette option s'applique uniquement et ne peut être spécifiée que lorsque
|
||||||||||||||||||
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
|
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.
|