Die AWS SDK für JavaScript Version 2 ist erreicht end-of-support. Wir empfehlen Ihnen, auf [AWS SDK für JavaScript Version 3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/) zu migrieren. Weitere Einzelheiten und Informationen zur Migration finden Sie in dieser [Ankündigung](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/). 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 ![JavaScript code example that applies to Node.js execution](http://docs.aws.amazon.com/de_de/sdk-for-javascript/v2/developer-guide/images/nodeicon.png) **Dieses Node.js-Codebeispiel zeigt:** + So greifen Sie mit dem Document Client auf eine DynamoDB-Tabelle zu. ## 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 [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html)in der API-Referenz. Weitere Informationen zur Programmierung mit Amazon DynamoDB finden Sie unter [Programmieren mit DynamoDB im *Amazon* DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.html) 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: + [get](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#get-property) + [put](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#put-property) + [update](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#update-property) + [query](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#query-property) + [delete](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB/DocumentClient.html#delete-property) ## Erforderliche Aufgaben Zum Einrichten und Ausführen dieses Beispiels schließen Sie zunächst diese Aufgaben ab: + Installieren Sie Node.js. Weitere Informationen finden Sie auf der [Node.js-Website](https://nodejs.org). + Erstellen Sie eine freigegebene Konfigurationsdatei mit Ihren Anmeldeinformationen. Weitere Informationen zum Bereitstellen einer Datei mit gemeinsam genutzten Anmeldeinformationen finden Sie unter [Laden der Anmeldeinformationen in Node.js aus der freigegebenen Anmeldeinformationsdatei](loading-node-credentials-shared.md). + Erstellen Sie eine DynamoDB-Tabelle, auf deren Elemente Sie zugreifen können. Weitere Hinweise zum Erstellen einer DynamoDB-Tabelle mit dem SDK für JavaScript finden Sie unter. [Tabellen in DynamoDB erstellen und verwenden](dynamodb-examples-using-tables.md) Sie können auch die [DynamoDB-Konsole](https://console.aws.amazon.com/dynamodb/) verwenden, um eine Tabelle zu erstellen. ## 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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_get.js) ## 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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_put.js) ## 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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_update.js) ## 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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_query.js) ## 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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddbdoc_delete.js)