Artikel ini membincangkan segala-galanya tentang operasi UpdateItem. Anda akan belajar tentang sinopsis operasi, parameter dan cara menggunakannya.
Sinopsis dan Parameter DynamoDB
Seperti setiap operasi pangkalan data lain, operasi DynamoDB UpdateItem menampilkan sinopsis dan parameter yang berkaitan. Sinopsis Python untuk operasi ini adalah seperti yang ditunjukkan di bawah. Ia mungkin berbeza sedikit berdasarkan bahasa pengaturcaraan anda tetapi kebanyakan parameter harus kekal sama.
Kemas KiniItem (
Nama Jadual = 'tali' ,
kunci = {
'tali' : { 'S' : 'tali' , 'N' : 'tali' , 'B' : b 'bait' , 'SS' : [ 'tali' , ... ] , 'NS' : [ 'tali' , ... ] , 'BS' : [ b 'bait' , ... ] }
} ,
UpdateExpression = 'tali' ,
ConditionExpression = 'tali' ,
ExpressionAttributeValues = {
':tali' : { 'S' : 'tali' , 'N' : 'tali' , 'B' : b 'bait' , 'SS' : [ 'tali' , ... ] , 'NS' : [ 'tali' , ... ] , 'BS' : [ b 'bait' , ... ] } ,
...
} ,
ReturnValues = 'TIADA' ,
ReturnConsumedCapacity = 'INDEX' ,
ReturnItemCollectionMetrics = 'SAIZ'
)
Untuk menggunakan operasi UpdateItem dalam Amazon DynamoDB, anda perlu menggunakan sintaks di atas dan menyediakan beberapa parameter yang menentukan item yang anda ingin kemas kini. Anda juga perlu menentukan nilai atribut baharu untuk tetapan baharu.
Terutama, perintah DynamoDB UpdateItem biasa harus mengandungi parameter berikut:
- Nama Jadual : Nama jadual DynamoDB yang mengandungi item yang anda ingin kemas kini.
- kunci : Kunci utama (kunci partition/kunci isihan) item yang anda perlu kemas kini. Pastikan anda menetapkan ini sebagai peta pasangan nama/nilai atribut.
- UpdateExpression : Ungkapan yang mentakrifkan atribut yang perlu anda kemas kini dan nilai baharu untuk atribut tersebut.
Selain itu, anda mungkin perlu menyediakan parameter pilihan di bawah. Parameter ini adalah pilihan dan bergantung pada persekitaran anda:
- ConditionExpression : Rentetan pilihan ini menentukan syarat untuk operasi item kemas kini. Kemas kini hanya akan berjaya jika keadaan bernilai Benar.
- ExpressionAttributeNames : Ia adalah peta nama atribut pemegang tempat yang sering digunakan dalam UpdateExpression kepada nama atribut sebenar seperti yang digunakan dalam jadual. Parameter ini hanya perlu jika mana-mana nama atribut dalam UpdateExpression menampilkan perkataan atau/dan aksara khas yang dikhaskan.
- ExpressionAttributeValues : Ini ialah peta nilai pemegang tempat yang digunakan dalam UpdateExpression kepada nilai sebenar yang anda ingin gunakan dalam operasi kemas kini. Ia berguna jika mana-mana nilai atribut dalam UpdateExpression ialah ungkapan atau pembolehubah.
- ReturnValues : Ini menentukan maklumat yang anda perlukan dikembalikan selepas kejayaan operasi. Nilai lalai ialah NONE, bermakna anda tidak akan menemui sebarang maklumat pada respons.
- ReturnConsumedCapacity : Ini menentukan jumlah kapasiti yang digunakan oleh operasi kemas kini. Nilai lalainya ialah NONE, membayangkan bahawa anda tidak akan menemui maklumat ini dalam nilai pulangan.
- ReturnItemCollectionMetrics : Ini menentukan bilangan koleksi item yang dipengaruhi oleh operasi item kemas kini DynamoDb. Nilai lalai ialah NONE, yang bermaksud bahawa maklumat ini tidak dikembalikan.
Apabila menggunakan AWS CLI, sintaks DynamoDB UpdateItem sepatutnya kelihatan seperti ini:
aws dynamodb kemas kini-item \--nama-jadual TABLE_NAME \
--kunci '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--kemas kini-ungkapan 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--expression-attribute-values '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--nilai-pulangan UPDATED_OLD
Contoh tentang Cara Menggunakan Operasi DynamoDB UpdateItem
Operasi DynamoDB UpdateItem mudah digunakan. Dan semasa melakukannya, pastikan anda memasukkan atribut kunci utama dan UpdateExpression.
Di bawah ialah contoh cara anda boleh menggunakan operasi UpdateItem untuk mengubah suai jadual DynamoDB:
aws dynamodb kemas kini-item \--nama-jadual Muzik \
--kunci '{ 'Artis': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--kemas kini-ungkapan 'SET AlbumTitle = :newval' \
--expression-attribute-values '{':newval':{'S':'Tajuk Album Kemas Kini'}}' \
--kembali-nilai SEMUA BARU
Keputusan untuk operasi di atas sepatutnya kelihatan seperti ini:
Kesimpulan
Operasi DynamoDB UpdateItem mudah digunakan. Anda boleh menggunakannya untuk mengubah suai item dalam jadual sedia ada atau menambah item pada jadual sedia ada. Ambil perhatian bahawa anda perlu menentukan kunci utama dan UpdateExpression untuk operasi berjaya. Juga, berhati-hati dengan persekitaran anda. Akhir sekali, Operasi DynamoDB UpdateItem, seperti operasi yang lain, berfungsi dengan AWS SDK dan AWS CLI.