DynamoDB API - Amazon-DynamoDB

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.

DynamoDB API

Um mit Amazon DynamoDB zu arbeiten, muss Ihre Anwendung einige einfache API Operationen verwenden. Im Folgenden finden Sie eine Zusammenfassung dieser Operationen nach Kategorie sortiert.

Anmerkung

Eine vollständige Liste der API Vorgänge finden Sie in der Amazon DynamoDB DynamoDB-Referenz API.

Steuerebene

Mit Steuerungsebenenoperationen können Sie DynamoDB-Tabellen erstellen und verwalten. Außerdem ermöglichen sie die Arbeit mit Indexen, Streams und anderen Objekten, die von Tabellen abhängen.

  • CreateTable – Erstellt eine neue Tabelle. Optional können Sie eine oder mehrere sekundäre Indxe erstellen und DynamoDB Streams für die Tabelle aktivieren

  • DescribeTable – Gibt Informationen über eine Tabelle zurück, wie das entsprechende Primärschlüsselschema, Durchsatzeinstellungen und Indexinformationen.

  • ListTables – Gibt die Namen aller Ihrer Tabellen in einer Liste zurück

  • UpdateTable – Ändert die Einstellungen einer Tabelle oder deren Index, erstellt oder entfernt neue Indexe aus einer Tabelle oder ändert die DynamoDB-Streams-Einstellungen für eine Tabelle

  • DeleteTable – Entfernt eine Tabelle und alle davon abhängigen Objekte aus DynamoDB

Datenebene

Mit Operationen auf Datenebene können Sie Aktionen zum Erstellen, Lesen, Aktualisieren und Löschen (auch genannt CRUD) für Daten in einer Tabelle ausführen. Einige Operationen auf Datenebene ermöglichen außerdem das Lesen von Daten aus einem Sekundärindex.

Sie könnenPartiQL – Eine SQL-kompatible Abfragesprache für Amazon DynamoDB, verwenden, um diese CRUD Operationen auszuführen, oder Sie können den Klassiker von DynamoDB verwenden CRUDAPIs, der jede Operation in einen eigenen API Aufruf unterteilt.

PartiQL - Eine SQL -kompatible Abfragesprache

  • ExecuteStatement - Liest mehrere Elemente aus einer Tabelle. Sie können auch ein einzelnes Element aus einer Tabelle schreiben oder aktualisieren. Beim Schreiben oder Aktualisieren eines einzelnen Elements müssen Sie die Primärschlüsselattribute angeben.

  • BatchExecuteStatement - Schreibt, aktualisiert oder liest mehrere Elemente aus einer Tabelle. Dies ist effizienter, als ExecuteStatement weil Ihre Anwendung nur einen einzigen Netzwerk-Roundtrip zum Schreiben oder Lesen der Elemente benötigt.

Klassisch APIs

Erstellen von Daten

  • PutItem – Schreibt ein einzelnes Element in eine Tabelle. Sie müssen nur die Primärschlüsselattribute angeben, keine anderen Attribute.

  • BatchWriteItem – Schreibt bis zu 25 Elemente in eine Tabelle. Dies ist effizienter als PutItem mehrfach aufzurufen, da Ihre Anwendung nur einen einzigen Netzlauf zum Schreiben der Elemente benötigt.

Lesen von Daten

  • GetItem – Ruft ein einzelnes Element aus einer Tabelle ab. Sie müssen den Primärschlüssel für das gewünschte Element angeben. Sie können das gesamte Element oder nur eine Teilmenge seiner Attribute abrufen.

  • BatchGetItem – Ruft bis zu 100 Elemente aus einer oder mehreren Tabellen ab. Dies ist effizienter als GetItem mehrfach aufzurufen, da Ihre Anwendung nur einen einzigen Netzlauf zum Lesen der Elemente benötigt.

  • Query – Ruft alle Elemente mit einem bestimmten Partitionsschlüssel ab. Sie müssen den Partitionsschlüsselwert angeben. Sie können ganze Elemente oder nur eine Teilmenge ihrer Attribute abrufen. Optional können Sie eine Bedingung auf die Sortierschlüsselwerte anwenden, so dass Sie nur den Teil der Daten abrufen, denen derselbe Partitionsschlüssel zugeordnet ist. Sie können diese Operation für eine Tabelle verwenden, sofern die Tabelle sowohl einen Partitions- als auch einen Sortierschlüssel hat. Außerdem können Sie diese Operation für einen Index nutzen, sofern der Index sowohl einen Partitions- als auch einen Sortierschlüssel umfasst.

  • Scan – Ruft alle Elemente in der angegebenen Tabelle oder dem Index ab. Sie können ganze Elemente oder nur eine Teilmenge ihrer Attribute abrufen. Optional können Sie eine Filterbedingung anwenden, um nur die gewünschten Werte zurückzugeben und den Rest zu verwerfen.

