如何使用DocumentClient执行DynamoDB的describe-table请求？

没问题，我来帮你把AWS CLI的aws dynamodb describe-table --table-name MusicCollection命令转换成用DocumentClient的调用方式。先明确下：DocumentClient是AWS SDK for JavaScript（v2和v3都支持）里的便捷工具，它会自动处理DynamoDB数据类型（比如把JS对象转成DynamoDB的AttributeValue，反之亦然），用起来比原生DynamoDB客户端更省心。

一、AWS SDK for JavaScript v3（推荐） #

v3采用模块化设计，你需要先安装必要的依赖：

npm install @aws-sdk/client-dynamodb @aws-sdk/lib-dynamodb

然后编写代码：

// 导入所需模块
import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
import { DescribeTableCommand, DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";

// 初始化DynamoDB客户端和DocumentClient
const client = new DynamoDBClient({ region: "你的AWS区域" }); // 比如us-east-1
const docClient = DynamoDBDocumentClient.from(client);

// 定义DescribeTable的参数（对应CLI里的--table-name）
const params = {
  TableName: "MusicCollection"
};

// 调用describe-table方法
async function getTableDetails() {
  try {
    const response = await docClient.send(new DescribeTableCommand(params));
    console.log("表详情：", response.Table);
    return response.Table;
  } catch (error) {
    console.error("获取表详情失败：", error);
    throw error;
  }
}

// 执行函数
getTableDetails();

二、AWS SDK for JavaScript v2 #

如果你还在使用v2版本，代码会更简洁一些：
先安装依赖：

npm install aws-sdk

代码示例：

// 导入DocumentClient
const AWS = require("aws-sdk");
AWS.config.update({ region: "你的AWS区域" });

const docClient = new AWS.DynamoDB.DocumentClient();

// 定义参数
const params = {
  TableName: "MusicCollection"
};

// 回调式写法
docClient.describeTable(params, (err, data) => {
  if (err) {
    console.error("获取表详情失败：", err);
  } else {
    console.log("表详情：", data.Table);
  }
});

// 或者用async/await写法（更现代）
async function getTableDetails() {
  try {
    const data = await docClient.describeTable(params).promise();
    console.log("表详情：", data.Table);
    return data.Table;
  } catch (err) {
    console.error("获取表详情失败：", err);
    throw err;
  }
}

getTableDetails();

关键注意点 #

• 权限配置：你的AWS凭证（不管是环境变量、~/.aws/credentials文件还是IAM角色）需要拥有dynamodb:DescribeTable权限，否则会返回权限错误。
• 区域设置：一定要指定正确的AWS区域，和你创建MusicCollection表的区域一致，否则会找不到表。
• 返回结果：和CLI命令的输出结构完全一致，核心信息都在response.Table（v3）或data.Table（v2）里，包含表名、主键、状态、吞吐量配置等所有详情。

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