(mongodb >=1.16.0)
MongoDB\Driver\ClientEncryption::encryptExpression — Criptografa uma expressão de correspondência ou de agregação
$expr, ?array $options = null): objectCriptografa uma expressão de correspondência ou de agregação para consultar um índice de intervalo.
Para consultar com uma carga criptografada por intervalo, o MongoDB\Driver\Manager deve ser configurado com a opção de driver "autoEncryption". A opção de criptografia automática "bypassQueryAnalysis" pode ser true. A opção de criptografia automática "bypassAutoEncryption" deve ser false.
Nota: A extensão ainda não oferece suporte a consultas de intervalo para tipos de campo Decimal128 BSON.
expr$gt, $gte,
$lt ou $lte. Um operador
$and de nível superior é necessário, mesmo que apenas um único
operador de comparação seja usado.
Um exemplo de expressão de correspondência suportada (aplica-se a consultas e ao
estágio de agregação $match) é o seguinte:
[
'$and' => [
[ '<field>' => [ '$gt' => '<value1>' ] ],
[ '<field>' => [ '$lte' => '<value2>' ] ],
],
]
[
'$and' => [
[ '$gte' => [ '<fieldPath>', '<value1>' ] ],
[ '$lt' => [ '<fieldPath>', '<value2>' ] ],
],
]
options
| Opção | Tipo | Descrição | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| algorithm | string |
O algoritmo de criptografia a ser usado. Esta opção é obrigatória.
Especifique uma das seguintes
constantes ClientEncryption:
|
||||||||||||||||||
| contentionFactor | int |
O fator de contenção para avaliar consultas com cargas indexadas e
criptografadas.
Esta opção só se aplica e só pode ser especificada quando
algorithm for
MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED
ou
MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
|
||||||||||||||||||
| keyAltName | string |
Identifica um documento de coleção de cofres de chaves por
keyAltName. Esta opção é mutuamente exclusiva
com keyId e exatamente uma é necessária.
|
||||||||||||||||||
| keyId | MongoDB\BSON\Binary |
Identifica uma chave de dados por _id. O valor é um UUID
(subtipo binário 4). Esta opção é mutuamente exclusiva com
keyAltName e exatamente uma é necessária.
|
||||||||||||||||||
| queryType | string |
O tipo de consulta para avaliar consultas com cargas indexadas e
criptografadas. Especifique uma das seguintes
constantes ClientEncryption:
algorithm for
MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED
ou MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
|
||||||||||||||||||
| rangeOpts | array |
Opções de índice para um campo de criptografia consultável compatível
com consultas "range". As opções abaixo devem corresponder aos valores definidos
nos encryptedFields da coleção de destino.
Para tipos de campo double e decimal128 BSON, min,
max e precision devem ser todos
definidos ou nenhum definido.
|
Retorna a expressão criptografada como um objeto.
| Versão | Descrição |
|---|---|
| PECL mongodb 1.20.0 |
Adiciona a opção de intervalo "trimFactor" A
opção de intervalo "sparsity" agora é opcional.
|