تتناول هذه المقالة كل شيء عن عملية UpdateItem. سوف تتعرف على ملخص العملية والمعلمات وكيفية استخدامها.
ملخص ومعلمات DynamoDB
مثل كل عملية قاعدة بيانات أخرى ، تتميز عملية DynamoDB UpdateItem بموجز والمعلمات ذات الصلة. ملخص بايثون لهذه العملية كما هو موضح أدناه. قد يختلف قليلاً بناءً على لغة البرمجة الخاصة بك ولكن يجب أن تظل معظم المعلمات كما هي.
تحديث (
اسم الطاولة = 'سلسلة' و
مفتاح = {
'سلسلة' : { 'س' : 'سلسلة' و 'ن' : 'سلسلة' و 'ب' : ب 'بايت' و 'SS' : [ 'سلسلة' ، ... ] و 'NS' : [ 'سلسلة' ، ... ] و 'BS' : [ ب 'بايت' ، ... ] }
} و
تحديث التعبير = 'سلسلة' و
التعبير عن الشرط = 'سلسلة' و
ExpressionAttributeValues = {
':سلسلة' : { 'س' : 'سلسلة' و 'ن' : 'سلسلة' و 'ب' : ب 'بايت' و 'SS' : [ 'سلسلة' ، ... ] و 'NS' : [ 'سلسلة' ، ... ] و 'BS' : [ ب 'بايت' ، ... ] } و
...
} و
إرجاع القيم = 'لا أحد' و
القدرة المستهلكة = مؤشرات و
ReturnItemCollectionMetrics = 'بحجم'
)
لاستخدام عملية UpdateItem في Amazon DynamoDB ، ستحتاج إلى استخدام الصيغة أعلاه وتوفير العديد من المعلمات التي تحدد العنصر الذي تنوي تحديثه. ستحتاج أيضًا إلى تحديد قيم السمات الجديدة للإعداد الجديد.
والجدير بالذكر أن أمر DynamoDB UpdateItem النموذجي يجب أن يحتوي على المعلمات التالية:
- اسم الطاولة : اسم جدول DynamoDB الذي يحتوي على العنصر الذي تريد تحديثه.
- مفتاح : المفتاح الأساسي (مفتاح القسم / مفتاح الفرز) للعنصر الذي تريد تحديثه. تأكد من تحديد هذا كخريطة لأزواج اسم / قيمة السمة.
- تحديث التعبير : تعبير يعرّف السمات التي يجب تحديثها والقيم الجديدة لتلك السمات.
بالإضافة إلى ذلك ، قد تحتاج إلى توفير المعلمات الاختيارية أدناه. هذه المعلمات اختيارية وستعتمد على بيئتك:
- التعبير عن الشرط : تحدد هذه السلسلة الاختيارية شرطًا لعملية updateitem. لن ينجح التحديث إلا إذا تم تقييم الشرط إلى True.
- ExpressionAttributeNames : عبارة عن خريطة لأسماء سمات العنصر النائب غالبًا ما تُستخدم في UpdateExpression إلى أسماء السمات الفعلية كما هو مستخدم في الجدول. هذه المعلمة ضرورية فقط إذا كان أي من أسماء السمات في ميزات UpdateExpression كلمات محجوزة و / أو أحرف خاصة.
- ExpressionAttributeValues : هذه خريطة لقيم العناصر النائبة المستخدمة في UpdateExpression للقيم الفعلية التي تنوي استخدامها في عملية التحديث. يكون مفيدًا إذا كانت أي من قيم السمات في UpdateExpression عبارة عن تعبيرات أو متغيرات.
- إرجاع القيم : هذا يحدد ما هي المعلومات التي ستحتاجها والتي يتم إرجاعها عند نجاح العملية. القيمة الافتراضية هي NONE ، مما يعني أنك لن تجد أي معلومات عن الاستجابة.
- القدرة المستهلكة : هذا يحدد مقدار السعة التي استهلكتها عملية التحديث. قيمته الافتراضية هي NONE ، مما يعني أنك لن تجد هذه المعلومات في القيمة المرجعة.
- ReturnItemCollectionMetrics : يحدد هذا عدد مجموعات العناصر المتأثرة بعملية تحديث DynamoDb. القيمة الافتراضية هي NONE ، مما يعني أنه لم يتم إرجاع هذه المعلومات.
عند استخدام AWS CLI ، يجب أن يبدو بناء جملة DynamoDB UpdateItem كما يلي:
أوس دينامودب تحديث البند \--اسم الطاولة اسم الطاولة \
--مفتاح '{' KEY_NAME ': {' S ':' KEY_VALUE '}} \
- تحديث التعبير 'SET ATTRIBUTE_NAME =: val1 ، ATTRIBUTE_NAME2 =: val2' \
- التعبير-السمة-القيم '{': val1': {'S': 'ATTRIBUTE_VALUE'}، ': val2': {'N': 'ATTRIBUTE_VALUE'}}' \
- قيم العودة محدث_ولد
أمثلة على كيفية استخدام عملية DynamoDB UpdateItem
عملية DynamoDB UpdateItem سهلة الاستخدام. وأثناء ذلك ، تأكد من تضمين سمة المفتاح الأساسي و UpdateExpression.
فيما يلي مثال على كيفية استخدام عملية UpdateItem لتعديل جدول DynamoDB:
أوس دينامودب تحديث البند \--اسم الطاولة موسيقى \
--مفتاح '{'الفنان': {'S': 'Sauti Sol'}، 'SongTitle': {'S': 'Feel My Love'}}' \
- تحديث التعبير 'SET AlbumTitle =: newval' \
- التعبير-السمة-القيم '{': newval': {'S': 'عنوان الألبوم المحدث'}}' \
- قيم العودة ALL_NEW
يجب أن تبدو نتائج العملية المذكورة أعلاه كما يلي:
استنتاج
DynamoDB UpdateItem عملية سهلة الاستخدام. يمكنك استخدامه لتعديل العناصر داخل الجداول الموجودة أو إضافة عناصر إلى جدول موجود بالفعل. لاحظ أنك تحتاج إلى تحديد المفتاح الأساسي و UpdateExpression لكي تنجح العملية. أيضًا ، كن على دراية ببيئتك. أخيرًا ، تعمل DynamoDB UpdateItem ، مثل باقي العمليات ، مع AWS SDKs و AWS CLI.