(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.
|