如何使用Python Boto3从AWS DynamoDB表中获取指定属性的所有项？

阿华AIGC实验室

2026-5-20

如何用Boto3获取DynamoDB表中所有'Name'属性的值

嘿，刚上手DynamoDB的话，确实容易在“只取特定属性”这块卡壳～你想提取表中所有'Name'的值，其实有两种实用方法，我给你理清楚：

一、最直接的方法：使用Scan（适合全表获取特定属性）

如果你的需求是获取表中所有项的Name属性，Scan是最直接的选择——因为Query必须基于主键（分区键/排序键）的条件过滤，没法直接全表扫所有Name（除非你的主键刚好是Name，但一般不推荐这么设计）。

用DynamoDB Resource API（推荐，更简洁）

Resource API会自动把DynamoDB的类型格式转换成原生Python类型，用起来更顺手：

import boto3

# 初始化DynamoDB资源
dynamodb = boto3.resource('dynamodb')
table = dynamodb.Table('你的表名称')

# 执行Scan，仅指定返回Name属性
response = table.scan(
    ProjectionExpression='Name'
)

# 提取所有Name值
names = [item['Name'] for item in response['Items']]

# 处理分页（如果表数据超过1MB，Scan会分批返回，需要循环获取剩余数据）
while 'LastEvaluatedKey' in response:
    response = table.scan(
        ProjectionExpression='Name',
        ExclusiveStartKey=response['LastEvaluatedKey']
    )
    names.extend([item['Name'] for item in response['Items']])

# 输出结果
print(names)  # 预期输出: ['Nick', 'John', 'Gary', 'Jules']

用DynamoDB Client API

如果你习惯用Client API，注意它返回的是DynamoDB原始格式（带类型标识，比如字符串是{'S': 'Nick'}），需要额外解析：

import boto3

client = boto3.client('dynamodb')
response = client.scan(
    TableName='你的表名称',
    ProjectionExpression='Name'
)

# 解析带类型的返回结果
names = [item['Name']['S'] for item in response['Items']]

# 处理分页
while 'LastEvaluatedKey' in response:
    response = client.scan(
        TableName='你的表名称',
        ProjectionExpression='Name',
        ExclusiveStartKey=response['LastEvaluatedKey']
    )
    names.extend([item['Name']['S'] for item in response['Items']])

print(names)

二、什么时候用Query？

如果你的表有主键，且你需要基于主键条件过滤后获取Name，比如假设分区键是UserId，你想获取UserId = '123'的用户的Name，那可以用Query：

from boto3.dynamodb.conditions import Key

response = table.query(
    KeyConditionExpression=Key('UserId').eq('123'),
    ProjectionExpression='Name'
)
names = [item['Name'] for item in response['Items']]

但如果是全表获取所有Name，Scan更合适。