DynamoDB Puitem -Operation Übersicht, Syntax und Beispiele

Der DynamoDB PutItem -Betrieb hilft beim Erstellen eines neuen Elements oder beim Ersetzen eines vorhandenen Elements in einer DynamoDB -Tabelle. Es hilft bemerkenswerterweise, die Konsistenz in Ihren Tabellen aufrechtzuerhalten, indem Sie sicherstellen, dass Sie Ihre Daten bequem auf organisierte Weise speichern.

Wenn Sie diesen Befehl oder einen seiner Derivate mit Primärschlüssel verwenden, die mit denen eines bereits vorhandenen Elements übereinstimmen, ersetzt er das Element. Andererseits können Sie es verwenden, um einen Artikel hinzuzufügen, indem Sie den bedingten Put -Betrieb nutzen.

In diesem Tutorial werden alles besprochen, was Sie über DynamoDB wissen sollten. Wir werden einen kurzen Überblick, seine Syntax und einige Anwendungsfälle durchlaufen.

Lass uns anfangen!

DynamoDB PutItem Command Syntax

Idealerweise können Sie den DynamoDB PutItem -Betrieb mit einem der AWS -SDKs oder mit AWS -Cli -API -Aufruf verwenden. In beiden Fällen müssen Sie den Namen der Tabelle angeben, auf der Sie eine Elementzusatz oder ein Austausch vornehmen möchten, und ein Wörterbuch von Attributnamen-Wert-Paaren, die die Eigenschaften des Elements definieren.

Möglicherweise müssen Sie auch die optionalen Parameter angeben, wie z.

Wenn Sie einen Attributwert angeben, der im Schema der angegebenen Tabelle nicht vorhanden ist, erstellt DynamoDB das Attribut für Sie. Wenn Sie jedoch versuchen, ein Attribut zu aktualisieren, das durch das Schema der Tabelle nicht zulässig ist, schlägt die Operation fehl.

Die PutItem -Operation sticht als identische Operation aus, was impliziert, dass mehrere identische Anforderungen den gleichen Effekt wie eine einzige Anforderung haben. Dies kann nützlich sein, wenn Sie sicherstellen möchten, dass Sie ein Element in einer DynamoDB -Tabelle erstellen, aktualisieren oder ersetzen, selbst wenn der Vorgang mehrfach wiedergegeben wird.

Die PutItem-Operation gibt ein Wörterbuch von Attributnamen-Wert-Paaren zurück, das das Element darstellt, wie es in der Tabelle nach Abschluss der Operation angezeigt wird. Dies kann zum Debuggen oder zur Überprüfung, ob der Artikel korrekt gespeichert wird, nützlich sein.

A. Verwenden von AWS CLI für DynamoDB PutItem -Betrieb

Die AWS -CLI -Syntax für DynamoDB PutItem -Operation lautet wie folgt:

AWS DynamoDB put-item \
--Tabellenname my_table \
--Element '"PK": "S": "A12345B", "SK": "S": "x67890y", "attr1": "n": "C123D", "Attr2": " "S": "ABC" '

Dieses Beispiel fügt dem "einen neuen Artikel hinzu"mein TischTabelle mit primären Schlüsselattributen - pk Und SK. Der Wert für die primären Attribute PK und SK sind x12345y bzw. a67890b. Das Element verfügt außerdem über zusätzliche Attribute wie ATT1 mit einem numerischen Wert von C123D und Attr2, der einen String -Wert von ABC enthält.

Sie können die Option -return -Werte verwenden, um die Werte anzugeben, die die DynamoDB in der Antwort zurückgeben soll.

Zum Beispiel können Sie die folgende Syntax verwenden, um die alten Attributwerte für das ersetzte Element zurückzugeben:

AWS DynamoDB put-item \
--Tabellenname my_table \
--Element '"PK": "S": "A12345B", "SK": "S": "x67890y", "Attr1": "n": "T456U", "attr2": " "S": "def" '\
--Rückkehrwerte All_old

Im vorherigen Beispiel ersetzt der PutItem -Betrieb den Artikel in der mein Tisch Tabelle mit den neuen Attributwerten, die in der angegeben sind -Artikel Parameter. Der -Rückkehrwerte Die Option gibt an, dass die DynamoDB -Antwort die alten Attributwerte für das Element zurückgeben sollte.

B. DynamoDB PutItem -Betrieb mit Python (Boto3)

Bei der Verwendung von Python sollte die Syntax so aussehen:

Boto3 importieren
# Erstellen Sie einen DynamoDB -Client
DynamoDB = Boto3.Client ('DynamoDB')
# Legen Sie den Tabellennamen und die Elementattribute fest
table_name = 'my_table'
item =
'pk': 's': 'x12345y',
'sk': 's': 'a67890b',
'attr1': 'n': '123',
'attr2': 's': 'abc'

# Rufen Sie die PutItem -Operation an
Antwort = DynamoDB.put_item (tableName = table_name, item = item)
# Drucken Sie die Antwort
Druck (Antwort)

So verwenden Sie den DynamoDB PutItem -Vorgang mit dem Parameter returnValues

Sie können auch den Parameter von returnValues ​​verwenden, um anzugeben, welche Werte Sie in der DynamoDB -Antwort zurückgegeben werden möchten. Die möglichen Werte für den Parameter returnValues ​​enthalten Folgendes:

• KEINER: Dies ist der Standardwert und gibt keine Werte zurück.
• All_old: Sie können dies verwenden, wenn Sie einen Artikel ersetzen. Die Attribute des Elements, den Sie ersetzen möchten.
• Updated_old: Wenn das ersetztes Element irgendwelche Attributwerte enthält, die bereits aktualisiert wurden, enthält die Antwort die alten Werte.
• ALLES NEU: Wenn das ersetztes Element irgendwelche Attribute hat, enthält die Antwort ihre Werte.
• Updated_new: Wenn das ersetztes Element über die aktualisierten Attributwerte verfügt, enthält die Antwort die neuen Attribute.

Insbesondere der PutItem -Betrieb verbraucht die Schreibkapazitätseinheiten aus der vorgesehenen Schreibkapazität der Tabelle. Wenn Sie die vorgesehene Schreibkapazität der Tabelle überschreiten, fällt der Vorgang höchstwahrscheinlich aus und gibt einen vorgesehenen Fehler mit.

Abschluss

Insgesamt ist der DynamoDB PutItem -Vorgang eine leistungsstarke Möglichkeit, die Elemente in einer DynamoDB -Tabelle hinzuzufügen oder zu aktualisieren, und ein wichtiger Bestandteil der DynamoDB -API. Weitere gängige Operationen sind GetItem, UpdateItem und DeleteItem. Zusammen bieten diese Vorgänge eine Reihe von Optionen zum Lesen und Schreiben von DynamoDB -Tabellen.