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