Erstellen und Verwenden von Tabellen in DynamoDB - AWS SDK for JavaScript

Hilf uns, das zu verbessernAWS SDK for JavaScriptVersion 3 (V3) -Dokumentation, indem Sie Feedback mithilfe derFeedbackverlinken, oder erstellen Sie ein Issue oder Pull Request aufGitHub.

DieAWS SDK for JavaScriptReferenzhandbuch zur V3-APIbeschreibt ausführlich alle API-Operationen für denAWS SDK for JavaScriptVersion 3 (V3).

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.

Erstellen und Verwenden von Tabellen in DynamoDB

JavaScript code example that applies to Node.js execution

Dieses Node.js-Codebeispiel zeigt:

  • So erstellen und verwalten Sie Tabellen zum Speichern und Abrufen von Daten aus DynamoDB.

Das Szenario

Ebenso wie andere Datenbanksysteme speichert auch DynamoDB Daten in Tabellen. Eine DynamoDB-Tabelle ist eine Sammlung von Daten, die in Elementen vergleichbar mit Zeilen organisiert sind. Um Daten in DynamoDB zu speichern oder darauf zuzugreifen, erstellen Sie Tabellen und arbeiten mit ihnen.

In diesem Beispiel verwenden Sie eine Reihe von Modulen von Node.js zum Ausführen einfacher Operationen mit einer DynamoDB-Tabelle. Der Code verwendet das SDK für JavaScript um Tabellen zu erstellen und mit ihnen zu arbeiten, indem diese Methoden desDynamoDB client class:

Erforderliche Aufgaben

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

Wichtig

In diesen Beispielen wird ECMAScript6 (ES6) verwendet. Dies erfordert Node.js Version 13.x oder höher. Informationen zum Herunterladen der neuesten Version von Node.js finden Sie unterNode.jsaus.

Wenn Sie jedoch die CommonJS-Syntax bevorzugen, lesen Sie bitteJavaScript ES6/CommonJS-Syntax

Anmerkung

Weitere Informationen über die in diesen Beispielen verwendeten Datentypen finden Sie unterUnterstützte Datentypen und Benennungsregeln in Amazon DynamoDBaus.

Erstellen einer Tabelle

Erstellen eineslibsund erstellen Sie ein Modul Node.js mit dem DateinamenddbClient.jsaus. Kopieren Sie den unten stehenden Code und fügen Sie ihn ein, wodurch das DynamoDB-Clientobjekt erstellt wird. ErsetzenREGION with your AWSRegion.

// Create service client module using ES6 syntax. import { DynamoDBClient } from "@aws-sdk/client-dynamodb"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon DynamoDB service client object. const ddbClient = new DynamoDBClient({ region: REGION }); export { ddbClient };

Dieser Code ist verfügbarhier GitHubaus.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddb_createtable.js. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt konfigurieren, einschließlich des Herunterladens der erforderlichen Clients und Pakete. Um auf DynamoDB zuzugreifen, erstellen Sie eineDynamoDB client service object. Erstellen Sie ein JSON-Objekt mit den erforderlichen Parametern für das Erstellen einer Tabelle, das in diesem Beispiel den Namen und Datentyp für jedes Attribut, das Schlüsselschema, den Namen der Tabelle und die Durchsatzeinheiten beinhaltet, die bereitgestellt werden sollen. Aufrufen Sie dieCreateTableCommand-Methode des DynamoDB--Serviceobjekts.

Anmerkung

ErsetzenTABLE_NAMEmit dem Namen der Tabelle zurück,ATTRIBUTE_NAME_1mit dem Namen des PartitionsschlüsselsATTRIBUTE_NAME_2mit dem Namen des Sortierschlüssels (optional) undATTRIBUTE_TYPEmit dem Typ des Attributs (z. B. N [für eine Zahl], S [für eine Zeichenfolge] usw.).

Anmerkung

Der Primärschlüssel für die Tabelle besteht aus den folgenden Attributen:

  • Season

  • Episode

// Import required AWS SDK clients and commands for Node.js import { CreateTableCommand } from "@aws-sdk/client-dynamodb"; import { ddbClient } from "./libs/ddbClient.js"; // Set the parameters export const params = { AttributeDefinitions: [ { AttributeName: "Season", //ATTRIBUTE_NAME_1 AttributeType: "N", //ATTRIBUTE_TYPE }, { AttributeName: "Episode", //ATTRIBUTE_NAME_2 AttributeType: "N", //ATTRIBUTE_TYPE }, ], KeySchema: [ { AttributeName: "Season", //ATTRIBUTE_NAME_1 KeyType: "HASH", }, { AttributeName: "Episode", //ATTRIBUTE_NAME_2 KeyType: "RANGE", }, ], ProvisionedThroughput: { ReadCapacityUnits: 1, WriteCapacityUnits: 1, }, TableName: "TEST_TABLE", //TABLE_NAME StreamSpecification: { StreamEnabled: false, }, }; export const run = async () => { try { const data = await ddbClient.send(new CreateTableCommand(params)); console.log("Table Created", data); return data; } catch (err) { console.log("Error", err); } }; run();

Geben Sie zum Ausführen des Beispiels Folgendes ein.

node ddb_createtable.js

Diesen Beispielcode finden Siehier GitHubaus.

