Panoramica dell'operazione PUITEM DynamoDB, sintassi ed esempi

L'operazione PutItem DynamoDB aiuta a creare un nuovo elemento o a sostituire un elemento esistente in una tabella DynamODB. Aiuta notevolmente a mantenere la coerenza nelle tabelle assicurandoti di archiviare comodamente i tuoi dati in modo organizzato.

Quando si utilizza questo comando o uno qualsiasi dei suoi derivati ​​con chiavi primarie che sono uguali a quelle di un elemento già esistente, sostituisce l'articolo. D'altra parte, puoi usarlo per aggiungere un articolo sfruttando l'operazione put condizionale.

Questo tutorial discute tutto ciò che dovresti sapere su DynamoDB. Passeremo attraverso una breve panoramica, la sua sintassi e alcuni casi d'uso.

Iniziamo!

Sintassi del comando PutItem DynamoDB

Idealmente, è possibile utilizzare l'operazione PutItem DynamoDB con uno qualsiasi degli SDK AWS o con la chiamata API AWS CLI. In entrambi i casi, è necessario fornire il nome della tabella su cui si desidera effettuare un'aggiunta o una sostituzione dell'articolo e un dizionario delle coppie di valore di nome attributo che definiscono le proprietà dell'elemento.

Potrebbe anche essere necessario specificare i parametri opzionali come i valori della chiave primaria dell'elemento, i valori previsti per determinati/specifici attributi e i valori di restituzione che prevedi dalla risposta DynamoDB.

Se si specifica un valore dell'attributo che non esiste nello schema della tabella specificata, DynamoDB crea l'attributo per te. Tuttavia, se si tenta di aggiornare un attributo che non è consentito dallo schema della tabella, l'operazione fallisce.

L'operazione di PutItem si distingue come un'operazione idemotente, il che implica che più richieste identiche hanno lo stesso effetto di una singola richiesta. Questo può essere utile quando si desidera assicurarsi di creare, aggiornare o sostituire un elemento in una tabella DynamoDB anche se l'operazione viene ritusa più volte.

L'operazione putItem restituisce un dizionario delle coppie di valore nome attributo, che rappresentano l'elemento come appare nella tabella dopo il completamento dell'operazione. Ciò può essere utile per il debug o per verificare che l'articolo sia archiviato correttamente.

UN. Utilizzo di AWS CLI per il funzionamento PutItem DynamoDB

La sintassi di AWS CLI per il funzionamento PutItem DynamoDB è la seguente:

AWS DynamoDB Put-Item \
--table-name my_table \
--Item '"pk": "s": "a12345b", "sk": "s": "x67890y", "attr1": "n": "c123d", "attr2": "S": "ABC" '

Questo esempio aggiunge un nuovo elemento al "my_table"Tabella che ha attributi chiave primari - pk E SK. Il valore per gli attributi primari, PK e SK, sono rispettivamente X12345Y e A67890B. L'articolo presenta anche attributi aggiuntivi come ATTR1 con un valore numerico di C123D e ATRT2 che contiene un valore di stringa di ABC.

È possibile utilizzare l'opzione -Rourn -Values ​​per specificare i valori che si desidera che DynamODB restituisca nella risposta.

Ad esempio, per restituire i vecchi valori degli attributi per l'elemento che viene sostituito, è possibile utilizzare la seguente sintassi:

AWS DynamoDB Put-Item \
--table-name my_table \
--Item '"pk": "s": "a12345b", "sk": "s": "x67890y", "attr1": "n": "t456u", "attr2": "S": "def" '\
--valori di ritorno all_old

Nell'esempio precedente, l'operazione Putitem sostituisce l'elemento nel my_table tabella con i nuovi valori di attributo specificati in -articolo parametro. IL -valori di ritorno l'opzione specifica che la risposta DynamODB dovrebbe restituire i valori di vecchi attributi per l'elemento.

B. DynamoDB PutItem Operation Utilizzo di Python (Boto3)

Quando si utilizza Python, la sintassi dovrebbe apparire così:

Importa Boto3
# Crea un client DynamoDB
DynamoDB = boto3.Client ('DynamoDB')
# Imposta il nome della tabella e gli attributi elementi
table_name = 'my_table'
item =
'pk': 's': 'x12345y',
'sk': 's': 'a67890b',
'attr1': 'n': '123',
'attr2': 's': 'ABC'

# Chiama l'operazione putItem
Risposta = DynamoDB.put_item (tablename = table_name, item = item)
# Stampa la risposta
Stampa (risposta)

Come utilizzare l'operazione PutItem DynamoDB con il parametro ReturnValues

È inoltre possibile utilizzare il parametro ReturnValues ​​per specificare quali valori si desidera restituire nella risposta DynamoDB. I possibili valori per il parametro ReturnValues ​​includono quanto segue:

• NESSUNO: Questo è il valore predefinito e non restituisce alcun valori.
• All_old: Puoi usarlo quando si sostituisce un articolo. Gli attributi dell'elemento che si desidera sostituire ritornano nella risposta.
• Aggiornato_old: Se l'elemento che viene sostituito ha dei valori degli attributi già aggiornati, la risposta contiene i vecchi valori.
• TUTTO NUOVO: Se l'elemento che viene sostituito ha qualche attributo, la risposta contiene i loro valori.
• Aggiornato_new: Se l'elemento che viene sostituito ha dei valori degli attributi che sono stati aggiornati, la risposta contiene i nuovi attributi.

In particolare, l'operazione di Putitem consuma le unità di capacità di scrittura dalla capacità di scrittura provviso della tabella. Se si supera la capacità di scrittura fornita della tabella, l'operazione molto probabilmente fallirà e restituirà un errore di approvvigionamento di Exception Exception.

Conclusione

Nel complesso, l'operazione PutItem DynamoDB è un modo potente per aggiungere o aggiornare gli elementi in una tabella DynamoDB ed è una parte importante dell'API DynamoDB. Altre operazioni comuni includono getItem, updateItem e deleteItem. Insieme, queste operazioni offrono una ricca serie di opzioni da leggere e scrivere alle tabelle DynamoDB.