Das AWS SDK for JavaScript V3-API-Referenzhandbuch beschreibt im Detail alle API-Operationen für die AWS SDK for JavaScript Version 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.

Tabellen in DynamoDB erstellen und verwenden

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 JavaScript , um Tabellen mithilfe der folgenden Methoden der DynamoDB Client-Klasse zu erstellen und mit ihnen zu arbeiten:

Erforderliche Aufgaben

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

Erstellen einer Tabelle

Erstellen Sie ein Node.js-Modul mit dem Dateinamen create-table.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-Dienstobjekts 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 an der Befehlszeile Folgendes ein.

node create-table.js 

Dieser Beispielcode finden Sie hier unter GitHub.

Listet Ihre Tabellen auf

Erstellen Sie ein Node.js-Modul mit dem Dateinamen list-tables.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-Dienstobjekts 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 an der Befehlszeile Folgendes ein.

node list-tables.js 

Dieser Beispielcode finden Sie hier unter GitHub.

Beschreiben einer Tabelle

Erstellen Sie ein Node.js-Modul mit dem Dateinamen describe-table.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-Dienstobjekts 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 an der Befehlszeile Folgendes ein.

node describe-table.js 

Dieser Beispielcode finden Sie hier unter GitHub.

Löschen einer Tabelle

Erstellen Sie ein Node.js-Modul mit dem Dateinamen delete-table.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-Dienstobjekts 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 an der Befehlszeile Folgendes ein.

node delete-table.js 

Dieser Beispielcode finden Sie hier unter GitHub.