Questo articolo discute tutto sull'operazione UpdateItem. Imparerai a conoscere la sinossi dell'operazione, i parametri e come usarlo.
Sinossi e parametri di DynamoDB
Come ogni altra operazione di database, l'operazione DynamoDB UpdateItem presenta una sinossi e i relativi parametri. La sinossi Python per questa operazione è come mostrato di seguito. Può variare leggermente in base al linguaggio di programmazione, ma la maggior parte dei parametri dovrebbe rimanere la stessa.
UpdateItem (
NomeTabella = 'corda' ,
Chiave = {
'corda' : { 'S' : 'corda' , 'N' : 'corda' , 'B' : b 'byte' , 'SS' : [ 'corda' , ... ] , 'NS' : [ 'corda' , ... ] , 'BS' : [ b 'byte' , ... ] }
} ,
UpdateExpression = 'corda' ,
CondizioneEspressione = 'corda' ,
ExpressionAttributeValues = {
':corda' : { 'S' : 'corda' , 'N' : 'corda' , 'B' : b 'byte' , 'SS' : [ 'corda' , ... ] , 'NS' : [ 'corda' , ... ] , 'BS' : [ b 'byte' , ... ] } ,
...
} ,
ReturnValues = 'NESSUNO' ,
ReturnConsumedCapacity = 'INDICI' ,
ReturnItemCollectionMetrics = 'TAGLIA'
)
Per utilizzare l'operazione UpdateItem in Amazon DynamoDB, dovrai utilizzare la sintassi precedente e fornire diversi parametri che specificano l'elemento che intendi aggiornare. Sarà inoltre necessario specificare i nuovi valori degli attributi per la nuova impostazione.
In particolare, un tipico comando DynamoDB UpdateItem dovrebbe contenere i seguenti parametri:
- NomeTabella : il nome della tabella DynamoDB contenente l'elemento che desideri aggiornare.
- Chiave : la chiave primaria (chiave di partizione/chiave di ordinamento) dell'elemento da aggiornare. Assicurati di specificarlo come una mappa delle coppie nome/valore dell'attributo.
- UpdateExpression : un'espressione che definisce gli attributi da aggiornare ei nuovi valori per tali attributi.
Inoltre, potrebbe essere necessario fornire i parametri facoltativi di seguito. Questi parametri sono facoltativi e dipendono dall'ambiente:
- CondizioneEspressione : Questa stringa facoltativa specifica una condizione per l'operazione updateitem. L'aggiornamento avrà esito positivo solo se la condizione restituisce True.
- ExpressionAttributeNames : è la mappa dei nomi degli attributi segnaposto spesso utilizzati in UpdateExpression ai nomi degli attributi effettivi utilizzati nella tabella. Questo parametro è necessario solo se uno dei nomi degli attributi in UpdateExpression presenta parole riservate e/o caratteri speciali.
- ExpressionAttributeValues : si tratta di una mappa dei valori segnaposto utilizzati in UpdateExpression ai valori effettivi che si intende utilizzare nell'operazione di aggiornamento. È utile se uno qualsiasi dei valori degli attributi in UpdateExpression è un'espressione o una variabile.
- ReturnValues : Questo specifica le informazioni che ti serviranno restituire dopo il successo dell'operazione. Il valore predefinito è NONE, il che significa che non troverai alcuna informazione sulla risposta.
- ReturnConsumedCapacity : specifica la quantità di capacità consumata dall'operazione di aggiornamento. Il suo valore predefinito è NONE, il che implica che non troverai questa informazione nel valore restituito.
- ReturnItemCollectionMetrics : specifica il numero di raccolte di elementi interessate dall'operazione updateitem di DynamoDb. Il valore predefinito è NONE, il che significa che queste informazioni non vengono restituite.
Quando si utilizza AWS CLI, la sintassi di DynamoDB UpdateItem dovrebbe essere simile a questa:
elemento di aggiornamento aws dynamodb \--nome-tabella NOME_TABELLA \
--chiave '{ 'NOME_CHIAVE': {'S': 'VALORE_CHIAVE' } }' \
--update-espressione 'IMPOSTA NOME_ATTRIBUTO = :val1, NOME_ATTRIBUTO2 = :val2' \
--espressione-attributo-valori '{ ':val1': {'S': 'VALORE_ATTRIBUTO' }, ':val2': {'N': 'VALORE_ATTRIBUTO' } }' \
--return-valori AGGIORNATO_OLD
Esempi su come utilizzare l'operazione UpdateItem di DynamoDB
L'operazione DynamoDB UpdateItem è facile da usare. E mentre ci sei, assicurati di includere l'attributo chiave primaria e UpdateExpression.
Di seguito è riportato un esempio di come puoi utilizzare l'operazione UpdateItem per modificare una tabella DynamoDB:
elemento di aggiornamento aws dynamodb \--nome-tabella Musica \
--chiave '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--update-espressione 'SET AlbumTitle = :newval' \
--espressione-attributo-valori '{':newval':{'S':'Titolo album aggiornato'}}' \
--return-valori TUTTO NUOVO
I risultati per l'operazione precedente dovrebbero essere simili a questi:
Conclusione
DynamoDB UpdateItem Operation è facile da usare. Puoi usarlo per modificare elementi all'interno di tabelle esistenti o aggiungere elementi a una tabella già esistente. Si noti che è necessario specificare la chiave primaria e UpdateExpression affinché l'operazione abbia esito positivo. Inoltre, sii consapevole del tuo ambiente. Infine, l'operazione DynamoDB UpdateItem, come il resto delle operazioni, funziona con SDK AWS e AWS CLI.