Zrozumienie operacji DynamoDB GetItem

Połączenie API GetItem pomaga odzyskać elementy, które są kluczowymi elementami konstrukcyjnymi w DynamoDB. Co ciekawe, to wywołanie API obsługuje wszystkie języki programowania obsługiwane przez DynamODB. W ten sposób możesz odzyskać elementy podczas korzystania z wybranego języka.

Możesz użyć JavaScript, Python, PHP, Kotlin, Java, Go lub C++. Możesz także użyć konsoli GNU zamiast narzędzia programowania. Ten zapis wyjaśnia, jak działa operacja GetItem i jak możesz go użyć do odzyskania elementów.

Jak działa operacja getitem

Korzystanie z wywołania API GetItem z powodzeniem zależy od tego, w jaki sposób opracowujesz połączenie. Upewnij się, że podasz poprawną nazwę tabeli i klucz podstawowy elementu, który zamierzasz odzyskać. Dołącz wszystkie sekcje klucza podstawowego, które renderuje go.

Zachowanie getitem jest zależne od trzech domyślnych. Wykonuje się jako spójny odczyt, wyniki mają wszystkie atrybuty i nie zapewnia zużycia jednostki pojemności. Na podstawie tych parametrów możesz zastąpić domyślne zachowanie tego API.

W szczególności DynamODB utrzymuje najwyższej jakości niezawodność, utrzymując kilka kopii na różnych serwerach. Chociaż udany zapis tworzy te kopie, wykonanie ich może zająć znaczną ilość czasu na spełnienie ewentualnego parametru domyślnego spójności.

Implikacja jest taka, że ​​próba odczytania natychmiast po napisaniu przedmiotu jest daremną misją. Interfejs zawsze zwraca kluczową wartość dla istniejących kluczy. Jednak przywraca zerową odpowiedź na niedostępne klucze.

Składnia getitem:

Poniżej znajduje się składnia GetItem:

getItem (keyname)

W podanej składni, Keyname jest głównym parametrem i powinien zawierać pełną nazwę elementu lub klucza, którego wartość jest tym, co zamierzasz odzyskać. Odpowiedź powinna być ciągiem o wartości żądanego klucza. Ale klucze, które nie istnieją, zwracają zerową odpowiedź.

„AttributeStoget”: [„String_Value”],
„ConspectentRead”: boolean,
„ExpressionAttributenames”:
„String_value”: „String_Value”
,
"Klucz":
„String_value”:
„B”: Blob,
„Bool”: boolean,
„BS”: [Blob],
„L”: [
"Wartość atrybutu"
],
"M":
„String”: „atrybtuteValue”
,
„N”: „String”,
„Ns”: [„string_value”],
„Null”: boolean,
„S”: „String_Value”,
„SS”: [„String_Value”]

,
„ProjekcjaSpresja”: „String_value”,
„ReturnConsumedCapacity”: „String_value”,
„TableName”: „String_value”

Opcje/parametry żądania:

Korzystając z formatu JSON, żądanie GetItem akceptuje następujące dane:

• Klucz - Jest to nazwa atrybutów obiektów AtrybuteValue i reprezentacja klucza podstawowego należnego do pobierania. Wszystkie żądania muszą zawierać ciąg kluczy.
• Nazwa tabeli - Jest to ciąg, który przedstawia nazwę tabeli, która zawiera żądany klucz lub element. Musi być również na każdym żądaniu.
• AtrybtuteStoget - Jest to starszy parametr, który zawiera szereg ciągów z co najmniej 1 elementem.
• CosistentRead - Ten parametr określa model spójności odczytu żądań. Operacja GetItem domyślnie wykorzystuje ewentualny model spójności. Jednak ustawienie tego parametru na True zapewnia, że ​​proces wykorzystuje najbardziej decydujące spójne odczyty.
• ReturnConsumedCapacity - Ten parametr określa poziom szczegółowości dotyczącej zużycia przepustowości, który zwróci odpowiedź. Występują w trzech różnych indeksie kategorii, łącznie i żadnej.
• ExpressionAttributenames - W niektórych przypadkach wskazane jest użycie ekspresjiTtributenames. Na przykład możesz uzyskać dostęp do atrybutów, których nazw nie znajdują się w tandemie za pomocą słów zarezerwowanych przez DynamODB lub utworzyć symbol zastępczy w przypadku powtarzających się wystąpień. Możesz także użyć ExpressionAttributenames, aby zapobiec błędnej interpretacji znaków specjalnych w wyrażeniu.
• Ekspresja projekcji - Ten ciąg identyfikuje atrybuty pobierania z tabeli. Takie atrybuty mogą obejmować zestawy, elementy lub skalary. Upewnij się, że oddzielić każdy atrybut za pomocą przecinków. Jednak polecenie getItem zwraca wszystkie atrybuty, jeśli nie określisz żadnego atrybutu.

