AWS DynamoDB通过分区键查询单条数据报错及无返回问题咨询

首次query调用报错原因 #

报错直接由参数配置错误触发：

• IndexName参数仅用于查询二级索引的场景，查询主表数据不需要传入该参数
• 你错误将分区键字段名id填入了IndexName参数位，id长度为2，不满足索引名最少3位的平台约束，因此触发校验报错。

针对你的疑问统一说明：

• 仅通过分区键足够查询匹配的行记录
• 分区键和索引名是完全不同的概念：分区键是表/索引中用于数据分片的属性字段，索引名是用户为二级索引自定义的唯一标识，二者没有关联。

get方法无返回结果的常见原因及修复 #

你使用get方法的参数格式本身没有错误，无返回可以按以下优先级排查：

• 主键结构不匹配：如果你的students表采用复合主键（分区键+排序键），get方法要求必须同时传入完整的主键值，仅传分区键无法匹配到对应记录，需要在Key字段中补充排序键的键值对。
• 数据类型不匹配：DynamoDB是强类型数据库，如果表中id字段为数字类型，你传入字符串格式的"123"会因类型不匹配无法命中记录，需要将参数改为id: 123。
• 基础配置错误：检查AWS SDK初始化时指定的区域是否与表所在区域一致，当前账号是否有students表的读权限，表名是否拼写正确。
• 记录不存在：直接在DynamoDB控制台查询对应id的记录，确认数据真实存在于目标表中。

可用代码示例 #

主表query查询（不需要IndexName参数） #

var db = new AWS.DynamoDB.DocumentClient();
const id = "123"; // 类型与表中id字段保持一致
var queryParams = {
  TableName: "students",
  KeyConditionExpression: "id = :id",
  ExpressionAttributeValues: {
    ":id": id,
  },
};

const queryResult = await db.query(queryParams).promise();
// 匹配结果存放在queryResult.Items数组中，单条记录取Items[0]即可

get查询（单主键场景） #

var db = new AWS.DynamoDB.DocumentClient();
var getParams = {
  TableName: "students",
  Key: {
    id: "123", // 注意类型匹配，数字类型不要加引号
  },
};

const getResult = await db.get(getParams).promise();
// 匹配到的记录存放在getResult.Item中，无匹配时该字段为undefined

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