Bu makalede, UpdateItem işlemiyle ilgili her şey anlatılmaktadır. İşlemin özetini, parametrelerini ve nasıl kullanılacağını öğreneceksiniz.
DynamoDB Özeti ve Parametreleri
Diğer tüm veritabanı işlemlerinde olduğu gibi, DynamoDB UpdateItem işleminde de bir özet ve ilgili parametreler bulunur. Bu işlem için Python özeti aşağıda gösterildiği gibidir. Programlama dilinize bağlı olarak biraz değişebilir ancak çoğu parametre aynı kalmalıdır.
Öğeyi Güncelle (
Tablo ismi = 'sicim' ,
Anahtar = {
'sicim' : { 'S' : 'sicim' , 'N' : 'sicim' , 'B' : b 'bayt' , 'SS' : [ 'sicim' , ... ] , 'NS' : [ 'sicim' , ... ] , 'BS' : [ b 'bayt' , ... ] }
} ,
İfadeyi Güncelle = 'sicim' ,
Koşul İfadesi = 'sicim' ,
ExpressionAttributeValues = {
':sicim' : { 'S' : 'sicim' , 'N' : 'sicim' , 'B' : b 'bayt' , 'SS' : [ 'sicim' , ... ] , 'NS' : [ 'sicim' , ... ] , 'BS' : [ b 'bayt' , ... ] } ,
...
} ,
Dönüş Değerleri = 'YOK' ,
İade Tüketilen Kapasite = 'ENDEKSLER' ,
İadeItemCollectionMetrics = 'BOY'
)
Amazon DynamoDB'de UpdateItem işlemini kullanmak için yukarıdaki sözdizimini kullanmanız ve güncellemeyi düşündüğünüz öğeyi belirten birkaç parametre sağlamanız gerekir. Yeni ayar için yeni öznitelik değerlerini de belirtmeniz gerekecektir.
Özellikle, tipik bir DynamoDB UpdateItem komutunun aşağıdaki parametreleri içermesi gerekir:
- Tablo ismi : Güncellemek istediğiniz öğeyi içeren DynamoDB tablosunun adı.
- Anahtar : Güncellemeniz gereken öğenin birincil anahtarı (bölüm anahtarı/sıralama anahtarı). Bunu özellik adı/değer çiftlerinin bir haritası olarak belirttiğinizden emin olun.
- İfadeyi Güncelle : Güncellemeniz gereken nitelikleri ve bu nitelikler için yeni değerleri tanımlayan bir ifade.
Ek olarak, aşağıdaki isteğe bağlı parametreleri sağlamanız gerekebilir. Bu parametreler isteğe bağlıdır ve ortamınıza bağlıdır:
- Koşul İfadesi : Bu isteğe bağlı dize, güncelleme öğesi işlemi için bir koşul belirtir. Güncelleme yalnızca koşul True olarak değerlendirilirse başarılı olur.
- İfadeÖznitelikAdları : UpdateExpression'da sıklıkla kullanılan yer tutucu öznitelik adlarının, tabloda kullanılan gerçek öznitelik adlarıyla eşleştirilmesidir. Bu parametre yalnızca, UpdateExpression'daki öznitelik adlarından herhangi biri ayrılmış sözcükler ve/veya özel karakterler içeriyorsa gereklidir.
- ExpressionAttributeValues : Bu, UpdateExpression'da kullanılan yer tutucu değerlerin, güncelleme işleminde kullanmayı amaçladığınız gerçek değerlerle bir haritasıdır. UpdateExpression'daki öznitelik değerlerinden herhangi birinin ifade veya değişken olması kullanışlıdır.
- Dönüş Değerleri : Bu, işlemin başarılı olması durumunda hangi bilgilere ihtiyaç duyacağınızı belirtir. Varsayılan değer NONE'dur, yani yanıt hakkında herhangi bir bilgi bulamazsınız.
- İade Tüketilen Kapasite : Bu, güncelleme işlemi tarafından ne kadar kapasite tüketildiğini belirtir. Varsayılan değeri NONE'dur ve bu bilgiyi dönüş değerinde bulamayacağınızı gösterir.
- İadeItemCollectionMetrics : Bu, DynamoDb öğe güncelleme işleminden etkilenen öğe koleksiyonlarının sayısını belirtir. Varsayılan değer NONE'dur, yani bu bilgi döndürülmez.
AWS CLI kullanırken, DynamoDB UpdateItem sözdizimi şöyle görünmelidir:
aws dynamodb güncelleme öğesi \--Tablo ismi TABLO İSMİ \
--anahtar '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--güncelleme-ifadesi 'ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2 AYARLA' \
--ifade-öznitelik-değerleri '{ ':val1': {'S': 'ÖZELLİK_DEĞERİ' }, ':val2': {'N': 'ÖZELLİK_DEĞERİ' } }' \
--dönüş değerleri GÜNCELLENMİŞ_OLD
DynamoDB UpdateItem İşleminin Nasıl Kullanılacağına İlişkin Örnekler
DynamoDB UpdateItem işleminin kullanımı kolaydır. Ve bunu yaparken, birincil anahtar niteliğini ve UpdateExpression'ı eklediğinizden emin olun.
Aşağıda, bir DynamoDB tablosunu değiştirmek için UpdateItem işlemini nasıl kullanabileceğinize dair bir örnek verilmiştir:
aws dynamodb güncelleme öğesi \--Tablo ismi müzik \
--anahtar '{ 'Sanatçı': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Aşkımı Hisset'}}' \
--güncelleme-ifadesi 'Albüm Başlığını AYARLA = :newval' \
--ifade-öznitelik-değerleri '{':newval':{'S':'Güncellenmiş Albüm Başlığı'}}' \
--dönüş değerleri HEPSİ YENİ
Yukarıdaki işlemin sonuçları şöyle görünmelidir:
Çözüm
DynamoDB UpdateItem İşleminin kullanımı kolaydır. Mevcut tablolardaki öğeleri değiştirmek veya mevcut bir tabloya öğe eklemek için kullanabilirsiniz. İşlemin başarılı olması için birincil anahtarı ve UpdateExpression'ı belirtmeniz gerektiğini unutmayın. Ayrıca, çevrenize dikkat edin. Son olarak, diğer işlemler gibi DynamoDB UpdateItem İşlemi de AWS SDK'ları ve AWS CLI ile çalışır.