Funzionamento Updatem DynamoDB

Funzionamento Updatem DynamoDB
L'operazione UpdateItem in AWS DynamoDB aiuta i gestori di database a modificare o modificare una tabella DynamoDB esistente. Ti consente di aggiornare uno o più attributi di un elemento già esistente o di aggiungere un nuovo elemento a un nuovo elemento a una tabella esistente all'interno del database. In particolare, puoi anche utilizzare questa operazione per sostituire una coppia di valore dell'attributo esistente.

Questo articolo discute tutto sull'operazione di aggiornamento. Imparerai a conoscere la sinossi dell'operazione, i parametri e come usarla.

Sinossi e parametri DynamoDB

Come ogni altra operazione di database, l'operazione di aggiornamento DynamoDB presenta una sinossi e i parametri pertinenti. La sinossi di Python per questa operazione è mostrata di seguito. Può variare leggermente in base al linguaggio di programmazione, ma la maggior parte dei parametri dovrebbe rimanere gli stessi.

UpdateItem (
TableName = 'String',
Key =
'String': 'S': 'String', 'N': 'String', 'B': B'Bytes ',' ss ': [' String ',…],' ns ': [' string ' ,…], 'BS': ​​[b'Bytes ',…]
,
Updatexpression = 'string',
ConditionExpression = 'String',
EspressionAttributeValues ​​=
': stringa': 's': 'string', 'n': 'string', 'b': b'bytes ',' ss ': [' string ',…],' ns ': [' stringa ',…],' Bs ': [b'bytes',…],
..
,
ReturnValues ​​= 'Nessuno',
ReturnConsumEdCapacity = 'indici',
ReturnItemCollectionMetrics = 'size'
)

Per utilizzare l'operazione UpdateItem in Amazon DynamoDB, è necessario utilizzare la sintassi sopra e fornire diversi parametri che specificano l'elemento che si intende aggiornare. Dovrai anche specificare i nuovi valori degli attributi per la nuova impostazione.

In particolare, un tipico comando dynamodb updatem dovrebbe contenere i seguenti parametri:

  • TableName: Il nome della tabella Dynamodb contenente l'elemento che si desidera aggiornare.
  • Chiave: La chiave primaria (chiave di partizione/chiave di ordinamento) dell'elemento è necessario aggiornare. Assicurati di specificarlo come una mappa delle coppie Nome/valore dell'attributo.
  • Aggiornamento di Update: Un'espressione che definisce gli attributi che dovresti aggiornare e i nuovi valori per quegli attributi.

Inoltre, potrebbe essere necessario fornire i parametri opzionali di seguito. Questi parametri sono opzionali e dipenderanno dal tuo ambiente:

  • Condizione espressione: Questa stringa opzionale specifica una condizione per l'operazione di aggiornamento. L'aggiornamento avrà successo solo se la condizione valuta True.
  • Espressionittributenames: È una mappa dei nomi degli attributi segnapunti spesso utilizzati nell'aggiornamento degli attributi effettivi utilizzati nella tabella. Questo parametro è necessario solo se uno qualsiasi dei nomi degli attributi nelle caratteristiche di UpdateSpression Words o/e caratteri speciali.
  • Espressionittributevalues: Questa è una mappa dei valori di segnaposto utilizzati nell'aggiornamento dei valori effettivi che si intende utilizzare nell'operazione di aggiornamento. È utile se uno qualsiasi dei valori di attributo nell'aggiornamento dell'espressione sono espressioni o variabili.
  • ReturnValues: Questo specifica quali informazioni di cui avrai bisogno è restituito al successo dell'operazione. Il valore predefinito non è nessuno, il che significa che non troverai alcuna informazione sulla risposta.
  • Returnconsumingcapacity: Ciò specifica quanta capacità è stata consumata dall'operazione di aggiornamento. Il suo valore predefinito non è nessuno, il che implica che non troverai queste informazioni nel valore di ritorno.
  • ReturnItemCollectionMetrics: Ciò specifica il numero di raccolte di articoli interessate dall'operazione di aggiornamento di DynamoDB. Il valore predefinito non è nessuno, il che significa che queste informazioni non vengono restituite.

Quando si utilizza AWS CLI, la sintassi di Aggiornamento DynamoDB dovrebbe apparire così:

AWS DynamoDB Update-Item \
--Table-nome Table_name \
--Key '"key_name": "s": "key_value"' \
--Aggiornamento-espressione "Imposta attributo_name =: val1, attribute_name2 =: val2" \
--espressione-attribute-value '": val1": "s": "attribute_value", ": val2": "n": "attribute_value"' \
--Valori di ritorno aggiornato_old

Esempi su come utilizzare l'operazione di aggiornamento DynamoDB

L'operazione di aggiornamento di DynamoDB è facile da usare. E mentre su di esso, assicurati di includere l'attributo della chiave primaria e l'Aggiornamento.

Di seguito è riportato un esempio di come è possibile utilizzare l'operazione UpdateItem per modificare una tabella DynamoDB:

AWS DynamoDB Update-Item \
--musica da tavolo \
--key '"artista": "s": "sauti sol", "songtitle": "s": "Feel My Love"' \
--Aggiornamento-espressione "Imposta albumTitle =: NewVal" \
--espressione-attribute-value '": newval": "s": "Titolo dell'album aggiornato"' \
--Valori di ritorno all_new

I risultati per l'operazione di cui sopra dovrebbero apparire così:

Conclusione

L'operazione di aggiornamento di DynamoDB è facile da usare. È possibile utilizzarlo per modificare gli elementi all'interno di tabelle esistenti o aggiungere elementi a una tabella già esistente. Si noti che è necessario specificare la chiave primaria e l'espressione di Update per avere successo l'operazione. Inoltre, sii consapevole del tuo ambiente. Infine, l'operazione di Updatem DynamoDB, come il resto delle operazioni, funziona con AWS SDKS e AWS CLI.