यह आलेख UpdateItem कार्रवाई के बारे में सब कुछ पर चर्चा करता है। आप ऑपरेशन के सारांश, मापदंडों और इसका उपयोग करने के तरीके के बारे में जानेंगे।
DynamoDB सारांश और पैरामीटर्स
हर दूसरे डेटाबेस ऑपरेशन की तरह, DynamoDB UpdateItem ऑपरेशन में सिनॉप्सिस और संबंधित पैरामीटर होते हैं। इस ऑपरेशन के लिए पायथन सारांश नीचे दिखाया गया है। यह आपकी प्रोग्रामिंग भाषा के आधार पर थोड़ा भिन्न हो सकता है लेकिन अधिकांश पैरामीटर समान रहने चाहिए।
अद्यतन वस्तु (
तालिका नाम = 'डोरी' ,
चाभी = {
'डोरी' : { 'एस' : 'डोरी' , 'एन' : 'डोरी' , 'बी' : बी 'बाइट्स' , 'एसएस' : [ 'डोरी' , ... ] , 'एनएस' : [ 'डोरी' , ... ] , 'बीएस' : [ बी 'बाइट्स' , ... ] }
} ,
अपडेटएक्सप्रेशन = 'डोरी' ,
कंडीशन एक्सप्रेशन = 'डोरी' ,
अभिव्यक्ति विशेषता मान = {
':डोरी' : { 'एस' : 'डोरी' , 'एन' : 'डोरी' , 'बी' : बी 'बाइट्स' , 'एसएस' : [ 'डोरी' , ... ] , 'एनएस' : [ 'डोरी' , ... ] , 'बीएस' : [ बी 'बाइट्स' , ... ] } ,
...
} ,
वापसीमान = 'कोई भी नहीं' ,
रिटर्न कंज्यूम्ड कैपेसिटी = 'सूचकांक' ,
रिटर्नआइटमकलेक्शन मेट्रिक्स = 'आकार'
)
Amazon DynamoDB में UpdateItem ऑपरेशन का उपयोग करने के लिए, आपको ऊपर दिए गए सिंटैक्स का उपयोग करना होगा और कई पैरामीटर प्रदान करने होंगे जो उस आइटम को निर्दिष्ट करते हैं जिसे आप अपडेट करना चाहते हैं। आपको नई सेटिंग के लिए नए विशेषता मान भी निर्दिष्ट करने होंगे।
विशेष रूप से, एक विशिष्ट DynamoDB UpdateItem कमांड में निम्नलिखित पैरामीटर होने चाहिए:
- तालिका नाम : DynamoDB तालिका का नाम जिसमें वह आइटम है जिसे आप अपडेट करना चाहते हैं।
- चाभी : उस आइटम की प्राथमिक कुंजी (विभाजन कुंजी/सॉर्ट कुंजी) जिसे आपको अपडेट करने की आवश्यकता है। सुनिश्चित करें कि आप इसे विशेषता नाम/मान जोड़े के मानचित्र के रूप में निर्दिष्ट करते हैं।
- अपडेटएक्सप्रेशन : एक व्यंजक जो उन विशेषताओं को परिभाषित करता है जिन्हें आपको अद्यतन करना चाहिए और उन विशेषताओं के लिए नए मान।
इसके अतिरिक्त, आपको नीचे वैकल्पिक पैरामीटर प्रदान करने की आवश्यकता हो सकती है। ये पैरामीटर वैकल्पिक हैं और आपके परिवेश पर निर्भर करेंगे:
- कंडीशन एक्सप्रेशन : यह वैकल्पिक स्ट्रिंग अपडेटइटम ऑपरेशन के लिए एक शर्त निर्दिष्ट करती है। स्थिति का मूल्यांकन सही होने पर ही अद्यतन सफल होगा।
- अभिव्यक्ति विशेषता नाम : यह प्लेसहोल्डर एट्रिब्यूट नामों का मानचित्र है जो अक्सर अपडेटएक्सप्रेशन में उपयोग किए जाने वाले वास्तविक एट्रिब्यूट नामों में तालिका में उपयोग किया जाता है। यह पैरामीटर केवल तभी आवश्यक है जब UpdateExpression में किसी भी विशेषता के नाम में आरक्षित शब्द या/और विशेष वर्ण हों।
- अभिव्यक्ति विशेषता मान : यह अपडेट एक्सप्रेशन में उपयोग किए गए प्लेसहोल्डर मानों का एक नक्शा है जो आप अपडेट ऑपरेशन में उपयोग करने का इरादा रखते हैं। यह काम में आता है अगर UpdateExpression में कोई भी विशेषता मान अभिव्यक्ति या चर है।
- वापसीमान : यह निर्दिष्ट करता है कि ऑपरेशन की सफलता पर आपको किस जानकारी की आवश्यकता होगी। डिफ़ॉल्ट मान कोई नहीं है, जिसका अर्थ है कि आपको प्रतिक्रिया पर कोई जानकारी नहीं मिलेगी।
- रिटर्न कंज्यूम्ड कैपेसिटी : यह निर्दिष्ट करता है कि अपडेट ऑपरेशन द्वारा कितनी क्षमता का उपभोग किया गया। इसका डिफ़ॉल्ट मान NONE है, जिसका अर्थ है कि आपको यह जानकारी रिटर्न वैल्यू में नहीं मिलेगी।
- रिटर्नआइटमकलेक्शन मेट्रिक्स : यह DynamoDb updateitem ऑपरेशन से प्रभावित आइटम संग्रह की संख्या को निर्दिष्ट करता है। डिफ़ॉल्ट मान कोई नहीं है, जिसका अर्थ है कि यह जानकारी वापस नहीं आती है।
AWS CLI का उपयोग करते समय, DynamoDB UpdateItem सिंटैक्स इस तरह दिखना चाहिए:
एडब्ल्यूएस डायनेमोडब अपडेट-आइटम \--तालिका नाम तालिका नाम \
--चाभी '{'KEY_NAME': {'S': 'KEY_VALUE'}}' \
--अद्यतन-अभिव्यक्ति 'सेट ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--अभिव्यक्ति-विशेषता-मान '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' }}' \
--वापसी-मान UPDATED_OLD
DynamoDB UpdateItem ऑपरेशन का उपयोग करने के उदाहरण
DynamoDB UpdateItem ऑपरेशन का उपयोग करना आसान है। और इसके दौरान, सुनिश्चित करें कि आप प्राथमिक कुंजी विशेषता और UpdateExpression शामिल करें।
नीचे एक उदाहरण दिया गया है कि आप DynamoDB तालिका को संशोधित करने के लिए UpdateItem ऑपरेशन का उपयोग कैसे कर सकते हैं:
एडब्ल्यूएस डायनेमोडब अपडेट-आइटम \--तालिका नाम संगीत \
--चाभी '{'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--अद्यतन-अभिव्यक्ति 'एल्बमटाइटल सेट करें = :newval' \
--अभिव्यक्ति-विशेषता-मान '{':newval':{'S':'अपडेट किया गया एल्बम शीर्षक'}}' \
--वापसी-मान बिलकुल नया
उपरोक्त ऑपरेशन के परिणाम इस तरह दिखना चाहिए:
निष्कर्ष
DynamoDB UpdateItem ऑपरेशन का उपयोग करना आसान है। आप इसका उपयोग मौजूदा तालिकाओं में आइटम संशोधित करने या पहले से मौजूद तालिका में आइटम जोड़ने के लिए कर सकते हैं। ध्यान दें कि ऑपरेशन के सफल होने के लिए आपको प्राथमिक कुंजी और UpdateExpression निर्दिष्ट करने की आवश्यकता है। इसके अलावा, अपने पर्यावरण के प्रति सचेत रहें। अंत में, DynamoDB UpdateItem Operation, बाकी ऑपरेशनों की तरह, AWS SDKs और AWS CLI के साथ काम करता है।