DynamoDB BatchGetItem报错：提供的键元素与schema不匹配

为什么BatchGetItem报错？ #

你遇到的The provided key element does not match the schema错误，主要有几个核心原因：

• 主键类型不匹配：检查你的表中Id字段的类型，如果是数字类型（N），但你命令里用了字符串类型（S），哪怕填具体数值也会报错。比如表中Id是数字，正确写法应该是{"Id": {"N": "123"}}，而非{"Id": {"S": "123"}}。
• 主键不完整：如果你的表是复合主键（分区键+排序键），Keys数组里必须同时提供两个主键字段，只填Id会导致结构不匹配。
• 通配符无效：BatchGetItem不支持用*作为通配符批量查询，这个接口要求每个Key都是精确匹配的主键值，无法模糊查询。

实现删除所有TimeToLive为空的行 #

BatchGetItem根本不适合做这个需求，因为它只能按主键精确查询，无法筛选TimeToLive为空的项。正确的做法是先扫描表筛选目标项，再批量删除：

1. 扫描表获取需要删除的主键
   用scan命令筛选出TimeToLive不存在的项，只返回主键Id：

   aws dynamodb scan --table-name my-table --filter-expression "attribute_not_exists(TimeToLive)" --projection-expression "Id" --output json > items-to-delete.json
   

   如果是复合主键，要把排序键也加入projection-expression。

2. 转换为批量删除的请求格式
   用jq工具把扫描结果转换成BatchWriteItem需要的格式（无jq需先安装）：

   jq '{ "my-table": [.Items[] | { DeleteRequest: { Key: { Id: .Id } } }] }' items-to-delete.json > delete-requests.json
   

   复合主键的话，要在Key里加上排序键，比如{ Id: .Id, SortKey: .SortKey }。

3. 执行批量删除

   aws dynamodb batch-write-item --request-items file://delete-requests.json
   

   注意：BatchWriteItem每次最多处理25个项，如果数据量很大，需要循环执行直到所有项都被删除。

内容的提问来源于stack exchange，提问作者Clarence the Bard