Nous avons annoncé la sortie end-of-support de la AWS SDK for JavaScript v2. Nous vous recommandons de migrer vers la AWS SDK for JavaScript version 3. Pour les dates, les détails supplémentaires et les informations sur la façon de migrer, reportez-vous à l'annonce associée.

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

Cet exemple de code Node.js présente :

Scénario

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 :

Tâches prérequises

Pour configurer et exécuter cet exemple, réalisez tout d'abord les tâches ci-après :

Ecriture d'un élément

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.

Obtention d'un élément

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.

Suppression d'un élément

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.