在 DynamoDB 中读取和写入单个项目 - Amazon SDK for JavaScript
情景先决条件任务写入项目获取项目删除项目
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

我们已宣布即将终止对 Amazon SDK for JavaScript v2 的支持。建议您迁移到 Amazon SDK for JavaScript v3。有关日期、其他详细信息以及如何迁移的信息，请参阅链接的公告。

在 DynamoDB 中读取和写入单个项目

JavaScript code example that applies to Node.js execution

此 Node.js 代码示例演示：

  • 如何在 DynamoDB 表中添加项目。

  • 如何在 DynamoDB 表中检索项目。

  • 如何从 DynamoDB 表中删除项目。

情景

在本示例中，您使用一系列 Node.js 模块，通过 AWS.DynamoDB 客户端类的以下方法，在 DynamoDB 表中读取和写入一个项目：

先决条件任务

要设置和运行此示例，请先完成以下任务：

写入项目

创建文件名为 ddb_putitem.js 的 Node.js 模块。请确保按前面所示配置开发工具包。要访问 DynamoDB，请创建一个 AWS.DynamoDB 服务对象。创建一个 JSON 对象，其中包含添加项目所需的参数，在本示例中包括表的名称，定义要设置的属性的映射，以及各个属性的值。调用 DynamoDB 服务对象的 putItem 方法。

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the DynamoDB service object
var ddb = new AWS.DynamoDB({ apiVersion: "2012-08-10" });

var params = {
  TableName: "CUSTOMER_LIST",
  Item: {
    CUSTOMER_ID: { N: "001" },
    CUSTOMER_NAME: { S: "Richard Roe" },
  },
};

// Call DynamoDB to add the item to the table
ddb.putItem(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

要运行示例，请在命令行中键入以下内容。

node ddb_putitem.js

此示例代码可在 GitHub 上的此处找到。

获取项目

创建文件名为 ddb_getitem.js 的 Node.js 模块。请确保按前面所示配置开发工具包。要访问 DynamoDB，请创建一个 AWS.DynamoDB 服务对象。要标识所需获取的项目，您必须提供该项目在表中主键的值。默认情况下，getItem 方法返回为项目定义的所有属性值。要仅获取所有可能属性值的子集，请指定投影表达式。

创建一个 JSON 对象，其中包含获取某个项目所需的参数，在本示例中包括表的名称，所获取项目的键的值，以及确定要检索的项目属性的投影表达式。调用 DynamoDB 服务对象的 getItem 方法。

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the DynamoDB service object
var ddb = new AWS.DynamoDB({ apiVersion: "2012-08-10" });

var params = {
  TableName: "TABLE",
  Key: {
    KEY_NAME: { N: "001" },
  },
  ProjectionExpression: "ATTRIBUTE_NAME",
};

// Call DynamoDB to read the item from the table
ddb.getItem(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data.Item);
  }
});

要运行示例，请在命令行中键入以下内容。

node ddb_getitem.js

此示例代码可在 GitHub 上的此处找到。

删除项目

创建文件名为 ddb_deleteitem.js 的 Node.js 模块。请确保按前面所示配置开发工具包。要访问 DynamoDB，请创建一个 AWS.DynamoDB 服务对象。创建一个 JSON 对象，其中包含删除项目所需的参数，在本示例中包括表的名称，以及所删除的项目的键名和值。调用 DynamoDB 服务对象的 deleteItem 方法。

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the DynamoDB service object
var ddb = new AWS.DynamoDB({ apiVersion: "2012-08-10" });

var params = {
  TableName: "TABLE",
  Key: {
    KEY_NAME: { N: "VALUE" },
  },
};

// Call DynamoDB to delete the item from the table
ddb.deleteItem(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

要运行示例，请在命令行中键入以下内容。

node ddb_deleteitem.js

此示例代码可在 GitHub 上的此处找到。