Boto3查询DynamoDB时如何传入多个排序键值进行查询

DynamoDB的Query操作不支持在KeyConditionExpression中对排序键直接使用类SQL的IN语法匹配多个离散值。
KeyConditionExpression对排序键仅支持以下几类匹配规则：

• 单值精确匹配：eq
• 范围比较：lt/lte/gt/gte
• 区间匹配：between
• 前缀匹配：begins_with

注意：不要尝试把排序键的IN判断写在FilterExpression中。这种写法虽然不会报语法错误，但Query会先扫描指定分区键下的所有条目，再执行过滤逻辑，会产生全分区扫描的读容量消耗，性能和成本表现都很差，不推荐使用。

可落地的替代实现方案 #

• 方案1：循环发起单值Query请求
  固定分区键条件，遍历所有需要匹配的排序键值，逐个构造eq条件发起Query请求，最后在客户端侧合并所有返回结果即可。如果存在分页场景，记得每次请求处理LastEvaluatedKey翻页参数。
  参考实现代码：

  from boto3.dynamodb.conditions import Key
  
  pk_value = "目标分区键值"
  target_sk_list = ["待匹配排序键值1", "待匹配排序键值2", "待匹配排序键值3"]
  all_items = []
  
  for sk_val in target_sk_list:
      resp = table.query(
          IndexName="my_gsi",
          KeyConditionExpression=Key('my_gsi_pk').eq(pk_value) & Key('my_gsi_sk').eq(sk_val),
          FilterExpression="你的原有过滤条件"
      )
      all_items.extend(resp.get("Items", []))
      # 处理分页
      while "LastEvaluatedKey" in resp:
          resp = table.query(
              IndexName="my_gsi",
              KeyConditionExpression=Key('my_gsi_pk').eq(pk_value) & Key('my_gsi_sk').eq(sk_val),
              FilterExpression="你的原有过滤条件",
              ExclusiveStartKey=resp["LastEvaluatedKey"]
          )
          all_items.extend(resp.get("Items", []))
  

• 方案2：连续区间用between单次查询
  如果待匹配的多个排序键值刚好是连续区间（比如数值1/2/3、按规则排序的连续字符串前缀），可以直接在KeyConditionExpression中用between条件，单次请求即可拿到所有结果，读容量消耗最低，性能最好。

• 方案3：主表多值读取用BatchGetItem
  如果是查询主表（而非GSI全局二级索引），且待匹配的条目主键（分区键+排序键）总数不超过100个，可以直接用BatchGetItem接口批量读取，接口会并行拉取所有目标条目，相比循环Query性能更高。如果是GSI场景则无法使用该方案，还是需要走循环Query逻辑。

内容的提问来源于stack exchange，提问作者GarlicBread