DynamoDBToolbox事务写入操作的正确使用方式

在使用DynamoDBToolbox进行事务操作时，开发者可能会遇到"DynamoDBToolboxError: Unknown option: entity"的错误提示。这个错误通常是由于混淆了常规操作和事务操作的方法导致的。

问题本质

DynamoDBToolbox提供了两种不同的操作模式：

1. 常规操作：如put、update等，使用send()方法执行
2. 事务操作：如transactPut、transactUpdate等，需要通过executeTransactWrite方法执行

当开发者尝试将常规操作的命令直接放入事务执行时，就会出现上述错误，因为事务操作需要专门的事务命令格式。

解决方案

正确的做法是使用事务专用的操作方法：

// 错误方式（会导致Unknown option: entity错误）
const putCommand = MyEntity.put(params)
const updateCommand = MyEntity.update(params)
await MyEntity.executeTransactWrite({ putCommand, updateCommand })

// 正确方式
const transactPut = MyEntity.transactPut(params)
const transactUpdate = MyEntity.transactUpdate(params)
await MyEntity.executeTransactWrite({ transactPut, transactUpdate })

事务操作的特点

DynamoDB的事务操作有以下特点需要了解：

1. 原子性：事务中的所有操作要么全部成功，要么全部失败
2. 隔离性：事务中的操作对其他操作是不可见的，直到事务完成
3. 限制：单个事务最多可以包含25个操作
4. 性能：事务操作比单独操作有更高的延迟和成本

最佳实践

1. 明确区分常规操作和事务操作的API调用
2. 事务操作中不要混用常规操作命令
3. 合理控制事务规模，避免超过25个操作的限制
4. 考虑事务失败的回滚机制

理解这些概念后，开发者就能正确使用DynamoDBToolbox的事务功能，避免"Unknown option: entity"这类错误的发生。