MongoDB\Driver\ClientEncryption::encryptExpression

参数

expr

要加密的匹配或聚合表达式。表达式必须使用至少一个 $gt、$gte、$lt 或 $lte 运算符。即使仅使用单个比较运算符，也需要顶级 $and 运算符。

支持的匹配表达式的示例（适用于查询和 $match 聚合阶段）如下所示

[
    '$and' => [
        [ '<field>' => [ '$gt'  => '<value1>' ] ],
        [ '<field>' => [ '$lte' => '<value2>' ] ],
    ],
]

支持的聚合表达式的示例如下所示

[
    '$and' => [
        [ '$gte' => [ '<fieldPath>', '<value1>' ] ],
        [ '$lt'  => [ '<fieldPath>', '<value2>' ] ],
    ],
]

options

加密选项

选项	类型	描述
algorithm	字符串	要使用的加密算法。此选项是必需的。指定以下 ClientEncryption 常量 之一 MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE
contentionFactor	整数	用于评估具有索引加密有效负载的查询的争用因子。 此选项仅适用于 algorithm 为 MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED 或 MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE 时，并且只能在此情况下指定。
keyAltName	字符串	通过 keyAltName 标识密钥保管库集合文档。此选项与 keyId 互斥，并且需要且仅需要一个。
keyId	MongoDB\BSON\Binary	通过 _id 标识数据密钥。该值是 UUID（二进制子类型 4）。此选项与 keyAltName 互斥，并且需要且仅需要一个。
queryType	字符串	用于评估具有索引加密有效负载的查询的查询类型。指定以下 ClientEncryption 常量 之一 MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE 此选项仅适用于 algorithm 为 MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED 或 MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE 时，并且只能在此情况下指定。
rangeOpts	数组	支持“范围”查询的可查询加密字段的索引选项。以下选项必须与目标集合的 encryptedFields 中设置的值匹配。对于双精度和 decimal128 BSON 字段类型，必须全部设置 min、max 和 precision，或者全部不设置。 范围索引选项 选项 类型 描述 min 混合 如果设置了 precision，则为必需。范围的最小 BSON 值。 max 混合 如果设置了 precision，则为必需。范围的最大 BSON 值。 sparsity 整数 可选。正 64 位整数。 precision 整数 可选。正 32 位整数，指定用于显式加密的精度。仅可为双精度或 decimal128 BSON 字段类型设置。 trimFactor 整数 可选。正 32 位整数。