AWS SDK for JavaScript v2 はサポート終了となりました。[AWS SDK for JavaScript v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/) に移行することをお勧めします。その他の詳細、移行方法については、こちらの[発表内容](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)を参照してください。

# DynamoDB での単一の項目の読み取りと書き込み
<a name="dynamodb-example-table-read-write"></a>

![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/ja_jp/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)

**この Node.js コード例は以下を示しています。**
+ DynamoDB テーブルに項目を追加する方法。
+ DynamoDB テーブルで項目を取得する方法。
+ DynamoDB テーブルで項目を削除する方法。

## シナリオ
<a name="dynamodb-example-table-read-write-scenario"></a>

この例では、`AWS.DynamoDB` クライアントクラスのこれらのメソッドを使用して、一連の Node.js モジュールで、DynamoDB テーブル内の 1 つの項目を読み書きします。
+ [putItem](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB.html#putItem-property)
+ [getItem](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB.html#getItem-property)
+ [deleteItem](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB.html#deleteItem-property)

## 前提条件タスク
<a name="dynamodb-example-table-read-write-prerequisites"></a>

この例をセットアップして実行するには、まず次のタスクを完了します。
+ Node.js をインストールします。詳細については、[Node.js のウェブサイト](https://nodejs.org)を参照してください。
+ ユーザーの認証情報を使用して、共有設定ファイルを作成します。共有認証情報ファイルの提供の詳細については、[共有認証情報ファイルから Node.js に認証情報をロードする](loading-node-credentials-shared.md) を参照してください。
+ 項目にアクセスできる DynamoDB テーブルを作成します。DynamoDB テーブルを作成する方法の詳細については、[DynamoDB のテーブルの作成と使用](dynamodb-examples-using-tables.md) を参照してください。

## 項目を書き込む
<a name="dynamodb-example-table-read-write-writing-an-item"></a>

`ddb_putitem.js` というファイル名で Node.js モジュールを作成します。前に示したように SDK を必ず設定します。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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddb_putitem.js)にあります。

## 項目の取得
<a name="dynamodb-example-table-read-write-getting-an-item"></a>

`ddb_getitem.js` というファイル名で Node.js モジュールを作成します。前に示したように SDK を必ず設定します。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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddb_getitem.js)にあります。

## 項目の削除
<a name="dynamodb-example-table-read-write-deleting-an-item"></a>

`ddb_deleteitem.js` というファイル名で Node.js モジュールを作成します。前に示したように SDK を必ず設定します。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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddb_deleteitem.js)にあります。