对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

创建加密collection并插入文档

本指南向您介绍如何创建启用了Queryable Encryption的集合并插入具有加密字段的文档。

完成本指南中的步骤后,您应该能够创建加密集合并插入包含使用客户主密钥加密的字段的文档。

在创建加密集合之前,创建启用了Queryable Encryption的应用程序。

如果使用显式加密,还必须事先为每个加密字段创建唯一的数据加密密钥。 有关详细信息,请参阅加密密钥和密钥保管库。

1

要加密字段,请将其添加到加密模式中。 要启用对字段的查询,请添加queries属性。 您可以通过相等查询或范围查询来启用字段的可查询性。 以下步骤演示如何指定要使用每种查询类型加密的字段。

  1. 为相等查询指定字段

    要启用对字段的相等查询,请将该字段添加到queryType为"equality"的加密模式中。 以下代码示例会加密ssn和billing字段,但只能查询ssn字段:

    const collectionOpts = { encryptedFields: { fields: [ { path: "patientRecord.ssn", bsonType: "string", queries: { queryType: "equality" }, }, { path: "patientRecord.billing", bsonType: "object", }, ], },};
  2. 为范围查询指定字段

    要对字段启用范围查询,请将该字段添加到queryType为"range"的加密模式中。 以下示例将billAmount字段添加到上一步中创建的加密模式中,并对其启用范围查询:

    const collectionOpts = { encryptedFields: { fields: [ { path: "patientRecord.ssn", bsonType: "string", queries: { queryType: "equality" }, }, { path: "patientRecord.billing", bsonType: "object", }, { path: "patientRecord.billAmount", bsonType: "int", queries: { queryType: "range", sparsity: 1, trimFactor: 4, min: 100, max: 2000, }, }, ], },};

有关这些步骤的扩展版本,请参阅创建加密模式。

2
const clientEncryption = encryptedClient.getClientEncryption();
3

重要

显式创建集合,而不是使用插入操作隐式创建集合。在您使用 createCollection() 创建集合时,MongoDB 在加密字段上创建索引。如果没有该索引,对加密字段的查询可能运行缓慢。

使用可通过ClientEncryption类访问的加密助手方法创建加密集合。 此方法自动为加密字段生成数据加密密钥并创建加密集合:

await clientEncryption.createEncryptedCollection( encryptedDatabaseName, encryptedCollectionName, { provider: kmsProviderName, createCollectionOptions: collectionOpts, masterKey: customerMasterKeyCredentials, });

有关更多信息,请参阅创建集合时启用Queryable Encryption 。

4

创建描述患者个人信息的示例文档。使用加密的客户端将其插入到 patients 集合中,如以下示例所示:

const patientDocument = { patientName: "Jon Doe", patientId: 12345678, patientRecord: { ssn: "987-65-4320", billing: { type: "Visa", number: "4111111111111111", }, billAmount: 1500, },}; const encryptedCollection = encryptedClient .getDB(encryptedDatabaseName) .getCollection(encryptedCollectionName); const insertResult = await encryptedCollection.insertOne(patientDocument);

创建启用了Queryable Encryption的集合后,您可以查询加密字段。

选择您的语言
给本页内容打分