La AWS SDK pour JavaScript v2 est arrivée end-of-support. Nous vous recommandons de migrer vers la [AWS SDK pour JavaScript version 3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/). Pour plus de détails et d'informations sur la façon de migrer, veuillez consulter cette [annonce](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Lecture et écriture d'un seul élément dans DynamoDB
<a name="dynamodb-example-table-read-write"></a>

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

**Cet exemple de code Node.js présente :**
+ Comment ajouter un élément dans une table DynamoDB
+ Comment récupérer un élément dans une table DynamoDB
+ Comment supprimer un élément dans une table DynamoDB

## Scénario
<a name="dynamodb-example-table-read-write-scenario"></a>

Dans cet exemple, vous utilisez une série de modules Node.js pour lire et écrire un élément dans une table DynamoDB en utilisant les méthodes suivantes de la `AWS.DynamoDB` classe client :
+ [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)

## Tâches prérequises
<a name="dynamodb-example-table-read-write-prerequisites"></a>

Pour configurer et exécuter cet exemple, réalisez tout d'abord les tâches ci-après :
+ Installez Node.js. Pour plus d'informations, consultez le site web de [Node.js](https://nodejs.org).
+ Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md).
+ Créez une table DynamoDB dont vous pouvez accéder aux éléments. Pour plus d'informations sur la création d'une table DynamoDB, consultez. [Création et utilisation de tables dans DynamoDB](dynamodb-examples-using-tables.md)

## Ecriture d'un élément
<a name="dynamodb-example-table-read-write-writing-an-item"></a>

Créez un module Node.js nommé `ddb_putitem.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à DynamoDB, créez un `AWS.DynamoDB` objet de service. Créez un objet JSON contenant les paramètres requis pour ajouter un élément, ce qui dans cet exemple inclut le nom de la table et une carte qui détermine les attributs à définir et les valeurs de chaque attribut. Appelez la `putItem` méthode de l'objet de service DynamoDB.

```
// 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);
  }
});
```

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

```
node ddb_putitem.js
```

Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddb_putitem.js).

## Obtention d'un élément
<a name="dynamodb-example-table-read-write-getting-an-item"></a>

Créez un module Node.js nommé `ddb_getitem.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à DynamoDB, créez un `AWS.DynamoDB` objet de service. Pour déterminer l'élément à obtenir, vous devez fournir la valeur de la clé primaire de cet élément dans la table. Par défaut, la méthode `getItem` renvoie toutes les valeurs d'attribut définies pour l'élément. Pour obtenir uniquement un sous-ensemble de toutes les valeurs d'attribut possible, spécifiez une expression de projection.

Créez un objet JSON contenant les paramètres requis pour obtenir un élément, ce qui dans cet exemple inclut le nom de la table, le nom et la valeur de la clé de l'élément que vous récupérez, ainsi qu'une expression de projection qui identifie l'attribut de l'élément à récupérer. Appelez la `getItem` méthode de l'objet de service DynamoDB.

```
// 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);
  }
});
```

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

```
node ddb_getitem.js
```

Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddb_getitem.js).

## Suppression d'un élément
<a name="dynamodb-example-table-read-write-deleting-an-item"></a>

Créez un module Node.js nommé `ddb_deleteitem.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à DynamoDB, créez un `AWS.DynamoDB` objet de service. Créez un objet JSON contenant les paramètres requis pour supprimer un élément, ce qui dans cet exemple inclut le nom de la table, ainsi que le nom de clé et la valeur de l'élément que vous supprimez. Appelez la `deleteItem` méthode de l'objet de service DynamoDB.

```
// 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);
  }
});
```

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

```
node ddb_deleteitem.js
```

Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddb_deleteitem.js).