Operacja aktualizacji DynamoDB

Operacja aktualizacji w AWS DynamoDB pomaga menedżerom baz danych w modyfikowaniu lub edycji istniejącej tabeli DynamoDB. Umożliwia aktualizację jednego lub więcej atrybutów już istniejącego elementu lub dodanie nowego elementu do nowego elementu do istniejącej tabeli w bazie danych. W szczególności możesz również użyć tej operacji, aby zastąpić istniejący parapet wartości atrybutu.

W tym artykule omówiono wszystko o operacji aktualizacji. Dowiesz się o streszczeniu operacji, parametrach i jak z niej korzystać.

DynamoDB Streszczenie i parametry

Jak każda inna operacja bazy danych, operacja DynamoDB aktualizacji zawiera streszczenie i odpowiednie parametry. Streszczenie Pythona dla tej operacji jest jak pokazano poniżej. Może się nieznacznie różnić w zależności od języka programowania, ale większość parametrów powinna pozostać taka sama.

Aktualizacja (
TableName = 'String',
Key =
„String”: 's': „String”, 'n': „String”, „B”: B'Bytes ”,„ ss ”: ['string',…], 'ns': [„ String ” ,…], „Bs”: [b'Bytes ',…]
,
AktualizacjaExpression = 'String',
WarunkiSpression = 'String',
ExpressionAttributeValues ​​=
„: String”: 's': „String”, 'n': 'String', 'B': B'Bytes ',' ss ': [' String ',…],' ns ': [' String „,…],„ Bs ”: [b'Bytes”,…],
…
,
ReturnValues ​​= „Brak”,
ReturnConsumedCapacity = „indekses”,
ReturnItemcollectionMetrics = „rozmiar”
)

Aby użyć operacji aktualizacji w Amazon DynamoDB, musisz użyć powyższej składni i podać kilka parametrów, które określają element, który zamierzasz zaktualizować. Będziesz także musiał określić nowe wartości atrybutów dla nowego ustawienia.

W szczególności typowe polecenie DynamoDB aktualizacji powinno zawierać następujące parametry:

• Nazwa tabeli: Nazwa tabeli DynamoDB zawierającej element, który chcesz zaktualizować.
• Klucz: Klucz podstawowy (klucz partycji/klawisz sortowania) elementu, który potrzebujesz, zaktualizowany. Upewnij się, że określacie to jako mapę pary nazwy/wartości atrybutu.
• Aktualizacja Expression: Wyrażenie określające atrybuty, które należy zaktualizować, i nowe wartości dla tych atrybutów.

Dodatkowo może być konieczne podanie opcjonalnych parametrów poniżej. Te parametry są opcjonalne i będą zależeć od twojego środowiska:

• Wyrażanie warunków: Ten opcjonalny ciąg określa warunek operacji aktualizacji. Aktualizacja odniesie sukces tylko wtedy, gdy warunek oceni True.
• ExpressionAttributenames: Jest to mapa nazw atrybutów zastępczych często używanych w aktualizacji Expression do rzeczywistych nazw atrybutów używanych w tabeli. Ten parametr jest konieczny tylko wtedy, gdy którykolwiek z nazw atrybutów w funkcjach aktualizacji Expression zarezerwowanych słów lub/i znaków specjalnych.
• ExpressionAttributeValues: Jest to mapa wartości zastępczych użytych w aktualizacji Expression do rzeczywistych wartości, których zamierzasz użyć w operacji aktualizacji. Przydaje się, jeśli którekolwiek z wartości atrybutów w aktualizacji Expression są wyrażeniami lub zmiennymi.
• ReturnValues: To określa, jakie informacje, których potrzebujesz, zwrócili po powodzenia operacji. Wartość domyślna to brak, co oznacza, że ​​nie znajdziesz żadnych informacji na temat odpowiedzi.
• ReturnConsumedCapacity: To określa, ile pojemności zużyła operacja aktualizacji. Jego domyślna wartość to brak, co oznacza, że ​​nie znajdziesz tych informacji w wartości zwracanej.
• ReturnItemcollectionMetrics: To określa liczbę kolekcji elementów, na które dotyczy operacji aktualizacji DynamoDB. Wartość domyślna to brak, co oznacza, że ​​informacje te nie są zwracane.

Korzystając z AWS CLI, składnia DynamoDB aktualizacji powinna wyglądać tak:

AWS DynamoDB Update-Item \ \
--nazwa tabeli_name \ \
--klucz '„key_name”: "s": "key_value"' \ \
--aktualizacja-wyekspresja „Ustaw atrybut_name =: val1, atrybut_name2 =: val2” \
--Expression-attribute-wartości '": val1": "s": "atrybut_value", ": val2": "n": "atrybut_value"' \ \ \
--Wartości zwrotne aktualizowane_old

Przykłady, jak korzystać z operacji aktualizacji DynamoDB

Operacja aktualizacji DynamoDB jest łatwa w użyciu. I podczas tego upewnij się, że podajesz atrybut kluczowego klucza i wyekspresję aktualizacji.

Poniżej znajduje się przykład, w jaki sposób możesz użyć operacji aktualizacji, aby zmodyfikować tabelę DynamoDB:

AWS DynamoDB Update-Item \ \
--Muzyka nazwa tabeli \
--Key '„Artist”: „S”: „Sauti sol”, „songtitle”: „s”: „Feel My Love”' \ \
--Aktualizacja „Set albumTitle =: newval” \
--Expression-attribute-wartości '": newVal": "s": „zaktualizowany tytuł albumu”' \
--Wartości powrotne all_new

Wyniki dla powyższej operacji powinny wyglądać tak:

Wniosek

Operacja aktualizacji DynamoDB jest łatwa w użyciu. Możesz go użyć do modyfikowania elementów w istniejących tabelach lub dodawanie elementów do już istniejącej tabeli. Zauważ, że musisz określić klucz podstawowy i aktualizację, aby operacja się powiodła. Uważaj także na swoje środowisko. Wreszcie, operacja aktualizacji DynamoDB, podobnie jak reszta operacji, działa z AWS SDK i AWS CLI.