DynamoDB表结构设计与查询有效性问题咨询

整体思路确认 #

你把parent_id设为分区键、folder_id设为排序键的思路是对的，这种设计能让同一父文件夹下的子文件夹数据集中存储在同一个分区内，完美匹配你“查询指定父文件夹下所有子文件夹”的核心场景，查询效率会很高。

问题1：查询子文件夹的代码是否为高效查询（非全表扫描） #

这段代码是正确的高效查询，不属于全表扫描：

• 你使用KeyConditionExpression指定了分区键parent_id = :pid，DynamoDB的query操作会直接定位到对应分区，仅扫描该分区内的数据，而非遍历全表。
• ScanIndexForward: false仅控制排序键的返回顺序（倒序），不会改变查询的执行逻辑，依然是精准的分区内查询。
• 你可以通过查询返回的ConsumedCapacity字段，或者DynamoDB控制台的CloudWatch指标验证：全表扫描的消耗容量会远大于这种精准分区查询。

修正格式后的代码：

router.get("/api/children_folders/:parent_id", (req, res, next) => {
  let parent_id = req.params.parent_id;
  let params = {
    TableName: tableName,
    KeyConditionExpression: "parent_id = :pid",
    ExpressionAttributeValues: {
      ":pid": parent_id,
    },
    ScanIndexForward: false,
  };

  docClient.query(params, (err, data) => {
    if (err) {
      console.log(err);
      return res.status(err.statusCode).send({
        message: err.message,
        status: err.statusCode,
      });
    } else {
      return res.status(200).send(data);
    }
  });
});

问题2：查询单个文件夹的代码问题 #

当前代码不可行，原因及解决方案如下：

• DynamoDB的query操作使用KeyConditionExpression时，必须指定分区键的值，仅指定排序键folder_id = :fid会直接报错——排序键无法单独作为查询条件（除非创建全局二级索引）。

可选解决方案 #

方案一：同时传入parent_id和folder_id

因为你的主键是复合主键（parent_id + folder_id），必须同时提供两个键的值才能精准定位到唯一条目，修改后的代码：

router.get("/api/folder/:parent_id/:folder_id", (req, res, next) => {
  let parent_id = req.params.parent_id;
  let folder_id = req.params.folder_id;
  let params = {
    TableName: tableName,
    KeyConditionExpression: "parent_id = :pid AND folder_id = :fid",
    ExpressionAttributeValues: {
      ":pid": parent_id,
      ":fid": folder_id,
    },
    Limit: 1,
  };

  docClient.query(params, (err, data) => {
    if (err) {
      console.log(err);
      return res.status(err.statusCode).send({
        message: err.message,
        status: err.statusCode,
      });
    } else {
      if (!_.isEmpty(data.Items)) {
        return res.status(200).send(data.Items[0]);
      } else {
        return res.status(404).send();
      }
    }
  });
});

方案二：创建全局二级索引（GSI）

如果不想每次查询都传入parent_id，可以创建一个以folder_id为分区键的GSI，之后就能直接通过folder_id查询。查询时需要指定IndexName参数：

router.get("/api/folder/:folder_id", (req, res, next) => {
  let folder_id = req.params.folder_id;
  let params = {
    TableName: tableName,
    IndexName: "folder_id-index", // 你的GSI名称
    KeyConditionExpression: "folder_id = :fid",
    ExpressionAttributeValues: {
      ":fid": folder_id,
    },
    Limit: 1,
  };

  docClient.query(params, (err, data) => {
    if (err) {
      console.log(err);
      return res.status(err.statusCode).send({
        message: err.message,
        status: err.statusCode,
      });
    } else {
      if (!_.isEmpty(data.Items)) {
        return res.status(200).send(data.Items[0]);
      } else {
        return res.status(404).send();
      }
    }
  });
});

注意：GSI会产生额外的存储和读写成本，适合你这种“偶尔查询单个文件夹”的场景，主表的设计依然适配核心查询需求。

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