Αυτό το άρθρο εξετάζει τα πάντα σχετικά με τη λειτουργία UpdateItem. Θα μάθετε για τη σύνοψη της λειτουργίας, τις παραμέτρους και τον τρόπο χρήσης της.
Σύνοψη και Παράμετροι DynamoDB
Όπως κάθε άλλη λειτουργία βάσης δεδομένων, η λειτουργία DynamoDB UpdateItem περιλαμβάνει μια σύνοψη και τις σχετικές παραμέτρους. Η σύνοψη της Python για αυτή τη λειτουργία είναι όπως φαίνεται παρακάτω. Μπορεί να διαφέρει ελαφρώς ανάλογα με τη γλώσσα προγραμματισμού σας, αλλά οι περισσότερες παράμετροι θα πρέπει να παραμείνουν ίδιες.
UpdateItem (
Όνομα πίνακα = 'σειρά' ,
Κλειδί = {
'σειρά' : { 'ΜΙΚΡΟ' : 'σειρά' , 'Ν' : 'σειρά' , 'ΣΙ' : β 'bytes' , 'SS' : [ 'σειρά' ,... ] , 'NS' : [ 'σειρά' ,... ] , 'BS' : [ σι 'bytes' ,... ] }
} ,
UpdateExpression = 'σειρά' ,
Έκφραση συνθήκης = 'σειρά' ,
ExpressionAttributeValues = {
':σειρά' : { 'ΜΙΚΡΟ' : 'σειρά' , 'Ν' : 'σειρά' , 'ΣΙ' : β 'bytes' , 'SS' : [ 'σειρά' ,... ] , 'NS' : [ 'σειρά' ,... ] , 'BS' : [ σι 'bytes' ,... ] } ,
...
} ,
ReturnValues = 'ΚΑΝΕΝΑΣ' ,
ReturnConsumed Capacity = 'ΕΥΡΕΤΗΡΙΑ' ,
ReturnItemCollectionMetrics = 'ΜΕΓΕΘΟΣ'
)
Για να χρησιμοποιήσετε τη λειτουργία UpdateItem στο Amazon DynamoDB, θα χρειαστεί να χρησιμοποιήσετε την παραπάνω σύνταξη και να παρέχετε πολλές παραμέτρους που καθορίζουν το στοιχείο που σκοπεύετε να ενημερώσετε. Θα χρειαστεί επίσης να καθορίσετε τις νέες τιμές χαρακτηριστικών για τη νέα ρύθμιση.
Συγκεκριμένα, μια τυπική εντολή DynamoDB UpdateItem θα πρέπει να περιέχει τις ακόλουθες παραμέτρους:
- Όνομα πίνακα : Το όνομα του πίνακα DynamoDB που περιέχει το στοιχείο που θέλετε να ενημερώσετε.
- Κλειδί : Το πρωτεύον κλειδί (κλειδί διαμερίσματος/κλειδί ταξινόμησης) του στοιχείου που θέλετε να ενημερώσετε. Βεβαιωθείτε ότι το έχετε ορίσει ως χάρτη των ζευγών ονόματος/τιμής χαρακτηριστικών.
- UpdateExpression : Μια έκφραση που ορίζει τα χαρακτηριστικά που πρέπει να ενημερώσετε και τις νέες τιμές για αυτά τα χαρακτηριστικά.
Επιπλέον, μπορεί να χρειαστεί να παρέχετε τις προαιρετικές παραμέτρους παρακάτω. Αυτές οι παράμετροι είναι προαιρετικές και εξαρτώνται από το περιβάλλον σας:
- Έκφραση συνθήκης : Αυτή η προαιρετική συμβολοσειρά καθορίζει μια συνθήκη για τη λειτουργία στοιχείου ενημέρωσης. Η ενημέρωση θα είναι επιτυχής μόνο εάν η συνθήκη αξιολογηθεί σε True.
- ExpressionAttributeNames : Είναι ο χάρτης των ονομάτων χαρακτηριστικών συμβόλων κράτησης θέσης που χρησιμοποιούνται συχνά στο UpdateExpression με τα πραγματικά ονόματα χαρακτηριστικών όπως χρησιμοποιούνται στον πίνακα. Αυτή η παράμετρος είναι απαραίτητη μόνο εάν οποιοδήποτε από τα ονόματα χαρακτηριστικών στο UpdateExpression διαθέτει δεσμευμένες λέξεις ή/και ειδικούς χαρακτήρες.
- ExpressionAttributeValues : Αυτός είναι ένας χάρτης τιμών κράτησης θέσης που χρησιμοποιούνται στο UpdateExpression με τις πραγματικές τιμές που σκοπεύετε να χρησιμοποιήσετε στη λειτουργία ενημέρωσης. Είναι χρήσιμο εάν κάποια από τις τιμές χαρακτηριστικών στο UpdateExpression είναι εκφράσεις ή μεταβλητές.
- ReturnValues : Καθορίζει ποιες πληροφορίες θα χρειαστείτε για να επιστραφούν μετά την επιτυχία της επέμβασης. Η προεπιλεγμένη τιμή είναι ΚΑΜΙΑ, που σημαίνει ότι δεν θα βρείτε πληροφορίες σχετικά με την απάντηση.
- ReturnConsumed Capacity : Καθορίζει πόση χωρητικότητα καταναλώθηκε από τη λειτουργία ενημέρωσης. Η προεπιλεγμένη τιμή του είναι ΚΑΜΙΑ, πράγμα που σημαίνει ότι δεν θα βρείτε αυτές τις πληροφορίες στην τιμή επιστροφής.
- ReturnItemCollectionMetrics : Καθορίζει τον αριθμό των συλλογών στοιχείων που επηρεάζονται από τη λειτουργία στοιχείου ενημέρωσης DynamoDb. Η προεπιλεγμένη τιμή είναι NONE, που σημαίνει ότι αυτές οι πληροφορίες δεν επιστρέφονται.
Όταν χρησιμοποιείτε το AWS CLI, η σύνταξη DynamoDB UpdateItem θα πρέπει να μοιάζει με αυτό:
aws dynamodb update-item \--πίνακας-όνομα TABLE_NAME \
--κλειδί '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--ενημέρωση-έκφραση 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--έκφραση-ιδιότητα-τιμές '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--επιστροφές-αξίες UPDATED_OLD
Παραδείγματα σχετικά με τον τρόπο χρήσης της λειτουργίας DynamoDB UpdateItem
Η λειτουργία DynamoDB UpdateItem είναι εύκολη στη χρήση. Και ενώ βρίσκεστε σε αυτό, βεβαιωθείτε ότι έχετε συμπεριλάβει το χαρακτηριστικό πρωτεύοντος κλειδιού και το UpdateExpression.
Ακολουθεί ένα παράδειγμα του τρόπου με τον οποίο μπορείτε να χρησιμοποιήσετε τη λειτουργία UpdateItem για να τροποποιήσετε έναν πίνακα DynamoDB:
aws dynamodb update-item \--πίνακας-όνομα ΜΟΥΣΙΚΗ \
--κλειδί '{ 'Καλλιτέχνης': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--ενημέρωση-έκφραση 'SET AlbumTitle = :newval' \
--έκφραση-ιδιότητα-τιμές '{':newval':{'S':'Ενημερωμένος τίτλος άλμπουμ'}}' \
--επιστροφές-αξίες ΟΛΟΚΑΙΝΟΥΡΙΟ
Τα αποτελέσματα για την παραπάνω λειτουργία θα πρέπει να έχουν ως εξής:
συμπέρασμα
Η λειτουργία DynamoDB UpdateItem είναι εύκολη στη χρήση. Μπορείτε να το χρησιμοποιήσετε για να τροποποιήσετε στοιχεία σε υπάρχοντες πίνακες ή να προσθέσετε στοιχεία σε έναν ήδη υπάρχοντα πίνακα. Σημειώστε ότι πρέπει να καθορίσετε το πρωτεύον κλειδί και το UpdateExpression για να είναι επιτυχής η λειτουργία. Επίσης, να προσέχετε το περιβάλλον σας. Τέλος, η λειτουργία DynamoDB UpdateItem Operation, όπως και οι υπόλοιπες λειτουργίες, λειτουργεί με AWS SDK και AWS CLI.