Spickzettel für DynamoDB - 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.

Spickzettel für DynamoDB

Dieses Cheat Sheet bietet eine Kurzreferenz für die Arbeit mit Amazon DynamoDB und seinen verschiedenen SDKs. AWS

Erstes Einrichten

Weitere Informationen finden Sie auch unter:

SDK oder CLI

Wählen Sie Ihr bevorzugtes SDK aus oder richten Sie die AWS CLI ein.

Anmerkung

Wenn Sie AWS CLI unter Windows den verwenden, wird ein umgekehrter Schrägstrich (\), der sich nicht in einem Anführungszeichen befindet, als Zeilenumbruch behandelt. Außerdem müssen Sie alle Anführungszeichen und geschweiften Klammern innerhalb anderer Anführungszeichen mit einem Escape-Zeichen versehen. Ein Beispiel finden Sie auf der Registerkarte Windows unter „Erstellen einer Tabelle“ im nächsten Abschnitt.

Weitere Informationen finden Sie auch unter:

Grundlegende Aktionen

In diesem Abschnitt finden Sie Code für grundlegende DynamoDB-Aufgaben. Weitere Informationen zu diesen Aufgaben finden Sie unter Erste Schritte mit DynamoDB und den AWS SDKs.

Erstellen einer Tabelle

Default
aws dynamodb create-table \ --table-name Music \ --attribute-definitions \ AttributeName=Artist,AttributeType=S \ AttributeName=SongTitle,AttributeType=S \ --key-schema \ AttributeName=Artist,KeyType=HASH \ AttributeName=SongTitle,KeyType=RANGE \ --provisioned-throughput \ ReadCapacityUnits=10,WriteCapacityUnits=5
Windows
aws dynamodb create-table ^ --table-name Music ^ --attribute-definitions ^ AttributeName=Artist,AttributeType=S ^ AttributeName=SongTitle,AttributeType=S ^ --key-schema ^ AttributeName=Artist,KeyType=HASH ^ AttributeName=SongTitle,KeyType=RANGE ^ --provisioned-throughput ^ ReadCapacityUnits=10,WriteCapacityUnits=5

Schreiben eines Elements in eine Tabelle

aws dynamodb put-item \ --table-name Music \ --item file://item.json

Lesen eines Elements aus einer Tabelle

aws dynamodb get-item \ --table-name Music \ --item file://item.json

Löschen eines Elements aus einer Tabelle

aws dynamodb delete-item --table-name Music --key file://key.json

Abfragen einer Tabelle

aws dynamodb query --table-name Music --key-condition-expression "ArtistName=:Artist and SongName=:Songtitle"

Löschen einer Tabelle

aws dynamodb delete-table --table-name Music

Auflisten von Tabellennamen

aws dynamodb list-tables

Benennungsregeln

  • Alle Namen müssen mit UTF-8 kodiert werden und die Groß- und Kleinschreibung muss beachtet werden.

  • Tabellen- und Indexnamen müssen zwischen 3 und 255 Zeichen lang sein und dürfen nur folgende Zeichen enthalten:

    • a-z

    • A-Z

    • 0-9

    • _ (Unterstrich)

    • - (Bindestrich)

    • . (Punkt)

  • Attributnamen müssen mindestens ein Zeichen lang und dürfen nicht größer als 64 KB sein.

Weitere Informationen finden Sie unter Benennungsregeln.

Grundlegende Informationen zu Service Quotas

Lese- und Schreibeinheiten

  • Lesekapazitätseinheit (Read capacity unit, RCU) – Ein strikt konsistenter Lesevorgang pro Sekunde oder zwei letztendlich konsistente Lesevorgänge pro Sekunde für Elemente mit einer Größe von bis zu 4 KB.

  • Schreibkapazitätseinheit (Write capacity unit, WCU) – Ein Schreibvorgang pro Sekunde für Elemente mit einer Größe von bis zu 1 KB.

