Polecenie DynamODB Delete-Item

Operacja DynamoDB Delete-ITEM jest jednym z głównie używanych narzędzi w zarządzaniu bazą danych. Pomaga usunąć pojedynczy element z tabeli za pomocą klucza podstawowego. W szczególności to polecenie opiera się na interfejsie API DynamoDB DeleteItem. Możesz go wywołać za pomocą polecenia Usuń CLI item.

Wykonanie warunkowego operacji usuwania w DynamoDB usuwa istniejące elementy lub elementy z oczekiwanymi wartościami atrybutów. Po usunięciu elementu możesz również zwrócić wartości atrybutu elementu za pomocą parametru DynamoDB ReturnValues.

W tym artykule koncentruje się na operacji usuwania elementu w DynamoDB. Wśród obszarów, których powinieneś się spodziewać więcej, obejmują streszczenie Usuń, jego opcje, wiersz poleceń i przykład.

DynamoDB Usuń streszczenie operacji ITMEM

Poniżej znajduje się kompletne streszczenie operacji usuwania elementu:

Usuń przedmiot
--Nazwa tabeli
--klucz
[--oczekiwany ]
[-Warditional-Operator ]
[-Wartości zwrotne ]
[-Zwyciężona zdolność ]
[--return-Item-Collection-Metrycs ]
[-Ekspresja kwalifikacyjna ]
[-Nazie wyrażania atrybutu ]
[-Wartości ekspresji-atrybut ]
[--cli-input-json ]
[-Generate-Cli-Skeleton ]
[--odpluskwić]
[--dpoint-Url ]
[-No-Verify-SSL]
[-No-pagate]
[--wyjście ]
[--zapytanie ]
[--profil ]
[--region ]
[--wersja ]
[--kolor ]
[-No-Sign-Request]
[--CA-Bundle ]
[-CLI-Read Timeout ]
[-CLI-CONNECT Timeout ]

Opcje poleceń DynamoDB Usuń-ITEM

Poniżej znajdują się główne opcje operacji usuwania i elementu:

--nazwa tabeli (ciąg)

Ta opcja określa nazwę tabeli, z której chcesz usunąć element.

--klucz (mapa)

Jest to mapa, która wyznacza lub dołącza nazwy atrybutów do odpowiednich obiektów AtrybutValue, reprezentującej klucz podstawowy elementu, który zamierzasz usunąć. Upewnij się, że podajesz pełny klucz podstawowy.

Na przykład, jeśli element ma prosty klucz podstawowy, musisz podać pasujący klucz do partycji. Z drugiej strony upewnij się, że podajesz klawisz partycji i klucz dla elementów z kompozytowymi klawiszami podstawowymi.

--Oczekiwane (mapa)

Opcja oczekiwana jest starszym parametrem. Powinieneś użyć kondycjonowania zamiast parametru.

--operator warunkowy (ciąg)

Jest to również starszy parametr i zamiast tego zaleca się użycie parametru kondycjonowania. Jego możliwe wartości to i/lub.

--Wartości zwrotne (ciąg)

Jeśli chcesz atrybutów elementu, który zamierzasz usunąć w miarę ich pojawienia się przed operacją usuwania. Możliwe wartości parametru returnValues, gdy są używane w poleceniu delete-item, to brak lub all_old.

Jeśli nie okreścisz parametru wartości zwracania lub nie umieścisz go jako brak, twój wynik nie będzie zawierał żadnych atrybutów usuniętego elementu. Idealnie nie pozostaje domyślną specyfikacją tego parametru. Jednak specyfikacja All_Old w parametrze returnValues ​​podczas operacji usuwania elementu wyceny treści dla starego elementu.

--Zwracana zdolność (ciąg)

Ten parametr określa głębokość lub poziom szczegółowości dotyczących zużycia na żądanie lub zużycie przepustowości, którą powinna zwrócić odpowiedź. Możliwe wartości dla tej opcji obejmują indeksy, ogółem i brak.

W przypadku indeksów reakcja powinna obejmować agregat ConsumedCapacity dla operacji wraz z ConstedCapacity, która jest powiązana z każdą tabelą i oceniany wskaźnik wtórny.

Z drugiej strony operacje z całkowitą specyfikacją przywracają odpowiedzi, które obejmują jedynie agregat zużytą zdolność do procesu. Wreszcie, wartości Brak są ustawieniami domyślnymi. Nie odzyskują żadnych szczegółów na temat konsumpcji zdolności Twojej operacji.

--return-Item-Collection-Metrycs (ciąg)

Parametr-return-ITEM-Collection-Metrics określa, czy potrzebujesz odpowiedzi gromadzenia pozycji w odpowiedzi. Możesz ustawić go na rozmiar lub brak, przy czym ustawienie braku jest domyślne. W ustawieniu rozmiaru Twój wynik zwraca szczegóły dotyczące kolekcji elementów, jeśli istnieją jakieś dane.

--Wyrażanie warunków (ciąg)

Wywołanie API DeleteItem nie powiedzie. To wyrażenie zawiera funkcje, parametry porównawcze i parametry logiczne.

Jak korzystać z operacji DynamoDB Usuń i jej przykład

Polecenie DynamoDB Delete-Iteme wykazuje dwie znaczące funkcje. Po pierwsze, jest to operacja idempotentna, która sugeruje, że jeśli nie określisz warunków, możesz uruchomić go kilka razy na tym samym elemencie lub atrybucie bez przywracania odpowiedzi na błąd.

Po drugie, polecenie DynamoDB Delete-Items to operacja singleton. Ta funkcja uniemożliwia uruchomienie pojedynczego polecenia, jednocześnie dążąc do usunięcia wszystkich wierszy w tabeli.

Proste polecenie Usuń-elementowe powinno wyglądać tak:

AWS Dynamodb Delete-Item \
--Muzyka nazwa tabeli \
--plik kluczowy: // klucz.JSON \
--Wartości powrotne all_old \
--Total \
--Rozmiar-element-element-element-element-element

Przykładowa odpowiedź dla poprzedniego polecenia wygląda tak:

Wniosek

Polecenie DynamoDB Delete-Item odgrywa znaczącą rolę w aktualizowaniu tabel i indeksów, ponieważ usuwa z nich elementy. Chociaż jest to polecenie CLI, możesz usunąć elementy z tabel DynamODB za pomocą konsoli zarządzania AWS lub dowolnego z SDK AWS, takich jak Boto3 dla Pythona.