Przewodnik krok po kroku przy użyciu operacji getItem

Poniższe kroki ilustrują, w jaki sposób można uzyskać klawisze z tabeli DynamODB za pomocą getItem. Używamy JavaScript do tej ilustracji:

Krok 1: Utwórz klienta DynamoDB

Potrzebujesz klienta DynamoDB do tej operacji. Zatem pierwszym krokiem jest utworzenie klienta DynamoDB.

Krok 2: Utwórz dokument DynamoDB

Po uzyskaniu po stronie klienta powinieneś utworzyć przykładowy dokument lub tabelę klienta DynamoDB, z którego odzyskujesz elementy.

Krok 3: Poproś o przedmiot z tabeli

Próbka 1: Zdobądź pojedynczy element z tabeli

Poniższy wiersz poleceń powinien pomóc Ci uzyskać element z tabeli:

Import UseGetCommand z „@AWS-SDK/Dynamodb_lib”;
Import DynamOdBdocClient z „… /libs /ddbdocclient.js ";
// Ustaw parametry.
Eksportuj parametry const =
TableName: „Table_name”,
Klucz:
PrimaryKey: „String_1”,
sortkey: „String_2”,
,
;
Eksport const getItem = async () =>
próbować
const Data = oczekuj DynamodbdocClient.wyślij (nowy getCommand (parametry));
konsola.Log („Success:”, dane.Przedmiot);
catch (err)
konsola.log („błąd”);

;
Zdobądź przedmiot();

Próbka 2: Zdobądź partię przedmiotów z tabeli

Następujące polecenie pomaga uzyskać partię elementów:

import BatchExecuTeStatementCommand
import ddbdocclient
const tablename = proces.argv [2];
const songyear1 = proces.argv [3];
const songtitle1 = proces.argv [4];
const songyear2 = proces.argv [5];
const songtitle2 = proces.argv [6];
Eksport Const Run = Async (
Nazwa tabeli,
songyear1,
Songtitle1,
songyear2,
Songtitle2
) =>
Parametry const =
Sprawozdania: [

Instrukcja: „Wybierz _ z” + tableName + ”gdzie tytuł =? i rok =?",
Parametry: [s: movietitle1, n: movieyear1],
,

Instrukcja: „Wybierz * from” + tablename + ”gdzie tytuł =? i rok =?",
Parametry: [s: songtitle2, n: songyear2],
,
],
;
próbować
const Data = oczekuj DynamodbdocClient.wysłać(
Nowy BatchExecuTeStatementCommand (parametry)
);
dla (niech i = 0; i < data.Responses.length; i++)
konsola.log (dane.Odpowiedzi [i].Przedmiot.rok);
konsola.log (dane.Odpowiedzi [i].Przedmiot.tytuł);

powrót „Uruchom pomyślnie”;
catch (err)
konsola.błąd (err);

;
Run (Tablename, Songyear1, Songtitle1, Songyear2, Songtitle2);

Wniosek

Możesz użyć dostarczonych metod, aby znaleźć elementy, które poprawnie pasują do określonych parametrów w tabeli DynamoGB. Wywołanie API GetItem odzyskuje wartości z wewnętrznego uporczywego sklepu aplikacji. W szczególności wszystkie wartości przechowywane w Dynamogb są udostępniane między wszystkimi sesjami i profilem i są dostępne tak długo, jak aplikacja pozostaje zainstalowana.