Wir haben das Kommende end-of-support für AWS SDK für JavaScript v2 angekündigt. Wir empfehlen Ihnen, auf AWS SDK für JavaScript Version 3 zu migrieren. Termine, weitere Details und Informationen zur Migration finden Sie in der verlinkten Ankündigung.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Wir haben das Kommende end-of-support für AWS SDK für JavaScript v2 angekündigt. Wir empfehlen Ihnen, auf AWS SDK für JavaScript Version 3 zu migrieren. Termine, weitere Details und Informationen zur Migration finden Sie in der verlinkten Ankündigung.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden des DynamoDB-Dokumentenclients

Dieses Node.js-Codebeispiel zeigt:

Das Szenario

Der DynamoDB-Dokumentclient vereinfacht die Arbeit mit Elementen, indem er den Begriff der Attributwerte abstrahiert. Diese Abstraktion annotiert native JavaScript Typen, die als Eingabeparameter bereitgestellt werden, und konvertiert annotierte Antwortdaten in native Typen. JavaScript

Weitere Informationen zur DynamoDB Document Client-Klasse finden Sie AWS.DynamoDB.DocumentClientin der API-Referenz. Weitere Informationen zur Programmierung mit Amazon DynamoDB finden Sie unter Programmieren mit DynamoDB im Amazon DynamoDB Developer Guide.

In diesem Beispiel verwenden Sie eine Reihe von Node.js -Modulen, um mithilfe des Document Client grundlegende Operationen an einer DynamoDB-Tabelle durchzuführen. Der Code verwendet das SDK JavaScript zum Abfragen und Scannen von Tabellen mithilfe der folgenden Methoden der DynamoDB Document Client-Klasse:

Erforderliche Aufgaben

Zum Einrichten und Ausführen dieses Beispiels schließen Sie zunächst diese Aufgaben ab:

Abrufen eines Elements aus einer Tabelle

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddbdoc_get.js. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt, konfigurieren. Um auf DynamoDB zuzugreifen, erstellen Sie ein AWS.DynamoDB.DocumentClient Objekt. Erstellen Sie ein JSON-Objekt mit den erforderlichen Parametern für das Abrufen eines Elements aus der Tabelle, das in diesem Beispiel den Namen der Tabelle, den Namen des Hash-Schlüssels in dieser Tabelle und den Wert des Hash-Schlüssels für das abzurufende Element beinhaltet. Rufen Sie die get Methode des DynamoDB-Dokumentclients auf.

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

// Create DynamoDB document client
var docClient = new AWS.DynamoDB.DocumentClient({ apiVersion: "2012-08-10" });

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

docClient.get(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data.Item);
  }
});

Um das Beispiel auszuführen, geben Sie Folgendes in der Befehlszeile ein.

node ddbdoc_get.js

Diesen Beispielcode finden Sie hier auf. GitHub

Einfügen eines Elements in eine Tabelle

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddbdoc_put.js. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt, konfigurieren. Um auf DynamoDB zuzugreifen, erstellen Sie ein AWS.DynamoDB.DocumentClient Objekt. Erstellen Sie ein JSON-Objekt mit den erforderlichen Parametern für das Schreiben eines Elements in die Tabelle. Dieses beinhaltet in diesem Beispiel den Namen der Tabelle und eine Beschreibung des hinzuzufügenden oder zu aktualisierenden Elements, das den Hashkey und Wert sowie die Namen und Werte für Attribute beinhaltet, die für das Element festgelegt werden sollen. Rufen Sie die put Methode des DynamoDB-Dokumentclients auf.

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

// Create DynamoDB document client
var docClient = new AWS.DynamoDB.DocumentClient({ apiVersion: "2012-08-10" });

var params = {
  TableName: "TABLE",
  Item: {
    HASHKEY: VALUE,
    ATTRIBUTE_1: "STRING_VALUE",
    ATTRIBUTE_2: VALUE_2,
  },
};