Aktualisieren von Daten

  • UpdateItem – Ändert ein oder mehrere Attribute in einem Element. Sie müssen den Primärschlüssel für das Element angeben, das Sie ändern möchten. Sie können neue Attribute hinzufügen und vorhandene Attribute ändern oder entfernen. Außerdem können Sie bedingte Aktualisierungen durchführen, so dass die Aktualisierung nur erfolgreich ist, wenn eine benutzerdefinierte Bedingung erfüllt ist. Wahlweise können Sie einen unteilbaren Zähler implementieren, der ein numerisches Attribut erhöht oder senkt, ohne dass Konflikte mit anderen Schreibanforderungen auftreten.

Löschen von Daten

  • DeleteItem – Löscht ein einzelnes Element aus einer Tabelle. Sie müssen den Primärschlüssel für das Element angeben, das Sie löschen möchten.

  • BatchWriteItem – Löscht bis zu 25 Elemente aus einer oder mehreren Tabellen. Dies ist effizienter, als DeleteItem mehrfach aufzurufen, da Ihre Anwendung nur einen einzigen Netzlauf zum Löschen der Elemente benötigt.

    Anmerkung

    Sie können BatchWriteItem verwenden, um sowohl Daten zu erstellen als auch Daten zu löschen.

DynamoDB-Streams

Mit DynamoDB-Streams-Operationen können Sie einen Stream in einer Tabelle aktivieren oder deaktivieren und den Zugriff auf die in einem Stream enthaltenen Datenänderungsdatensätze zulassen.

  • ListStreams – Gibt eine Liste aller Streams oder nur den Stream für eine bestimmte Tabelle zurück

  • DescribeStream— Gibt Informationen über einen Stream zurück, z. B. seinen Amazon-Ressourcennamen (ARN) und den Ort, an dem Ihre Anwendung mit dem Lesen der ersten Stream-Datensätze beginnen kann.

  • GetShardIterator – Gibt einen Shard Iterator zurück. Hierbei handelt es sich um eine Datenstruktur, die Ihre Anwendung zum Abrufen der Datensätze aus dem Stream verwendet.

  • GetRecords – Ruft einen oder mehrere Stream-Datensätze unter Verwendung eines bestimmten Shard Iterators ab

Transaktionen

Transaktionen bieten Atomarität, Konsistenz, Isolierung und Haltbarkeit (ACID), sodass Sie die Datenkorrektheit in Ihren Anwendungen einfacher aufrechterhalten können.

Sie könnenPartiQL – Eine SQL-kompatible Abfragesprache für Amazon DynamoDB, verwenden, um Transaktionsoperationen durchzuführen, oder Sie können den Klassiker von DynamoDB verwenden CRUDAPIs, der jeden Vorgang in einen eigenen Aufruf unterteilt. API

PartiQL - Eine SQL -kompatible Abfragesprache

  • ExecuteTransaction— Eine Batch-Operation, die CRUD Operationen mit mehreren Elementen sowohl innerhalb als auch tabellenübergreifend mit einem garantierten all-or-nothing Ergebnis ermöglicht.

Klassisch APIs

  • TransactWriteItems— Ein Batch-Vorgang, der Delete Operationen mit PutUpdate, und für mehrere Elemente sowohl innerhalb als auch tabellenübergreifend mit einem garantierten all-or-nothing Ergebnis ermöglicht.

  • TransactGetItems – Ein Batch-Vorgang, der Get-Operationen verwendet, um mehrere Elemente aus einer oder mehreren Tabellen abzurufen.