查询DynamoDB GlobalSecondaryIndex时提示缺少表分区键的问题

问题场景 #

我维护的DynamoDB表主键架构为object（HASH键）+id（RANGE键），同时创建了名为dateIndex的全局二级索引（GSI），代码里定义该GSI的键架构是artificialPK（HASH键）+date（RANGE键）。

用表主键object和id查询一切正常，但尝试用GSI的键date和artificialPK查询时，却抛出ValidationException错误，提示缺少键架构元素'object'——可object根本不是这个GSI的键成员。试了几种查询组合都报错：

• 仅用GSI键查询：提示缺object
• 用表主键查询GSI：提示缺date
• 同时带表主键和GSI键：提示条件长度只能是1或2

后来排查发现实际创建的GSI键架构和代码中定义的不一致，这就是问题的核心原因。

相关代码示例 #

表创建代码 #

>>> ddb_resource.create_table(
                TableName=self.table_name,
                KeySchema=[
                    {'AttributeName': 'object', 'KeyType': 'HASH'},
                    {'AttributeName': 'id', 'KeyType': 'RANGE'}
                ],
                AttributeDefinitions=[
                    {'AttributeName': 'object', 'AttributeType': 'S'},
                    {'AttributeName': 'id', 'AttributeType': 'S'},
                    {'AttributeName': 'artificialPK', 'AttributeType': 'N'},
                    {'AttributeName': 'date', 'AttributeType': 'N'}
                ],
                GlobalSecondaryIndexes=[
                    {
                        'IndexName': 'dateIndex',
                        'KeySchema': [
                            {'AttributeName': 'artificialPK', 'KeyType': 'HASH'},
                            {'AttributeName': 'date', 'KeyType': 'RANGE'}
                        ],
                        'Projection': {
                            'ProjectionType': 'ALL'
                        },
                    }
                ]
            )

测试查询及报错信息 #

# 表主键查询正常返回结果
>>> resp = self.table.query(KeyConditionExpression=Key('object').eq('foo') & Key('id').gt('0'))
>>> len(resp['Items'])
123

# 用GSI键查询报错
>>> resp=self.table.query(IndexName='dateIndex', KeyConditionExpression=Key('date').gt(0) & Key('artificialPK').eq('1'))
botocore.exceptions.ClientError: An error occurred (ValidationException) when calling the Query operation: Query condition missed key schema element: object

# 用表主键查询GSI报错
>>> resp=self.table.query(IndexName='dateIndex', KeyConditionExpression=Key('object').eq('foo') & Key('id').gt('1'))
botocore.exceptions.ClientError: An error occurred (ValidationException) when calling the Query operation: Query condition missed key schema element: date

# 混合条件查询报错
>>> resp=self.table.query(IndexName='dateIndex', KeyConditionExpression=Key('date').gt(0) & Key('object').eq('foo') & Key('id').gt('1'))
botocore.exceptions.ClientError: An error occurred (ValidationException) when calling the Query operation: Conditions can be of length 1 or 2 only

解决步骤 #

1. 确认GSI的实际键架构
   通过AWS控制台、CLI或SDK查询表的元数据，核实dateIndex的真实KeySchema：

   aws dynamodb describe-table --table-name YOUR_TABLE_NAME --query "Table.GlobalSecondaryIndexes[?IndexName=='dateIndex'].KeySchema"
   

2. 修正GSI定义（若不一致）
   DynamoDB不支持修改已存在GSI的键架构，若实际GSI和代码定义不符，需要先删除该GSI，再重新创建符合预期的GSI。

3. 使用正确的GSI键构造查询条件
   查询GSI时，必须严格使用该GSI定义的键架构：

   • 必须包含GSI的HASH键
   • RANGE键可选，但使用时必须配合HASH键
   • 注意属性类型匹配：比如代码中artificialPK是N（数字）类型，查询时要传数字而非字符串

   正确查询示例（假设GSI确实为artificialPK+date）：

   resp=self.table.query(
       IndexName='dateIndex',
       KeyConditionExpression=Key('artificialPK').eq(1) & Key('date').gt(0)
   )
   

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