Auflisten von Tabellen

Erstellen eineslibsund erstellen Sie ein Modul Node.js mit dem DateinamenddbClient.jsaus. Kopieren Sie den unten stehenden Code und fügen Sie ihn ein, wodurch das DynamoDB-Clientobjekt erstellt wird. ErsetzenREGION with your AWSRegion.

// Create service client module using ES6 syntax. import { DynamoDBClient } from "@aws-sdk/client-dynamodb"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon DynamoDB service client object. const ddbClient = new DynamoDBClient({ region: REGION }); export { ddbClient };

Dieser Code ist verfügbarhier GitHubaus.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddb_listtables.js. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt konfigurieren, einschließlich des Herunterladens der erforderlichen Clients und Pakete. Um auf DynamoDB zuzugreifen, erstellen Sie eineDynamoDB client service object. Erstellen Sie ein JSON-Objekt mit den erforderlichen Parametern für das Auflisten Ihrer Tabellen, das in diesem Beispiel die Anzahl der aufgeführten Tabellen auf 10 begrenzt. Aufrufen Sie dieListTablesCommand-Methode des DynamoDB--Serviceobjekts.

// Import required AWS SDK clients and commands for Node.js import { ListTablesCommand } from "@aws-sdk/client-dynamodb"; import { ddbClient } from "./libs/ddbClient.js"; export const run = async () => { try { const data = await ddbClient.send(new ListTablesCommand({})); console.log(data); // console.log(data.TableNames.join("\n")); return data; } catch (err) { console.error(err); } }; run();

Geben Sie zum Ausführen des Beispiels Folgendes ein.

node ddb_listtables.js

Diesen Beispielcode finden Siehier GitHubaus.

Beschreiben einer Tabelle

Erstellen eineslibsund erstellen Sie ein Modul Node.js mit dem DateinamenddbClient.jsaus. Kopieren Sie den unten stehenden Code und fügen Sie ihn ein, wodurch das DynamoDB-Clientobjekt erstellt wird. ErsetzenREGION with your AWSRegion.

// Create service client module using ES6 syntax. import { DynamoDBClient } from "@aws-sdk/client-dynamodb"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon DynamoDB service client object. const ddbClient = new DynamoDBClient({ region: REGION }); export { ddbClient };

Dieser Code ist verfügbarhier GitHubaus.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddb_describetable.js. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt konfigurieren, einschließlich des Herunterladens der erforderlichen Clients und Pakete. Um auf DynamoDB zuzugreifen, erstellen Sie eineDynamoDB client service object. Erstellen Sie ein JSON-Objekt mit den erforderlichen Parametern für die Beschreibung einesDescribeTableCommand-Methode des DynamoDB--Serviceobjekts.

Anmerkung

ErsetzenTABLE_NAMEmit dem Namen der Tabelle zurück.

// Import required AWS SDK clients and commands for Node.js import { DescribeTableCommand } from "@aws-sdk/client-dynamodb"; import { ddbClient } from "./libs/ddbClient.js"; // Set the parameters export const params = { TableName: "TABLE_NAME" }; //TABLE_NAME export const run = async () => { try { const data = await ddbClient.send(new DescribeTableCommand(params)); console.log("Success", data); // console.log("Success", data.Table.KeySchema); return data; } catch (err) { console.log("Error", err); } }; run();

Geben Sie zum Ausführen des Beispiels Folgendes ein.

node ddb_describetable.js

Diesen Beispielcode finden Siehier GitHubaus.

Löschen einer Tabelle

Erstellen eineslibsund erstellen Sie ein Modul Node.js mit dem DateinamenddbClient.jsaus. Kopieren Sie den unten stehenden Code und fügen Sie ihn ein, wodurch das DynamoDB-Clientobjekt erstellt wird. ErsetzenREGION with your AWSRegion.

// Create service client module using ES6 syntax. import { DynamoDBClient } from "@aws-sdk/client-dynamodb"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create an Amazon DynamoDB service client object. const ddbClient = new DynamoDBClient({ region: REGION }); export { ddbClient };

Dieser Code ist verfügbarhier GitHubaus.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddb_deletetable.js. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt konfigurieren, einschließlich des Herunterladens der erforderlichen Clients und Pakete. Um auf DynamoDB zuzugreifen, erstellen Sie eineDynamoDB client service object. Erstellen Sie ein JSON-Objekt mit den erforderlichen Parametern zum Löschen einer Tabelle, das in diesem Beispiel den Namen der Tabelle beinhaltet, der als Befehlszeilenparameter bereitgestellt wird. Aufrufen Sie dieDeleteTableCommand-Methode des DynamoDB--Serviceobjekts.

// Import required AWS SDK clients and commands for Node.js import { DeleteTableCommand } from "@aws-sdk/client-dynamodb"; import { ddbClient } from "./libs/ddbClient.js"; // Set the parameters export const params = { TableName: "CUSTOMER_LIST_NEW", }; export const run = async () => { try { const data = await ddbClient.send(new DeleteTableCommand(params)); console.log("Success, table deleted", data); return data; } catch (err) { console.log("Error", err); } }; run();

Geben Sie zum Ausführen des Beispiels Folgendes ein.

node ddb_deletetable.js

Diesen Beispielcode finden Siehier GitHubaus.