数据库触发器

• Cluster Name与触发器关联的 MongoDB 集群的名称。

• Database Name。包含监视集合的 MongoDB 数据库。

• Collection Name。要监视的 MongoDB 集合。可选。如果将此选项留空，则 Source Type（源类型）将更改为 Database（数据库）。

• Operation Type。导致触发器触发的操作类型。选择您希望触发器响应的操作类型。选项包括：

  • Insert

  • Update

  • 替换

  • 删除

  注意：从MongoDB Compass或MongoDB Atlas数据浏览器执行的更新操作会完全替换之前的文档。 因此，这些客户端的更新操作会生成Replace更改事件，而不是Update事件。

• Full Document。如果启用，则在Update 字段中应用更改 后 ， 更改事件将包括已修改文档的最新 多数提交fullDocument 版本。

  注意：无论此设置如何，插入和替换事件始终包含fullDocument字段。 删除事件从不包含fullDocument字段。

• Document Preimage。启用后，更改事件包括在fullDocumentBeforeChange字段中应用更改之前的已修改文档的副本。 这是出于性能方面的考虑。 除Insert事件之外的所有变更事件都包含文档原像。

• Cluster Name与触发器关联的 MongoDB 集群的名称。

• Database Name。要监控的MongoDB 数据库。 可选。 如果将此选项留空，源类型将更改为 Deployment，除非您位于共享层级，在这种情况下， Atlas将不允许您保存trigger 。

• Operation Type。导致触发器触发的操作类型。选择您希望触发器响应的操作类型。选项包括：

  • 创建集合

  • 修改集合

  • renameCollection

  • 删除集合

  • 分片集合

  • reshardCollection

  • refineCollectionShardKey

  注意：从MongoDB Compass或MongoDB Atlas数据浏览器执行的更新操作会完全替换之前的文档。 因此，这些客户端的更新操作将生成Replace更改事件，而不是Update事件。

• Full Document。如果启用，则在Update 字段中应用更改 后 ， 更改事件将包括已修改文档的最新 多数提交fullDocument 版本。

  注意：无论此设置如何，插入和替换事件始终包含fullDocument字段。 删除事件从不包含fullDocument字段。

• Document Preimage。启用后，更改事件包括在fullDocumentBeforeChange字段中应用更改之前的已修改文档的副本。 这是出于性能方面的考虑。 除Insert事件之外的所有变更事件都包含文档原像。 对数据库和部署源禁用，以限制集群上对正在创建的新集合进行不必要的监视。

• Cluster Name与触发器关联的 MongoDB 集群的名称。

• Operation Type。集群中发生的导致 的 操作类型trigger 。选择希望trigger响应的操作类型。 选项包括：

  • 删除数据库

• Full Document。如果启用，则在Update 字段中应用更改 后 ， 更改事件将包括已修改文档的最新 多数提交fullDocument 版本。

  注意：无论此设置如何，插入和替换事件始终包含fullDocument字段。 删除事件从不包含fullDocument字段。

• Document Preimage。启用后，更改事件包括在fullDocumentBeforeChange字段中应用更改之前的已修改文档的副本。 这是出于性能方面的考虑。 除Insert事件之外的所有变更事件都包含文档原像。 对数据库和部署源禁用，以限制集群上对正在创建的新集合进行不必要的监视。

如果启用，当在集群的trigger 中找不到此oplog 的恢复令牌时，trigger 会在下一个相关变更流事件时自动恢复处理事件。从trigger暂停到trigger恢复执行的所有变更流事件都不会trigger 。

如已启用，将按照触发事件发生的顺序进行处理。如已禁用，事件可以并行处理，当许多事件同时发生时，处理速度会更快。

如果启用了事件排序，此触发器的多次执行操作将根据更改事件的时间戳按顺序进行。如果禁用了事件排序，该触发器的多次执行操作将独立进行。

提示：要提高响应批量数据库操作的触发器的性能，请禁用事件排序。

一个 $project 表达式，它从变更流中的每个事件中选择一个字段子集。您可以使用它来优化触发器的执行。

表达式是一个对象，可以将更改事件中的字段名称映射到 0（不包括该字段）或 1（包括该字段）。表达式的值可以是 0 或 1，但不能同时是 0 或 1。就是把投影分为两类，即包容性投影和排他性投影：

• 包容性项目表达式指定要包含在每个更改事件文档中的字段。该表达式是一个对象，它将要包含的字段的名称映射到 1。如果不包含某个字段，则该字段不会包含在预计的更改事件中。

  以下投影仅包括 _id 和 fullDocument 字段：

  {
    _id: 1,
    fullDocument: 1
  }

• 独占项目表达式指定要从每个更改事件文档中排除的字段。该表达式是一个对象，它将要包含的字段的名称映射到 0。如果不排除某个字段，它将包含在预计的更改事件中。

  以下投影排除 _id 和fullDocument字段：

  {
    _id: 0,
    fullDocument: 0
  }

  您不能使用投影排除 operation_type 字段。这确保该触发器始终可以检查它是否应该针对给定事件的操作类型运行。

使用 $match Atlas表达式文档过滤哪些变更事件会导致 。triggertrigger根据此匹配表达式评估它收到的所有变更事件对象，并且仅当给定变更事件的表达式计算结果为 true 时才会执行。

MongoDB 对匹配表达式中的嵌入式文档执行完全等值匹配。如果要匹配嵌入式文档中的特定字段，请直接使用点符号引用该字段。请参阅 MongoDB Server 手册中的查询嵌入式文档，了解详情。

为了优化性能，请使用trigger $match 表达式限制 处理的字段数量。了解详情。

如果链接的数据源是专用服务器（M10+ 层），则可以将最大吞吐量增加到超过默认的 10,000 个并发进程。

重要提示：要启用最大吞吐量，必须禁用事件排序。

在增加最大吞吐量之前，请考虑一个或多个触发器是否正在调用速率受限的外部 API。增加触发率可能会导致超限。

提高吞吐量还可能增加更大工作负载，影响集群的整体性能。