Artikel ini membahas segala sesuatu tentang operasi UpdateItem. Anda akan belajar tentang sinopsis operasi, parameter, dan cara menggunakannya.
Sinopsis dan Parameter DynamoDB
Seperti setiap operasi database lainnya, operasi UpdateItem DynamoDB menampilkan sinopsis dan parameter yang relevan. Sinopsis Python untuk operasi ini seperti yang ditunjukkan di bawah ini. Ini mungkin sedikit berbeda berdasarkan bahasa pemrograman Anda, tetapi sebagian besar parameter harus tetap sama.
PerbaruiItem (
NamaTabel = 'rangkaian' ,
Kunci = {
'rangkaian' : { 'S' : 'rangkaian' , 'N' : 'rangkaian' , 'B' : b 'byte' , 'SS' : [ 'rangkaian' , ... ] , 'NS' : [ 'rangkaian' , ... ] , 'BS' : [ b 'byte' , ... ] }
} ,
Perbarui Ekspresi = 'rangkaian' ,
Ekspresi Kondisi = 'rangkaian' ,
ExpressionAttributeValues = {
':rangkaian' : { 'S' : 'rangkaian' , 'N' : 'rangkaian' , 'B' : b 'byte' , 'SS' : [ 'rangkaian' , ... ] , 'NS' : [ 'rangkaian' , ... ] , 'BS' : [ b 'byte' , ... ] } ,
...
} ,
Nilai Pengembalian = 'TIDAK ADA' ,
ReturnConsumedCapacity = 'INDEKS' ,
ReturnItemCollectionMetrics = 'UKURAN'
)
Untuk menggunakan operasi UpdateItem di Amazon DynamoDB, Anda perlu menggunakan sintaks di atas dan memberikan beberapa parameter yang menentukan item yang ingin Anda perbarui. Anda juga perlu menentukan nilai atribut baru untuk setelan baru.
Khususnya, perintah DynamoDB UpdateItem biasa harus berisi parameter berikut:
- NamaTabel : Nama tabel DynamoDB berisi item yang ingin Anda perbarui.
- Kunci : Kunci utama (kunci partisi/kunci pengurutan) dari item yang perlu Anda perbarui. Pastikan Anda menentukan ini sebagai peta pasangan nama/nilai atribut.
- Perbarui Ekspresi : Ekspresi yang menentukan atribut yang harus Anda perbarui dan nilai baru untuk atribut tersebut.
Selain itu, Anda mungkin perlu memberikan parameter opsional di bawah ini. Parameter ini bersifat opsional dan akan bergantung pada lingkungan Anda:
- Ekspresi Kondisi : String opsional ini menentukan kondisi untuk operasi updateitem. Pembaruan hanya akan berhasil jika kondisi bernilai True.
- ExpressionAttributeNames : Ini adalah peta nama atribut placeholder yang sering digunakan dalam UpdateExpression ke nama atribut sebenarnya seperti yang digunakan dalam tabel. Parameter ini hanya diperlukan jika salah satu nama atribut di UpdateExpression menampilkan kata khusus atau/dan karakter khusus.
- ExpressionAttributeValues : Ini adalah peta nilai placeholder yang digunakan dalam UpdateExpression ke nilai sebenarnya yang ingin Anda gunakan dalam operasi pembaruan. Sangat berguna jika salah satu nilai atribut di UpdateExpression adalah ekspresi atau variabel.
- Nilai Pengembalian : Ini menentukan informasi apa yang akan Anda perlukan kembali setelah operasi berhasil. Nilai defaultnya adalah NONE, artinya Anda tidak akan menemukan informasi apa pun pada respons.
- ReturnConsumedCapacity : Ini menentukan berapa banyak kapasitas yang dikonsumsi oleh operasi pembaruan. Nilai standarnya adalah NONE, menyiratkan bahwa Anda tidak akan menemukan informasi ini dalam nilai kembalian.
- ReturnItemCollectionMetrics : Ini menentukan jumlah koleksi item yang dipengaruhi oleh operasi updateitem DynamoDb. Nilai defaultnya adalah NONE, yang berarti informasi ini tidak dikembalikan.
Saat menggunakan AWS CLI, sintaks UpdateItem DynamoDB akan terlihat seperti ini:
item pembaruan aws dynamodb \--nama-tabel TABLE_NAME \
--kunci '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--perbarui-ekspresi 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--ekspresi-atribut-nilai '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--nilai kembali DIPERBARUI_OLD
Contoh tentang Cara Menggunakan Operasi UpdateItem DynamoDB
Operasi DynamoDB UpdateItem mudah digunakan. Dan saat melakukannya, pastikan Anda menyertakan atribut primary key dan UpdateExpression.
Di bawah adalah contoh bagaimana Anda bisa menggunakan operasi UpdateItem untuk memodifikasi tabel DynamoDB:
item pembaruan aws dynamodb \--nama-tabel Musik \
--kunci '{ 'Artis': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--perbarui-ekspresi 'SET Judul Album = :newval' \
--ekspresi-atribut-nilai '{':newval':{'S':'Judul Album yang Diperbarui'}}' \
--nilai kembali SEMUANYA BARU
Hasil untuk operasi di atas akan terlihat seperti ini:
Kesimpulan
Operasi UpdateItem DynamoDB mudah digunakan. Anda dapat menggunakannya untuk memodifikasi item dalam tabel yang sudah ada atau menambahkan item ke tabel yang sudah ada. Perhatikan bahwa Anda perlu menentukan kunci utama dan UpdateExpression agar operasi berhasil. Juga, perhatikan lingkungan Anda. Terakhir, Operasi UpdateItem DynamoDB, seperti operasi lainnya, bekerja dengan AWS SDK dan AWS CLI.