docClient.put(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

Um das Beispiel auszuführen, geben Sie Folgendes in der Befehlszeile ein.

node ddbdoc_put.js

Diesen Beispielcode finden Sie hier auf. GitHub

Aktualisieren eines Elements in einer Tabelle

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddbdoc_update.js. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt, konfigurieren. Um auf DynamoDB zuzugreifen, erstellen Sie ein AWS.DynamoDB.DocumentClient Objekt. Erstellen Sie ein JSON-Objekt mit den erforderlichen Parametern für das Schreiben eines Elements in die Tabelle, das in diesem Beispiel den Namen der Tabelle, den Schlüssel des zu aktualisierenden Elements, eine Reihe von UpdateExpressions beinhaltet, die die Attribute des Elements definieren, das mit Token aktualisiert werden soll, denen Sie Werte in den ExpressionAttributeValues-Parametern zuweisen. Rufen Sie die update Methode des DynamoDB-Dokumentclients auf.

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

// Create DynamoDB document client
var docClient = new AWS.DynamoDB.DocumentClient({ apiVersion: "2012-08-10" });

// Create variables to hold numeric key values
var season = SEASON_NUMBER;
var episode = EPISODES_NUMBER;

var params = {
  TableName: "EPISODES_TABLE",
  Key: {
    Season: season,
    Episode: episode,
  },
  UpdateExpression: "set Title = :t, Subtitle = :s",
  ExpressionAttributeValues: {
    ":t": "NEW_TITLE",
    ":s": "NEW_SUBTITLE",
  },
};

docClient.update(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

Um das Beispiel auszuführen, geben Sie Folgendes in der Befehlszeile ein.

node ddbdoc_update.js

Diesen Beispielcode finden Sie hier auf. GitHub

Abfragen einer Tabelle

In diesem Beispiel wird eine Tabelle abgefragt, die Informationen zu Episoden einer Videoserie enthält, und die Episodentitel und -untertitel von Episoden der zweiten Staffel nach Episode 9 zurückgegeben, die einen angegebene Begriff im Untertitel enthalten.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddbdoc_query.js. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt, konfigurieren. Um auf DynamoDB zuzugreifen, erstellen Sie ein AWS.DynamoDB.DocumentClient Objekt. Erstellen Sie ein JSON-Objekt mit den erforderlichen Parametern für das Abfragen der Tabelle, das in diesem Beispiel den Tabellennamen, die von der Abfrage benötigten ExpressionAttributeValues und einen KeyConditionExpression beinhaltet, der diese Werte verwendet, um zu definieren, welche Elemente die Abfrage zurück gibt. Rufen Sie die query Methode des DynamoDB-Dokumentclients auf.

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

// Create DynamoDB document client
var docClient = new AWS.DynamoDB.DocumentClient({ apiVersion: "2012-08-10" });

var params = {
  ExpressionAttributeValues: {
    ":s": 2,
    ":e": 9,
    ":topic": "PHRASE",
  },
  KeyConditionExpression: "Season = :s and Episode > :e",
  FilterExpression: "contains (Subtitle, :topic)",
  TableName: "EPISODES_TABLE",
};

docClient.query(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data.Items);
  }
});

Um das Beispiel auszuführen, geben Sie Folgendes in der Befehlszeile ein.

node ddbdoc_query.js

Diesen Beispielcode finden Sie hier auf. GitHub

Löschen eines Elements aus einer Tabelle

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddbdoc_delete.js. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt, konfigurieren. Um auf DynamoDB zuzugreifen, erstellen Sie ein AWS.DynamoDB.DocumentClient Objekt. Erstellen Sie ein JSON-Objekt mit den erforderlichen Parametern für das Löschen eines Elements in der Tabelle, das in diesem Beispiel den Namen der Tabelle sowie den Namen und Wert des Hashkey des zu löschenden Elements beinhaltet. Rufen Sie die delete Methode des DynamoDB-Dokumentclients auf.

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

// Create DynamoDB document client
var docClient = new AWS.DynamoDB.DocumentClient({ apiVersion: "2012-08-10" });

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

docClient.delete(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

Um das Beispiel auszuführen, geben Sie Folgendes in der Befehlszeile ein.

node ddbdoc_delete.js

Diesen Beispielcode finden Sie hier auf. GitHub