DynamoDB UpdateItem -Vorgang

Der UpdateItem -Vorgang in AWS DynamoDB hilft Datenbankmanagern, eine vorhandene DynamoDB -Tabelle zu ändern oder zu bearbeiten. Sie können eine oder mehrere Attribute eines bereits vorhandenen Elements aktualisieren oder einem neuen Element einem vorhandenen Tabellen in Ihrer Datenbank ein neues Element hinzufügen. Insbesondere können Sie diesen Vorgang auch verwenden, um einen vorhandenen Attributwert-Pair zu ersetzen.

In diesem Artikel wird alles über den UpdateItem -Vorgang erörtert. Sie erfahren über die Zusammenfassung der Operationen, Parameter und die Verwendung.

Dynamodb -Synopse und Parameter

Wie bei jeder anderen Datenbankoperation verfügt das DynamoDB UpdateItem -Betrieb mit einer Zusammenfassung und den relevanten Parametern. Die Python -Zusammenfassung für diesen Vorgang ist wie unten gezeigt. Es kann aufgrund Ihrer Programmiersprache leicht variieren, aber die meisten Parameter sollten gleich bleiben.

UPDATEITEM (
TableName = 'String',
Key =
'String': 's': 'String', 'n': 'String', 'B': B'Bytes ',' Ss ': [' String ',…],' ns ': [' String '' ,…], 'BS': ​​[B'Bytes ',…]
,
UpdateExpression = 'String',
ConditionExpression = 'String',
ExpressionAttributeValues ​​=
': String': 's': 'String', 'n': 'String', 'B': B'Bytes ',' Ss ': [' String ',…],' ns ': [' String String ',…],' BS ': [B'Bytes',…],
…
,
ReturnValues ​​= 'keine',
ReturnconsumedCapacity = 'Indexes',
ReturnItemcollectionMetrics = 'Größe'
)

Um den UpdateItem -Vorgang in Amazon DynamoDB zu verwenden, müssen Sie die obige Syntax verwenden und mehrere Parameter angeben, die das von Ihnen beabsichtigte Element angeben, das Sie aktualisieren möchten. Sie müssen auch die neuen Attributwerte für die neue Einstellung angeben.

Insbesondere sollte ein typischer DynamoDB -UpdateItem -Befehl die folgenden Parameter enthalten:

• Tabellenname: Der Name der DynamoDB -Tabelle, die das Element enthält, das Sie aktualisieren möchten.
• Taste: Der Primärschlüssel (Partitionschlüssel/Sortierschlüssel) des Elements, den Sie aktualisiert haben. Stellen Sie sicher, dass Sie dies als Karte von Attributnamen/Wertpaaren angeben.
• UpdateExpression: Ein Ausdruck, der die Attribute definiert, die Sie aktualisieren sollten, und die neuen Werte für diese Attribute.

Darüber hinaus müssen Sie möglicherweise die folgenden optionalen Parameter bereitstellen. Diese Parameter sind optional und hängen von Ihrer Umgebung ab:

• ConditionExpression: Diese optionale Zeichenfolge gibt eine Bedingung für die AktualisierungsItemoperation an. Das Update ist nur erfolgreich, wenn die Bedingung true bewertet wird.
• ExpressionAttributenamen: Es handelt sich um eine Karte der Platzhalter -Attributnamen. Dieser Parameter ist nur dann erforderlich, wenn eines der Attributnamen in den updateExpressionsfunktionen reservierte Wörter oder/und Sonderzeichen.
• ExpressionAttributeValues: Dies ist eine Karte der Platzhalterwerte, die in der Aktualisierungsexpression zu den tatsächlichen Werten verwendet werden, die Sie in der Aktualisierungsoperation verwenden möchten. Es ist praktisch, wenn einer der Attributwerte in der UpdateExpression Ausdrücke oder Variablen sind.
• Rückkehrwerte: Dies gibt an, welche Informationen Sie nach dem Erfolg der Operation zurückgeben müssen. Der Standardwert ist keiner, was bedeutet, dass Sie keine Informationen zur Antwort finden.
• Return summeedCapacity: Dies gibt an, wie viel Kapazität durch den Update -Betrieb verbraucht wurde. Der Standardwert ist keiner, was bedeutet, dass Sie diese Informationen nicht im Rückgabewert finden werden.
• ReturnItemcollectionMetrics: Dies gibt die Anzahl der von der DynamoDB UpdateItem -Operation betroffenen Elementkollektionen an. Der Standardwert ist keiner, was bedeutet, dass diese Informationen nicht zurückgegeben werden.

Bei der Verwendung von AWS CLI sollte die DynamoDB UpdateItem -Syntax so aussehen:

AWS DynamoDB Update-Item \
--Tabellenname Tabelle_Name \
--Key '"key_name": "s": "key_value"' \
--update-expression "setze stratute_name =: val1, attribute_name2 =: val2" \
--Expression-Attribute-Values ​​'": val1": "S": "Attribute_value", ": Val2": "n": "Attribute_value"' \
--Rückkehrwerte aktualisiert_old

Beispiele zur Verwendung des DynamoDB UpdateItem -Vorgangs

Der DynamoDB UpdateItem -Vorgang ist einfach zu bedienen. Stellen Sie sicher, dass Sie das Primärschlüsselattribut und das UpdateExpression einschließen.

Im Folgenden finden Sie ein Beispiel dafür, wie Sie den UpdateItem -Vorgang verwenden können, um eine DynamoDB -Tabelle zu ändern:

AWS DynamoDB Update-Item \
--Tischname Musik \
--Key '"Artist": "S": "Sauti Sol", "Songtitle": "S": "Feel My Love"' \
--update-expression "set albumTitle =: newval" \
--Expression-Attribute-Values ​​'": newval": "S": "Aktualisiertes Albumtitel"' \
--Rückkehrwerte All_New

Die Ergebnisse für die obige Operation sollten so aussehen:

Abschluss

DynamoDB UpdateItem -Betrieb ist einfach zu bedienen. Sie können es verwenden, um Elemente in vorhandenen Tabellen zu ändern oder Elemente zu einer bereits vorhandenen Tabelle hinzuzufügen. Beachten Sie, dass Sie den Primärschlüssel und die Updatexpression angeben müssen, damit der Vorgang erfolgreich ist. Achten Sie auch auf Ihre Umgebung. Schließlich funktioniert der DynamoDB UpdateItem -Betrieb wie der Rest von Operationen mit AWS SDKs und AWS CLI.