Dieser Artikel behandelt alles über den UpdateItem-Vorgang. Sie lernen die Synopse, die Parameter und die Verwendung der Operation kennen.
Synopse und Parameter von DynamoDB
Wie jede andere Datenbankoperation verfügt auch die UpdateItem-Operation von DynamoDB über eine Zusammenfassung und die relevanten Parameter. Die Python-Übersicht für diese Operation ist wie unten gezeigt. Es kann je nach Programmiersprache leicht variieren, aber die meisten Parameter sollten gleich bleiben.
UpdateItem (
Tabellenname = 'Schnur' ,
Taste = {
'Schnur' : { 'S' : 'Schnur' , 'N' : 'Schnur' , 'B' : b 'Bytes' , 'SS' : [ 'Schnur' , ... ] , 'NS' : [ 'Schnur' , ... ] , 'BS' : [ b 'Bytes' , ... ] }
} ,
UpdateExpression = 'Schnur' ,
Bedingungsausdruck = 'Schnur' ,
ExpressionAttributeValues = {
':Zeichenfolge' : { 'S' : 'Schnur' , 'N' : 'Schnur' , 'B' : b 'Bytes' , 'SS' : [ 'Schnur' , ... ] , 'NS' : [ 'Schnur' , ... ] , 'BS' : [ b 'Bytes' , ... ] } ,
...
} ,
Rückgabewerte = 'KEINER' ,
Verbrauchte Kapazität zurückgeben = 'INDIZES' ,
ReturnItemCollectionMetrics = 'GRÖSSE'
)
Um die UpdateItem-Operation in Amazon DynamoDB zu verwenden, müssen Sie die obige Syntax verwenden und mehrere Parameter angeben, die das 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 (Partitionsschlüssel/Sortierschlüssel) des Elements, das Sie aktualisieren müssen. Stellen Sie sicher, dass Sie dies als Zuordnung von Attributname/Wert-Paaren angeben.
- UpdateExpression : Ein Ausdruck, der die zu aktualisierenden Attribute und die neuen Werte für diese Attribute definiert.
Darüber hinaus müssen Sie möglicherweise die folgenden optionalen Parameter angeben. Diese Parameter sind optional und hängen von Ihrer Umgebung ab:
- Bedingungsausdruck : Diese optionale Zeichenfolge gibt eine Bedingung für den Updateitem-Vorgang an. Die Aktualisierung ist nur erfolgreich, wenn die Bedingung zu True ausgewertet wird.
- ExpressionAttributeNames : Es ist eine Zuordnung von Platzhalterattributnamen, die häufig in UpdateExpression verwendet werden, zu den tatsächlichen Attributnamen, wie sie in der Tabelle verwendet werden. Dieser Parameter ist nur erforderlich, wenn einer der Attributnamen im UpdateExpression reservierte Wörter und/oder Sonderzeichen enthält.
- ExpressionAttributeValues : Dies ist eine Zuordnung von Platzhalterwerten, die in UpdateExpression verwendet werden, zu den tatsächlichen Werten, die Sie im Aktualisierungsvorgang verwenden möchten. Es ist praktisch, wenn einer der Attributwerte in UpdateExpression Ausdrücke oder Variablen sind.
- Rückgabewerte : Dies gibt an, welche Informationen Sie nach dem Erfolg der Operation zurückgeben müssen. Der Standardwert ist NONE, was bedeutet, dass Sie keine Informationen zur Antwort finden.
- Verbrauchte Kapazität zurückgeben : Dies gibt an, wie viel Kapazität durch den Aktualisierungsvorgang verbraucht wurde. Sein Standardwert ist NONE, was bedeutet, dass Sie diese Information nicht im Rückgabewert finden.
- ReturnItemCollectionMetrics : Dies gibt die Anzahl der Elementsammlungen an, die von der Updateitem-Operation von DynamoDb betroffen sind. Der Standardwert ist NONE, was bedeutet, dass diese Informationen nicht zurückgegeben werden.
Bei Verwendung von AWS CLI sollte die DynamoDB UpdateItem-Syntax wie folgt aussehen:
aws dynamodb update-item \--Tabellenname TABELLENNAME \
--Schlüssel '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--update-Ausdruck 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--Ausdrucksattributwerte '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--Rückgabewerte AKTUALISIERT_ALT
Beispiele zur Verwendung der UpdateItem-Operation von DynamoDB
Die UpdateItem-Operation von DynamoDB ist einfach zu verwenden. Stellen Sie dabei sicher, dass Sie das Primärschlüsselattribut und den UpdateExpression einschließen.
Nachfolgend finden Sie ein Beispiel dafür, wie Sie die UpdateItem-Operation verwenden können, um eine DynamoDB-Tabelle zu ändern:
aws dynamodb update-item \--Tabellenname Musik \
--Schlüssel '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--update-Ausdruck 'SET AlbumTitle = :newval' \
--Ausdrucksattributwerte '{':newval':{'S':'Aktualisierter Albumtitel'}}' \
--Rückgabewerte ALLES NEU
Die Ergebnisse für die obige Operation sollten wie folgt aussehen:
Fazit
DynamoDB UpdateItem Operation ist einfach zu verwenden. 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 den UpdateExpression angeben müssen, damit der Vorgang erfolgreich ist. Denken Sie auch an Ihre Umgebung. Schließlich funktioniert die UpdateItem-Operation von DynamoDB wie die übrigen Operationen mit AWS SDKs und AWS CLI.