SuperAPI AI 工具集

dynamodb-toolbox-patterns

编程与开发

查看项目

更新于 10-15 21:52

技能介绍

用途:该技能面向使用 DynamoDB-Toolbox v2 与 AWS SDK v3 DocumentClient 的 TypeScript 开发者,提供类型安全的 schema 建模、.build() 命令用法与生产级单表设计模式。

主要能力:定义表与实体并保持严格 TypeScript 类型推断;用 item、string、number、list、set、map、record 建模 schema;通过 .build() 实现 GetItem、PutItem、UpdateItem、DeleteItem;基于主键与 GSI 构建查询和扫描路径;处理批量与事务操作;用计算键和实体模式设计单表系统。

使用方式:先安装依赖 npm install dynamodb-toolbox @aws-sdk/client-dynamodb @aws-sdk/lib-dynamodb,再创建 DynamoDBClient 与 DynamoDBDocumentClient,定义 Table 与 Entity,schema 中可用 .key()、.required()、.default()、.transform()、.link() 等约束,统一通过 .build() 构造命令,如 UserEntity.build(PutItemCommand).item(...).send(),查询用 AppTable.build(QueryCommand).query(...),批量与事务分别用 BatchWriteCommand、TransactWriteCommand。

适用场景:需要严格类型推断的 DynamoDB 表与实体定义、单表设计、按访问模式设计主键与 GSI、批量写入与原子事务。

限制:依赖 AWS SDK v3 DocumentClient;请求路径中应避免无界扫描;并发敏感更新需条件写入;事务比单项写入更慢且有限制;实施前需按目标吞吐量验证键设计。具体收费、价格与平台信息暂未提供。