ClientEncryption.encryptExpression()（mongosh方法）

ClientEncryption.encryptExpression(keyId, expression, encOptions)

ClientEncryption.encryptExpression 使用查询字段的 keyId以及encOptions 文档中的查询类型和算法，对MQL表达式进行加密以查询范围索引。它返回加密的查询结果。

返回：

binary data作为具有子类型6 的对象的加密查询结果。

兼容性

此命令可用于以下环境中托管的部署：

MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

clientEncryption = db.getMongo().getClientEncryption()
clientEncryption.encryptExpression(
   keyId,
   expression,
   encOptions
)

Parameter	类型	说明
`keyId`	`UUID`	表达式中查询的字段的数据加密密钥。 UUID是具有子类型`4`的 BSON `binary data`对象，用于标识特定数据加密密钥。如果为数据库连接配置的密钥保管库中不存在数据加密密钥， `encryptExpression()`将返回错误。有关密钥保管库和数据加密密钥的详细信息，请参阅密钥保管库集合。
`expression`	文档	要加密的范围查询表达式，可为以下形式之一：采用以下形式的`$match`表达式：`{$and: [{<field>: {$gt: <value1>}}, {<field>: {$lt: <value2> }}]}` 采用以下形式的 `aggregate` 表达式：`{$and: [{$gt: [<fieldpath>, <value1>]}, {$lt: [<fieldpath>, <value2>]}]}` 表达式还可以使用 `$lte` 或 `$gte`
`encOptions`	文档	一个包含以下字段的文档： `algorithm`：用于加密 `expression` 的加密算法。必须设立为 `"range"`。 `queryType`：查询类型。必须设立为 `"range"`。 `rangeOptions`：具有范围查询设置的文档。值必须与集合的加密模式中的值匹配。 `min`、`max`：与字段的BSON类型匹配的最小值和最大值。 `precision`： MongoDB在查询 `double` 和 `decimal128` 字段时考虑的有效位数。 `sparsity`：影响MongoDB对范围值进行索引的彻底程度。 `trimFactor`：控制并发插入和更新的吞吐量。 `contentionFactor`：与表达式中字段值的频率有关。有关详细信息，请参阅争用。

行为

mongosh客户端字段级别和可查询Queryable Encryption方法需要为客户端加密配置数据库连接。如果当前数据库连接不是在启用客户端字段级加密的情况下启动的，则：

使用 mongosh 中的 Mongo() 构造函数与所需的客户端字段级加密选项建立连接。Mongo() 方法支持以下用于“客户主密钥”(KMS) 管理的“密钥管理服务”(CMK) 提供商：

使用 mongosh 命令行选项，用所需选项建立连接。命令行选项仅支持用于 CMK 管理的 Amazon Web Services KMS 提供商。

示例

clientEncryption.encryptExpression(
   UUID("64e2d87d-f168-493c-bbdf-a394535a2cb9"),
   {
      $and: [{ val: { $gt: Int32('100') } }, { val: { $lt: Int32('150') } }]
   },
   {
      algorithm: 'range',
      queryType: 'range',
      rangeOptions: { min: Int32('0'), max: Int32('200') },
      contentionFactor: 8
   })

如果成功，ClientEncryption.encryptExpression 将返回加密的查询结果。

了解详情

有关在启用客户端字段级加密或Queryable Encryption的情况下启动MongoDB连接的完整文档，请参阅 Mongo()。

后退

ClientEncryption.encrypt

来年

ClientEncryption.decrypt