数据库触发器

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

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

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

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

  • Insert

  • Update

  • 替换

  • 删除

  注意

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

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

  注意

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

• Document Preimage启用后，变更事件包括在 fullDocumentBeforeChange 字段中应用更改之前的最新已修改文档的副本。这有性能考量。除插入事件外的所有变更事件都包含文档原像。

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

• Database Name。要监视的 MongoDB 数据库。可选。如果将此选项留空，Source Type（源类型）将更改为 Deployment（部署），除非您位于共享层，在这种情况下，App Services 将不允许您保存触发器。

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

  • 创建集合

  • 修改集合

  • renameCollection

  • 删除集合

  • 分片集合

  • reshardCollection

  • refineCollectionShardKey

  注意

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

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

  注意

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

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

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

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

  • 删除数据库

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

  注意

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

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

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

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

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

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

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

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

  例子

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

  {
    _id: 1,
    fullDocument: 1
  }

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

  例子

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

  {
    _id: 0,
    fullDocument: 0
  }

  注意

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

一个 $match 表达式文档，App Services 使用它来过滤哪些变更事件会导致触发器触发。触发器根据这个匹配表达式评估它收到的所有变更事件对象，仅当给定变更事件的表达式计算结果为 true 时才执行。

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

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

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