(mongodb >=1.16.0)
MongoDB\Driver\ClientEncryption::encryptExpression — Cifra una expresión de coincidencia o agregación
$expr
, ?array $options
= null
): objectCifra una expresión de coincidencia o agregación para consultar un índice de rango.
Para consultar con una carga útil cifrada por rango, la opción del controlador MongoDB\Driver\Manager debe ser configurada con la opción del controlador "autoEncryption"
. La opción de cifrado automático "bypassQueryAnalysis"
puede ser true
. La opción de cifrado automático "bypassAutoEncryption"
debe ser false
.
Nota:
La extensión aún no admite consultas de rango para los tipos de campo BSON Decimal128.
expr
La expresión de coincidencia o agregación a cifrar. Las expresiones deben
utilizar al menos uno de los operadores $gt
, $gte
,
$lt
o $lte
. Se utiliza un único operador de
comparación.
Un ejemplo de expresión de coincidencia admitida (aplicable a consultas y a la etapa de agregación
$match
) es el siguiente:
[ '$and' => [ [ '<field>' => [ '$gt' => '<value1>' ] ], [ '<field>' => [ '$lte' => '<value2>' ] ], ], ]
Un ejemplo de expresión de agregación admitida es el siguiente:
[ '$and' => [ [ '$gte' => [ '<fieldPath>', '<value1>' ] ], [ '$lt' => [ '<fieldPath>', '<value2>' ] ], ], ]
options
Opción | Tipo | Descripción | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
algorithm | string |
El algoritmo de cifrado a utilizar. Esta opción es requerida. Especifique una de las siguientes constantes de ClientEncryption :
|
||||||||||||||||||
contentionFactor | int |
El factor de contención para evaluar las consultas con cargas útiles cifradas indexadas.
Esta opción se aplica únicamente y solo puede ser especificada cuando
|
||||||||||||||||||
keyAltName | string |
Identifica un documento de colección de cofre de claves por |
||||||||||||||||||
keyId | MongoDB\BSON\Binary |
Identifica una clave de datos por |
||||||||||||||||||
queryType | string |
El tipo de consulta para evaluar las consultas con cargas útiles cifradas indexadas. Especifique una de las siguientes constantes de ClientEncryption :
Esta opción se aplica únicamente y solo puede ser especificada cuando
|
||||||||||||||||||
rangeOpts | array |
Opciones de índice para un campo de cifrado interrogeable que soporta consultas "range". Las opciones a continuación deben coincidir
con los valores definidos en
|
Devuelve la expresión cifrada como objeto.
Versión | Descripción |
---|---|
PECL mongodb 1.20.0 |
Añadida la opción de rango "trimFactor" . La opción de rango
"sparsity" es ahora opcional.
|