W tym artykule omówiono wszystko na temat operacji UpdateItem. Dowiesz się o opisie operacji, parametrach i sposobie jej wykorzystania.
Synopsis DynamoDB i parametry
Jak każda inna operacja bazy danych, operacja DynamoDB UpdateItem zawiera streszczenie i odpowiednie parametry. Streszczenie Pythona dla tej operacji jest takie, 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.
Aktualizuj element (
Nazwa tabeli = 'strunowy' ,
Klucz = {
'strunowy' : { 'S' : 'strunowy' , 'N' : 'strunowy' , 'B' : b „bajty” , 'SS' : [ 'strunowy' , ... ] , „NS” : [ 'strunowy' , ... ] , „BS” : [ b „bajty” , ... ] }
} ,
UpdateExpression = 'strunowy' ,
WarunekWyrażenie = 'strunowy' ,
ExpressionAttributeValues = {
':strunowy' : { 'S' : 'strunowy' , 'N' : 'strunowy' , 'B' : b „bajty” , 'SS' : [ 'strunowy' , ... ] , „NS” : [ 'strunowy' , ... ] , „BS” : [ b „bajty” , ... ] } ,
...
} ,
Zwracane wartości = 'ŻADEN' ,
Zwrot zużytej pojemności = „INDEKSY” ,
ReturnItemCollectionMetrics = 'ROZMIAR'
)
Aby użyć operacji UpdateItem w Amazon DynamoDB, musisz użyć powyższej składni i podać kilka parametrów określających element, który zamierzasz zaktualizować. Konieczne będzie również określenie nowych wartości atrybutów dla nowego ustawienia.
Warto zauważyć, że typowe polecenie DynamoDB UpdateItem powinno zawierać następujące parametry:
- Nazwa tabeli : nazwa tabeli DynamoDB zawierającej element, który chcesz zaktualizować.
- Klucz : Klucz podstawowy (klucz partycji/klucz sortowania) elementu, który chcesz zaktualizować. Upewnij się, że określono to jako odwzorowanie par nazwa/wartość atrybutu.
- UpdateExpression : wyrażenie określające atrybuty, które należy zaktualizować, oraz nowe wartości tych atrybutów.
Ponadto może być konieczne podanie poniższych parametrów opcjonalnych. Te parametry są opcjonalne i zależą od środowiska:
- WarunekWyrażenie : Ten opcjonalny ciąg określa warunek dla operacji updateitem. Aktualizacja zakończy się pomyślnie tylko wtedy, gdy warunek ma wartość True.
- ExpressionAttributeNames : Jest to mapa zastępczych nazw atrybutów często używanych w UpdateExpression do rzeczywistych nazw atrybutów używanych w tabeli. Ten parametr jest konieczny tylko wtedy, gdy którakolwiek z nazw atrybutów w UpdateExpression zawiera zarezerwowane słowa i/lub znaki specjalne.
- ExpressionAttributeValues : To jest mapa wartości zastępczych używanych w UpdateExpression do rzeczywistych wartości, których zamierzasz użyć w operacji aktualizacji. Jest to przydatne, jeśli którakolwiek z wartości atrybutu w UpdateExpression jest wyrażeniem lub zmienną.
- Zwracane wartości : Określa, jakie informacje będą potrzebne, gdy operacja się powiedzie. Domyślna wartość to NONE, co oznacza, że nie znajdziesz żadnych informacji o odpowiedzi.
- Zwrot zużytej pojemności : Określa, ile pojemności zostało zużyte przez operację aktualizacji. Jego domyślna wartość to NONE, co oznacza, że nie znajdziesz tej informacji w wartości zwracanej.
- ReturnItemCollectionMetrics : Określa liczbę kolekcji elementów, na które ma wpływ operacja aktualizacji elementu DynamoDb. Wartość domyślna to NONE, co oznacza, że ta informacja nie jest zwracana.
Podczas korzystania z AWS CLI składnia DynamoDB UpdateItem powinna wyglądać następująco:
element aktualizacji aws dynamodb \--Nazwa tabeli NAZWA TABELI \
--klucz '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--aktualizacja-wyrażenia „USTAW NAZWĘ_ATRYBUTU = :wartość1, NAZWA_ATRYBUTU2 = :wartość2” \
--wartości-atrybutów-wyrażeń '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--zwrócone wartości ZAKTUALIZOWANO_OLD
Przykłady użycia operacji UpdateItem DynamoDB
Operacja DynamoDB UpdateItem jest łatwa w użyciu. A jednocześnie upewnij się, że uwzględniłeś atrybut klucza podstawowego i UpdateExpression.
Poniżej znajduje się przykład użycia operacji UpdateItem do zmodyfikowania tabeli DynamoDB:
element aktualizacji aws dynamodb \--Nazwa tabeli Muzyka \
--klucz '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--aktualizacja-wyrażenia 'SET AlbumTitle = :newval' \
--wartości-atrybutów-wyrażeń '{':newval':{'S':'Zaktualizowany tytuł albumu'}}' \
--zwrócone wartości WSZYSTKO NOWE
Wyniki powyższej operacji powinny wyglądać następująco:
Wniosek
Operacja DynamoDB UpdateItem jest łatwa w użyciu. Możesz go użyć do modyfikowania elementów w istniejących tabelach lub dodawania elementów do już istniejącej tabeli. Pamiętaj, że musisz określić klucz podstawowy i UpdateExpression, aby operacja zakończyła się pomyślnie. Uważaj też na swoje otoczenie. Wreszcie operacja DynamoDB UpdateItem, podobnie jak pozostałe operacje, współpracuje z pakietami AWS SDK i AWS CLI.