用途:面向使用 dynamodb-toolbox v2 进行 DynamoDB 单表设计的开发者,提供类型安全的 Entity 与 Table 抽象用法。适合访问模式已知且稳定、需要可预测低延迟性能、有清晰数据边界的微服务场景;不适合需求多变、需要临时分析查询或团队缺乏 DynamoDB 经验的场景。
主要能力:用 Table 定义分区键、排序键与 GSI;用 Entity 与 item({}) 定义 schema,通过 .key() 标记键属性,用 .and() 分离业务属性与计算键,用 .link<typeof _schema>() 由业务属性推导 PK/SK/GSI 键,支持 .validate() 校验与 .savedAs() 重命名。提供 InputItem<T>(写入)与 FormattedItem<T>(读取)类型。
使用方式:先完成建模清单(实体关系、实体图表、GSI 策略、访问模式文档),再定义表与实体。仓储层用 PutItemCommand 配合条件 { attr: "PK", exists: false } 创建、exists: true 更新,GetItemCommand 读取,QueryCommand 配合 .entities() 查询,支持 range 过滤、reverse 排序、exclusiveStartKey 分页与 limit。事务、错误处理与测试细节见对应参考文档。
限制:资料未提供具体版本兼容范围、性能基准与收费信息;示例中的 GSI4 未在表配置中定义,需自行补充。