一文读懂 MongoDB驱动程序 API

回调API和核心API

回调 API：

• 启动一个事务，执行指定的操作，并提交（或出错时中止）。

• 自动包含 "TransientTransactionError" 和 "UnknownTransactionCommitResult" 的错误处理逻辑。

核心 API：

• 需要显式调用来启动事务并提交事务。

• 不包含 "TransientTransactionError" 和 "UnknownTransactionCommitResult" 的错误处理逻辑，而是为这些错误提供了包含自定义错误处理的灵活性。

回调API

回调 API 包含以下逻辑：

• 如果事务遇到 "TransientTransactionError"，则作为一个整体重试事务。

• 如果提交遇到 "UnknownTransactionCommitResult"，则重新这个提交操作。

示例：

该示例使用新的回调 API 来处理事务，它启动事务、执行指定的操作并提交（或在出错时中止）。新的回调 API 包含 "TransientTransactionError"或"UnknownTransactionCommitResult" 提交错误的重试逻辑。

重要

• 推荐。使用针对 MongoDB 部署版本更新的 MongoDB 驱动程序。对于 MongoDB 4.2 部署（副本集和分片集群）上的事务，客户端必须使用为 MongoDB 4.2 更新的 MongoDB 驱动程序。

• 使用驱动程序时，事务中的每个操作必须与会话相关联（即将会话传递给每个操作）。

• 事务中的操作使用 事务级别的读关注，事务级别的写关注，和 事务级别的读偏好。

• 在 MongoDB 4.2 及更早版本中，你无法在事务中创建集合。如果在事务内部运行，导致文档插入的写操作（例如 insert 或带有 upsert: tru