(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
| Option | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| algorithm | string |
The encryption algorithm to be used. This option is required. Specify one of the following ClientEncryption constants:
|
||||||||||||||||||
| contentionFactor | int |
The contention factor for evaluating queries with indexed, encrypted payloads.
This option only applies and may only be specified when
|
||||||||||||||||||
| keyAltName | string |
Identifies a key vault collection document by
|
||||||||||||||||||
| keyId | MongoDB\BSON\Binary |
Identifies a data key by |
||||||||||||||||||
| queryType | string |
The query type for evaluating queries with indexed, encrypted payloads. Specify one of the following ClientEncryption constants:
This option only applies and may only be specified when
|
||||||||||||||||||
| rangeOpts | array |
Index options for a queryable encryption field supporting "range"
queries. The options below must match the values set in the
|
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.
|