Овај чланак говори о свему о операцији УпдатеИтем. Научићете о синопсису операције, параметрима и како да је користите.
ДинамоДБ синопсис и параметри
Као и свака друга операција базе података, операција ДинамоДБ УпдатеИтем има синопсис и релевантне параметре. Питхон синопсис за ову операцију је приказан испод. Може се мало разликовати у зависности од вашег програмског језика, али већина параметара треба да остане иста.
УпдатеИтем (
ТаблеНаме = 'низ' ,
Кључ = {
'низ' : { 'С' : 'низ' , 'Н' : 'низ' , 'Б' : б 'бајтови' , 'СС' : [ 'низ' , ... ] , 'НС' : [ 'низ' , ... ] , 'БС' : [ б 'бајтови' , ... ] }
} ,
УпдатеЕкпрессион = 'низ' ,
ЦондитионЕкпрессион = 'низ' ,
ЕкпрессионАттрибутеВалуес = {
':низ' : { 'С' : 'низ' , 'Н' : 'низ' , 'Б' : б 'бајтови' , 'СС' : [ 'низ' , ... ] , 'НС' : [ 'низ' , ... ] , 'БС' : [ б 'бајтови' , ... ] } ,
...
} ,
РетурнВалуес = 'НИЈЕДАН' ,
РетурнЦонсумедЦапацити = 'ИНДЕКСИ' ,
РетурнИтемЦоллецтионМетрицс = 'СИЗЕ'
)
Да бисте користили операцију УпдатеИтем у Амазон ДинамоДБ, мораћете да користите горњу синтаксу и обезбедите неколико параметара који одређују ставку коју намеравате да ажурирате. Такође ћете морати да наведете нове вредности атрибута за нову поставку.
Посебно, типична ДинамоДБ УпдатеИтем команда треба да садржи следеће параметре:
- ТаблеНаме : Име ДинамоДБ табеле која садржи ставку коју желите да ажурирате.
- Кључ : Примарни кључ (партициони кључ/кључ за сортирање) ставке коју треба да ажурирате. Уверите се да сте навели ово као мапу парова име/вредност атрибута.
- УпдатеЕкпрессион : Израз који дефинише атрибуте које треба да ажурирате и нове вредности за те атрибуте.
Поред тога, можда ћете морати да наведете опционе параметре у наставку. Ови параметри су опциони и зависиће од вашег окружења:
- ЦондитионЕкпрессион : Овај опциони стринг наводи услов за операцију ставке ажурирања. Ажурирање ће бити успешно само ако се услов процени на Тачно.
- ЕкпрессионАттрибутеНамес : То је мапа имена атрибута чувара места која се често користе у УпдатеЕкпрессион-у у стварна имена атрибута која се користе у табели. Овај параметар је неопходан само ако било који од имена атрибута у УпдатеЕкпрессион садржи резервисане речи или/и специјалне знакове.
- ЕкпрессионАттрибутеВалуес : Ово је мапа вредности чувара места које се користе у УпдатеЕкпрессион-у до стварних вредности које намеравате да користите у операцији ажурирања. То је згодно ако су неке од вредности атрибута у УпдатеЕкпрессион изрази или променљиве.
- РетурнВалуес : Ово одређује које информације ће вам требати вратити након успеха операције. Подразумевана вредност је НОНЕ, што значи да нећете наћи никакве информације о одговору.
- РетурнЦонсумедЦапацити : Ово одређује колико је капацитета потрошено операцијом ажурирања. Његова подразумевана вредност је НОНЕ, што имплицира да ове информације нећете пронаћи у повратној вредности.
- РетурнИтемЦоллецтионМетрицс : Ово одређује број колекција ставки на које утиче операција ДинамоДб ажурирања ставке. Подразумевана вредност је НОНЕ, што значи да се ове информације не враћају.
Када користите АВС ЦЛИ, ДинамоДБ УпдатеИтем синтакса би требало да изгледа овако:
авс динамодб упдате-итем \--табле-наме ТАБЛЕ_НАМЕ \
--кључ '{ 'КЕИ_НАМЕ': {'С': 'КЕИ_ВАЛУЕ' } }' \
--упдате-екпрессион „СЕТ АТТРИБУТЕ_НАМЕ = :вал1, АТТРИБУТЕ_НАМЕ2 = :вал2“ \
--израз-атрибут-вредности '{ ':вал1': {'С': 'АТТРИБУТЕ_ВАЛУЕ' }, ':вал2': {'Н': 'АТТРИБУТЕ_ВАЛУЕ' } }' \
--повратне вредности УПДАТЕД_ОЛД
Примери како да користите операцију ДинамоДБ УпдатеИтем
Операција ДинамоДБ УпдатеИтем је једноставна за коришћење. И док сте на томе, уверите се да сте укључили атрибут примарног кључа и УпдатеЕкпрессион.
Испод је пример како можете да користите операцију УпдатеИтем за измену ДинамоДБ табеле:
авс динамодб упдате-итем \--табле-наме музика \
--кључ '{ 'Извођач': {'С': 'Саути Сол'}, 'СонгТитле': {'С': 'Феел Ми Лове'}}' \
--упдате-екпрессион „СЕТ АлбумТитле = :неввал“ \
--израз-атрибут-вредности '{':неввал':{'С':'Ажурирани наслов албума'}}' \
--повратне вредности СВЕ НОВО
Резултати за горњу операцију би требали изгледати овако:
Закључак
Операција ДинамоДБ УпдатеИтем је једноставна за коришћење. Можете га користити за измену ставки унутар постојећих табела или додавање ставки у већ постојећу табелу. Имајте на уму да морате да наведете примарни кључ и УпдатеЕкпрессион да би операција била успешна. Такође, водите рачуна о свом окружењу. Коначно, операција ДинамоДБ УпдатеИтем, као и остале операције, функционише са АВС СДК-овима и АВС ЦЛИ.