DasAWS SDK for JavaScriptV3-API-Referenzhandbuchbeschreibt detailliert alle API-Operationen fürAWS 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

Dieses Node.js-Codebeispiel zeigt:

Das Szenario

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

In diesem Beispiel verwenden Sie eine Reihe von Node.js Modulen, um grundlegende Operationen mit einer DynamoDB-Tabelle durchzuführen. Der Code verwendet das SDK für JavaScript die Erstellung und Arbeit mit Tabellen unter Verwendung dieser Methoden der DynamoDB Client-Klasse:

Erforderliche Aufgaben

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

Erstellen einer Tabelle

Erstellen Sie ein libs Verzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamenddbClient.js. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das DynamoDB-Client-Objekt erstellt wird. Ersetzen Sie REGION durch Ihre AWS Region.

import { DynamoDBClient } from "@aws-sdk/client-dynamodb";

export const client = new DynamoDBClient({ region: "us-east-1" })

Dieser Code ist hier verfügbar GitHub.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddb_createtable.js. Stellen Sie sicher, dass Sie das SDK wie zuvor gezeigt konfigurieren, einschließlich des Herunterladens der erforderlichen Clients und Pakete. Um auf DynamoDB zuzugreifen, erstellen Sie ein DynamoDB Client-Serviceobjekt. 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. Rufen Sie die CreateTableCommand Methode des DynamoDB-Serviceobjekts auf.

import { CreateTableCommand, DynamoDBClient } from "@aws-sdk/client-dynamodb";

const client = new DynamoDBClient({});

export const main = async () => {
  const command = new CreateTableCommand({
    TableName: "EspressoDrinks",
    // For more information about data types,
    // see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html#HowItWorks.DataTypes and
    // https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.LowLevelAPI.html#Programming.LowLevelAPI.DataTypeDescriptors
    AttributeDefinitions: [
      {
        AttributeName: "DrinkName",
        AttributeType: "S",
      },
    ],
    KeySchema: [
      {
        AttributeName: "DrinkName",
        KeyType: "HASH",
      },
    ],
    ProvisionedThroughput: {
      ReadCapacityUnits: 1,
      WriteCapacityUnits: 1,
    },
  });

  const response = await client.send(command);
  console.log(response);
  return response;
};

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

node ddb_createtable.js 

Diesen Beispielcode finden Sie hier auf GitHub.

Listen Sie Ihre Tabellen auf

Erstellen Sie ein libs Verzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamenddbClient.js. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das DynamoDB-Client-Objekt erstellt wird. Ersetzen Sie REGION durch Ihre AWS Region.

import { DynamoDBClient } from "@aws-sdk/client-dynamodb";

export const client = new DynamoDBClient({ region: "us-east-1" })

Dieser Code ist hier verfügbar GitHub.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddb_listtables.js. Stellen Sie sicher, dass Sie das SDK wie zuvor gezeigt konfigurieren, einschließlich des Herunterladens der erforderlichen Clients und Pakete. Um auf DynamoDB zuzugreifen, erstellen Sie ein DynamoDB Client-Serviceobjekt. 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. Rufen Sie die ListTablesCommand Methode des DynamoDB-Serviceobjekts auf.

import { ListTablesCommand, DynamoDBClient } from "@aws-sdk/client-dynamodb";

const client = new DynamoDBClient({});

export const main = async () => {
  const command = new ListTablesCommand({});

  const response = await client.send(command);
  console.log(response);
  return response;
};

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

node ddb_listtables.js 

Diesen Beispielcode finden Sie hier auf GitHub.

Beschreiben einer Tabelle

Erstellen Sie ein libs Verzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamenddbClient.js. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das DynamoDB-Client-Objekt erstellt wird. Ersetzen Sie REGION durch Ihre AWS Region.

import { DynamoDBClient } from "@aws-sdk/client-dynamodb";

export const client = new DynamoDBClient({ region: "us-east-1" })

Dieser Code ist hier verfügbar GitHub.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddb_describetable.js. Stellen Sie sicher, dass Sie das SDK wie zuvor gezeigt konfigurieren, einschließlich des Herunterladens der erforderlichen Clients und Pakete. Um auf DynamoDB zuzugreifen, erstellen Sie ein DynamoDB Client-Serviceobjekt. Erstellen Sie ein JSON-Objekt, das die Parameter enthält, die zur Beschreibung einer DescribeTableCommand Methode des DynamoDB-Serviceobjekts erforderlich sind.

import { DescribeTableCommand, DynamoDBClient } from "@aws-sdk/client-dynamodb";

const client = new DynamoDBClient({});

export const main = async () => {
  const command = new DescribeTableCommand({
    TableName: "Pastries",
  });

  const response = await client.send(command);
  console.log(`TABLE NAME: ${response.Table.TableName}`);
  console.log(`TABLE ITEM COUNT: ${response.Table.ItemCount}`);
  return response;
};

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

node ddb_describetable.js 

Diesen Beispielcode finden Sie hier auf GitHub.

Löschen einer Tabelle

Erstellen Sie ein libs Verzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamenddbClient.js. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das DynamoDB-Client-Objekt erstellt wird. Ersetzen Sie REGION durch Ihre AWS Region.

import { DynamoDBClient } from "@aws-sdk/client-dynamodb";

export const client = new DynamoDBClient({ region: "us-east-1" })

Dieser Code ist hier verfügbar GitHub.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ddb_deletetable.js. Stellen Sie sicher, dass Sie das SDK wie zuvor gezeigt konfigurieren, einschließlich des Herunterladens der erforderlichen Clients und Pakete. Um auf DynamoDB zuzugreifen, erstellen Sie ein DynamoDB Client-Serviceobjekt. 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. Rufen Sie die DeleteTableCommand Methode des DynamoDB-Serviceobjekts auf.

import { DeleteTableCommand, DynamoDBClient } from "@aws-sdk/client-dynamodb";

const client = new DynamoDBClient({});

export const main = async () => {
  const command = new DeleteTableCommand({
    TableName: "DecafCoffees",
  });

  const response = await client.send(command);
  console.log(response);
  return response;
};

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

node ddb_deletetable.js 

Diesen Beispielcode finden Sie hier auf GitHub.