Tabellen-Limits

  • Tabellengröße – Es gibt praktisch kein Limit für die Tabellengröße. Tabellen sind in Bezug auf die Anzahl von Elementen oder die Anzahl von Bytes unbeschränkt.

  • Anzahl der Tabellen — Für jedes AWS Konto gibt es ein anfängliches Kontingent von 2.500 Tabellen pro Region. AWS

  • Seitengrößenbeschränkung für Abfrage und Scan – Es gibt ein Limit von 1 MB pro Seite, pro Abfrage oder Scan. Wenn Ihre Abfrageparameter oder die Scanoperation für eine Tabelle mehr als 1 MB an Daten ergeben, gibt DynamoDB die ersten übereinstimmenden Elemente zurück. Es wird auch eine Eigenschaft LastEvaluatedKey zurückgegeben, die Sie in einer neuen Anforderung verwenden können, um die nächste Seite zu lesen.

Indizes

  • Lokale sekundäre Indizes (LSIs) – Sie können maximal fünf lokale sekundäre Indizes definieren. LSIs sind in erster Linie hilfreich, wenn ein Index eine strikte Konsistenz mit der Basistabelle aufweisen muss.

  • Globale sekundäre Indizes (GSIs) – Es gibt ein Standardkontingent von 20 globalen sekundären Indizes pro Tabelle.

  • Projizierte sekundäre Indexattribute pro Tabelle – Sie können insgesamt bis zu 100 Attribute in alle lokalen und globalen sekundären Indizes einer Tabelle projizieren. Dies gilt nur für vom Benutzer angegebene, projizierte Attribute.

Partitionsschlüssel

  • Die Mindestlänge eines Partitionsschlüsselwerts beträgt 1 Byte. Die maximale Länge beträgt 2 048 Byte.

  • Es gibt praktisch keine Einschränkung in Bezug auf die Anzahl von eindeutigen Partitionsschlüsselwerten, weder für Tabellen noch für sekundäre Indizes.

  • Die Mindestlänge eines Sortierschlüsselwerts beträgt 1 Byte. Die maximale Länge beträgt 1 024 Byte.

  • Im Prinzip gibt es praktisch keine Einschränkung in Bezug auf die Anzahl von eindeutigen Sortierschlüsselwerten pro Partitionsschlüsselwert. Eine Ausnahme bilden Tabellen mit sekundären Indizes.

Weitere Informationen zu sekundären Indizes sowie zum Entwurf von Partitionsschlüsseln und Sortierschlüsseln finden Sie unter Bewährte Methoden.

Grenzwerte für häufig verwendete Datentypen

  • Zeichenfolge – Die Länge einer Zeichenfolge ist durch die maximale Elementgröße von 400 KB beschränkt. Die Zeichenfolgen sind Unicode mit binärer UTF-8-Kodierung.

  • Zahl – Eine Zahl kann bis zu 38 Nachkommastellen besitzen und positiv, negativ oder null sein.

  • Binär – Die Länge eines binären Werts ist durch die maximale Elementgröße von 400 KB beschränkt. Anwendungen, die binäre Attribute verwenden, müssen die Daten vor dem Senden an DynamoDB mit der base64-Verschlüsselung kodieren.

Eine Liste der unterstützten Datentypen finden Sie unter Datentypen. Weitere Informationen finden Sie unter Service Quotas.

Elemente, Attribute und Ausdrucksparameter

Die maximale Elementgröße in DynamoDB beträgt 400 KB. Darin inbegriffen sind die binäre Länge (UTF-8-Länge) des Attributnamens und die binäre Länge (UTF-8-Länge) des Attributwerts. Der Attributname wird bei der Größenbeschränkung mit eingerechnet.

Es gibt keine Beschränkungen in Bezug auf die Anzahl der Werte in einer Liste, einer Zuordnung oder einem Satz, solange das Element, das die Werte enthält, das Limit der Elementgröße von 400 KB einhält.

Für Ausdrucksparameter beträgt die maximale Länge von Ausdruckszeichenfolgen 4 KB.

Weitere Informationen zu Elementgröße, Attributen und Ausdrucksparametern finden Sie unter Service Quotas.

Weitere Informationen