DynamoDB Puitem Operacja Omówienie, składnia i przykłady

Operacja DynamoDB Putitem pomaga w utworzeniu nowego elementu lub wymianie istniejącego elementu w tabeli DynamoDB. Pomaga to zachować spójność w tabelach, zapewniając wygodne przechowywanie danych w zorganizowany sposób.

Kiedy używasz tego polecenia lub dowolnego z jego pochodnych z klawiszami podstawowymi, które są takie same jak w przypadku już istniejącego elementu, zastępuje element. Z drugiej strony możesz go użyć, aby dodać element, wykorzystując operację kadry warunkowej.

Ten samouczek omawia wszystko, co powinieneś wiedzieć o DynamoDB. Przejdziemy krótki przegląd, jego składnia i kilka przypadków użycia.

Zacznijmy!

Składnia poleceń DynamoDB Putitem

Idealnie możesz użyć operacji DynamoDB PutItem z dowolnym z SDK AWS lub z wezwaniem AWS CLI API. Tak czy inaczej, musisz podać nazwę tabeli, na której chcesz dodać lub zastępować element, oraz słownik par atrybutów, które określają właściwości elementu.

Konieczne może być również określenie opcjonalnych parametrów, takich jak wartości kluczowe elementu, oczekiwane wartości dla pewnych/określonych atrybutów oraz wartości zwrotu, których oczekujesz od odpowiedzi DynamODB.

Jeśli określisz wartość atrybutu, która nie istnieje w schemacie określonej tabeli, DynamoDB tworzy atrybut dla Ciebie. Jeśli jednak spróbujesz zaktualizować atrybut, który nie jest dozwolony przez schemat tabeli, operacja się nie powiedzie.

Operacja Putitem wyróżnia się jako operacja idempotentna, co oznacza, że ​​wiele identycznych żądań ma taki sam efekt jak pojedyncze żądanie. Może to być przydatne, gdy chcesz upewnić się, że tworzysz, aktualizację lub wymian.

Operacja PutItem zwraca słownik par atrybutów, reprezentujący element, który pojawia się w tabeli po zakończeniu operacji. Może to być przydatne do debugowania lub do sprawdzenia, czy element jest prawidłowo przechowywany.

A. Korzystanie z AWS CLI do operacji DynamODB Putitem

Składnia AWS CLI dla DynamoDB Putitem jest następująco:

AWS Dynamodb Put-item \
--nazwa tabeli my_table \
--item '"pk": "s": "a12345b", "sk": "s": "x67890y", "attr1": "n": "c123d", "attr2": „S”: „ABC” '

Ten przykład dodaje nowy element do „mój stół”Tabela, która ma atrybuty kluczowe - Pk I Sk. Wartość dla głównych atrybutów, PK i SK, to odpowiednio x12345y i A67890B. Pozycja ma również dodatkowe atrybuty, takie jak ATTR1 z wartością liczbową C123D i ATTR2, która zawiera wartość ciągów ABC.

Możesz użyć opcji -return -wartości, aby określić wartości, które ma DynamODB, aby zwrócić w odpowiedzi.

Na przykład, aby zwrócić stare wartości atrybutów dla wymienianego elementu, możesz użyć następującej składni:

AWS Dynamodb Put-item \
--nazwa tabeli my_table \
--Item '"pk": "s": "a12345b", "sk": "s": "x67890y", "attr1": "n": "t456u", "attr2": „S”: „def” '\
--Wartości powrotne all_old

W poprzednim przykładzie operacja putitem zastępuje element w mój stół tabela z nowymi wartościami atrybutów określonych w -przedmiot parametr. -Wartości zwrotne Opcja określa, że ​​odpowiedź DynamoDB powinna zwrócić stare wartości atrybutu dla elementu.

B. DynamoDB Putitem Operacja za pomocą Pythona (Boto3)

Podczas korzystania z Pythona składnia powinna wyglądać tak:

Import Boto3
# Utwórz klienta DynamoDB
DynamODB = Boto3.Klient („DynamODB”)
# Ustaw nazwę tabeli i atrybuty elementów
TABLE_NAME = „MY_TABLE”
pozycja =
„PK”: 's': 'x12345y',
„sk”: 's': 'a67890b',
„attr1”: 'n': '123',
„attr2”: 's': 'abc'

# Zadzwoń do operacji putitem
Odpowiedź = DynamODB.put_item (tablename = table_name, item = item)
# Wydrukuj odpowiedź
Drukuj (odpowiedź)

Jak korzystać z operacji DynamoDB PutItem z parametrem returnValues

Możesz także użyć parametru returnValues, aby określić, jakie wartości chcesz zwrócić w odpowiedzi DynamoDB. Możliwe wartości parametru returnValues ​​obejmują następujące:

• NIC: Jest to wartość domyślna i nie zwraca żadnych wartości.
• All_old: Możesz tego użyć podczas wymiany elementu. Atrybuty elementu, który chcesz zastąpić.
• Aktualizowany_old: Jeśli element, który jest zastępowany.
• WSZYSTKO NOWE: Jeśli wymieniany element ma jakiekolwiek atrybuty, odpowiedź zawiera ich wartości.
• Aktualizowany_new: Jeśli wymieniany element ma zaktualizowane wartości atrybutów, odpowiedź zawiera nowe atrybuty.

W szczególności operacja Putitem zużywa jednostki pojemności zapisu z postanowionej pojemności zapisu tabeli. Jeśli przekroczysz przepisową pojemność tabeli, operacja najprawdopodobniej ulegnie awarii i zwróci błąd zaopatrywanie się.

Wniosek

Ogólnie rzecz biorąc, operacja DynamoDB Putitem jest potężnym sposobem na dodanie lub aktualizację elementów w tabeli DynamoDB i jest ważną częścią API DynamoDB API. Inne wspólne operacje to getitem, aktualizacja i deleteItem. Razem operacje te zapewniają bogaty zestaw opcji do czytania i zapisu do tabel DynamoDB.