یہ مضمون UpdateItem آپریشن کے بارے میں ہر چیز پر بحث کرتا ہے۔ آپ آپریشن کے خلاصے، پیرامیٹرز، اور اسے استعمال کرنے کے طریقے کے بارے میں جانیں گے۔
DynamoDB خلاصہ اور پیرامیٹرز
ہر دوسرے ڈیٹا بیس آپریشن کی طرح، DynamoDB UpdateItem آپریشن میں ایک خلاصہ اور متعلقہ پیرامیٹرز شامل ہیں۔ اس آپریشن کے لیے ازگر کا خلاصہ ذیل میں دکھایا گیا ہے۔ یہ آپ کی پروگرامنگ زبان کی بنیاد پر تھوڑا سا مختلف ہو سکتا ہے لیکن زیادہ تر پیرامیٹرز ایک جیسے رہنے چاہئیں۔
اپ ڈیٹ آئٹم (
ٹیبل کا نام = 'سٹرنگ' ،
چابی = {
'سٹرنگ' : { 'S' : 'سٹرنگ' ، 'این' : 'سٹرنگ' ، 'B' :ب 'بائٹس' ، 'SS' : [ 'سٹرنگ' ،... ] ، 'NS' : [ 'سٹرنگ' ،... ] ، 'BS' : [ ب 'بائٹس' ،... ] }
} ،
UpdateExpression = 'سٹرنگ' ،
حالت کا اظہار = 'سٹرنگ' ،
ExpressionAttributeValues = {
': تار' : { 'S' : 'سٹرنگ' ، 'این' : 'سٹرنگ' ، 'B' :ب 'بائٹس' ، 'SS' : [ 'سٹرنگ' ،... ] ، 'NS' : [ 'سٹرنگ' ،... ] ، 'BS' : [ ب 'بائٹس' ،... ] } ،
...
} ،
ریٹرن ویلیوز = 'کوئی نہیں' ،
ReturnConsumed Capacity = 'انڈیکس' ،
ریٹرن آئٹم کلیکشن میٹرکس = 'سائز'
)
Amazon DynamoDB میں UpdateItem آپریشن کو استعمال کرنے کے لیے، آپ کو اوپر کا نحو استعمال کرنا ہوگا اور کئی پیرامیٹرز فراہم کرنے ہوں گے جو اس آئٹم کی وضاحت کرتے ہیں جسے آپ اپ ڈیٹ کرنا چاہتے ہیں۔ آپ کو نئی ترتیب کے لیے نئی انتساب کی قدریں بھی بتانے کی ضرورت ہوگی۔
خاص طور پر، ایک عام DynamoDB UpdateItem کمانڈ میں درج ذیل پیرامیٹرز ہونے چاہئیں:
- ٹیبل کا نام : DynamoDB ٹیبل کا نام جس میں وہ آئٹم ہے جسے آپ اپ ڈیٹ کرنا چاہتے ہیں۔
- چابی : اس آئٹم کی بنیادی کلید (تقسیم کلید/سانٹ کی کلید) جس کی آپ کو ضرورت ہے۔ اس بات کو یقینی بنائیں کہ آپ نے اسے انتساب کے نام/قدر کے جوڑوں کے نقشے کے طور پر بیان کیا ہے۔
- UpdateExpression : ایک اظہار جو ان صفات کی وضاحت کرتا ہے جنہیں آپ کو اپ ڈیٹ کرنا چاہیے اور ان صفات کے لیے نئی اقدار۔
مزید برآں، آپ کو ذیل میں اختیاری پیرامیٹرز فراہم کرنے کی ضرورت پڑ سکتی ہے۔ یہ پیرامیٹرز اختیاری ہیں اور آپ کے ماحول پر منحصر ہوں گے:
- حالت کا اظہار : یہ اختیاری سٹرنگ اپڈیٹم آپریشن کے لیے ایک شرط بتاتی ہے۔ اپ ڈیٹ صرف اس صورت میں کامیاب ہو گا جب شرط کی درستی کی جائے گی۔
- ExpressionAttributeNames : یہ پلیس ہولڈر انتساب کے ناموں کا نقشہ ہے جو اکثر UpdateExpression میں اصل انتساب کے ناموں کے لیے استعمال ہوتا ہے جیسا کہ جدول میں استعمال ہوتا ہے۔ یہ پیرامیٹر صرف اس صورت میں ضروری ہے جب UpdateExpression میں کسی بھی صفت کے نام میں مخصوص الفاظ یا/اور خصوصی حروف شامل ہوں۔
- ExpressionAttributeValues : یہ پلیس ہولڈر اقدار کا نقشہ ہے جو UpdateExpression میں ان اصل اقدار کے لیے استعمال ہوتا ہے جنہیں آپ اپ ڈیٹ آپریشن میں استعمال کرنا چاہتے ہیں۔ یہ کام آتا ہے اگر UpdateExpression میں کوئی بھی انتساب قدر اظہار یا متغیر ہو۔
- ریٹرن ویلیوز : یہ بتاتا ہے کہ آپریشن کی کامیابی پر آپ کو کونسی معلومات کی ضرورت ہوگی۔ پہلے سے طے شدہ قدر NONE ہے، یعنی آپ کو جواب پر کوئی معلومات نہیں ملے گی۔
- ReturnConsumed Capacity : یہ بتاتا ہے کہ اپ ڈیٹ آپریشن کے ذریعے کتنی صلاحیت استعمال کی گئی۔ اس کی ڈیفالٹ ویلیو NONE ہے، اس کا مطلب ہے کہ آپ کو یہ معلومات واپسی کی قیمت میں نہیں ملے گی۔
- ریٹرن آئٹم کلیکشن میٹرکس : یہ DynamoDb اپ ڈیٹ آئٹم آپریشن سے متاثر آئٹم کے مجموعوں کی تعداد بتاتا ہے۔ پہلے سے طے شدہ قدر NONE ہے، جس کا مطلب ہے کہ یہ معلومات واپس نہیں کی گئی ہیں۔
AWS CLI استعمال کرتے وقت، DynamoDB UpdateItem کا نحو اس طرح نظر آنا چاہیے:
aws dynamodb اپ ڈیٹ آئٹم \--ٹیبل کا نام TABLE_NAME \
--چابی '{ 'KEY_NAME': {'S': 'KEY_VALUE' } } \
--اپ ڈیٹ-اظہار 'ATTRIBUTE_NAME = :val1، ATTRIBUTE_NAME2 = :val2 سیٹ کریں' \
--expression-انتساب-اقدار '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } } \
--واپسی قدریں UPDATED_OLD
DynamoDB UpdateItem آپریشن کو استعمال کرنے کے طریقے سے متعلق مثالیں۔
DynamoDB UpdateItem آپریشن استعمال کرنا آسان ہے۔ اور اس پر رہتے ہوئے، یقینی بنائیں کہ آپ نے بنیادی کلیدی وصف اور UpdateExpression شامل کیا ہے۔
ذیل میں ایک مثال ہے کہ آپ DynamoDB ٹیبل میں ترمیم کرنے کے لیے UpdateItem آپریشن کا استعمال کیسے کر سکتے ہیں:
aws dynamodb اپ ڈیٹ آئٹم \--ٹیبل کا نام موسیقی \
--چابی '{ 'آرٹسٹ': {'S': 'سوتی سول'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--اپ ڈیٹ-اظہار 'SET AlbumTitle = :newval' \
--expression-انتساب-اقدار '{':newval':{'S':'اپ ڈیٹ کردہ البم ٹائٹل'}}' \
--واپسی قدریں تمام نئے
مندرجہ بالا آپریشن کے نتائج اس طرح نظر آنا چاہئے:
نتیجہ
DynamoDB UpdateItem آپریشن استعمال کرنا آسان ہے۔ آپ اسے موجودہ ٹیبلز میں آئٹمز میں ترمیم کرنے یا پہلے سے موجود ٹیبل میں آئٹمز شامل کرنے کے لیے استعمال کر سکتے ہیں۔ نوٹ کریں کہ آپریشن کے کامیاب ہونے کے لیے آپ کو بنیادی کلید اور UpdateExpression کی وضاحت کرنے کی ضرورت ہے۔ اس کے علاوہ اپنے ماحول کا خیال رکھیں۔ آخر میں، DynamoDB UpdateItem آپریشن، باقی آپریشنز کی طرح، AWS SDKs اور AWS CLI کے ساتھ کام کرتا ہے۔