Cet article explique tout sur l'opération UpdateItem. Vous découvrirez le synopsis de l'opération, ses paramètres et son utilisation.
Synopsis et paramètres de DynamoDB
Comme toutes les autres opérations de base de données, l'opération DynamoDB UpdateItem comporte un synopsis et les paramètres pertinents. Le synopsis Python pour cette opération est comme indiqué ci-dessous. Cela peut varier légèrement en fonction de votre langage de programmation, mais la plupart des paramètres doivent rester les mêmes.
Mettre à jour l'élément (
Nom de la table = 'chaîne' ,
Clé = {
'chaîne' : { 'S' : 'chaîne' , 'N' : 'chaîne' , 'B' : b 'octets' , 'SS' : [ 'chaîne' , ... ] , 'NS' : [ 'chaîne' , ... ] , 'BS' : [ b 'octets' , ... ] }
} ,
UpdateExpression = 'chaîne' ,
ConditionExpression = 'chaîne' ,
ExpressionAttributeValuesExpressionAttributeValues = {
':chaîne' : { 'S' : 'chaîne' , 'N' : 'chaîne' , 'B' : b 'octets' , 'SS' : [ 'chaîne' , ... ] , 'NS' : [ 'chaîne' , ... ] , 'BS' : [ b 'octets' , ... ] } ,
...
} ,
Valeurs de retour = 'RIEN' ,
ReturnConsumedCapacityReturnConsumedCapacity = 'INDICES' ,
ReturnItemCollectionMetricsReturnItemCollectionMetrics = 'TAILLE'
)
Pour utiliser l'opération UpdateItem dans Amazon DynamoDB, vous devrez utiliser la syntaxe ci-dessus et fournir plusieurs paramètres qui spécifient l'élément que vous avez l'intention de mettre à jour. Vous devrez également spécifier les nouvelles valeurs d'attribut pour le nouveau paramètre.
Notamment, une commande DynamoDB UpdateItem typique doit contenir les paramètres suivants :
- Nom de la table : nom de la table DynamoDB contenant l'élément que vous souhaitez mettre à jour.
- Clé : La clé primaire (clé de partition/clé de tri) de l'élément que vous devez mettre à jour. Assurez-vous de le spécifier en tant que mappage de paires nom/valeur d'attribut.
- UpdateExpression : une expression qui définit les attributs que vous devez mettre à jour et les nouvelles valeurs de ces attributs.
En outre, vous devrez peut-être fournir les paramètres facultatifs ci-dessous. Ces paramètres sont facultatifs et dépendront de votre environnement :
- ConditionExpression : Cette chaîne facultative spécifie une condition pour l'opération updateitem. La mise à jour ne réussira que si la condition prend la valeur True.
- ExpressionAttributeNamesExpressionAttributeNames : Il s'agit d'une carte des noms d'attributs d'espace réservé souvent utilisés dans UpdateExpression avec les noms d'attributs réels tels qu'ils sont utilisés dans le tableau. Ce paramètre n'est nécessaire que si l'un des noms d'attribut dans UpdateExpression contient des mots réservés ou/et des caractères spéciaux.
- ExpressionAttributeValuesExpressionAttributeValues : Il s'agit d'une carte des valeurs d'espace réservé utilisées dans UpdateExpression avec les valeurs réelles que vous avez l'intention d'utiliser dans l'opération de mise à jour. C'est pratique si l'une des valeurs d'attribut de UpdateExpression est une expression ou une variable.
- Valeurs de retour : Ceci spécifie les informations dont vous aurez besoin en cas de succès de l'opération. La valeur par défaut est NONE, ce qui signifie que vous ne trouverez aucune information sur la réponse.
- ReturnConsumedCapacityReturnConsumedCapacity : Ceci spécifie la quantité de capacité consommée par l'opération de mise à jour. Sa valeur par défaut est NONE, ce qui implique que vous ne trouverez pas cette information dans la valeur de retour.
- ReturnItemCollectionMetricsReturnItemCollectionMetrics : Ceci spécifie le nombre de collections d'éléments affectées par l'opération de mise à jour de l'élément DynamoDb. La valeur par défaut est NONE, ce qui signifie que cette information n'est pas renvoyée.
Lors de l'utilisation d'AWS CLI, la syntaxe DynamoDB UpdateItem doit ressembler à ceci :
aws dynamodb élément de mise à jour \--nom de la table NOM DE LA TABLE \
--clé '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--expression-de-mise-à-jour 'SET ATTRIBUT_NAME = :val1, ATTRIBUT_NAME2 = :val2' \
--expression-attribute-values '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--return-values UPDATED_OLD
Exemples d'utilisation de l'opération DynamoDB UpdateItem
L'opération DynamoDB UpdateItem est facile à utiliser. Et pendant que vous y êtes, assurez-vous d'inclure l'attribut de clé primaire et UpdateExpression.
Vous trouverez ci-dessous un exemple d'utilisation de l'opération UpdateItem pour modifier une table DynamoDB :
aws dynamodb élément de mise à jour \--nom de la table Musique \
--clé '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--expression-de-mise-à-jour 'SET AlbumTitle = :newval' \
--expression-attribute-values '{':newval':{'S':'Titre de l'album mis à jour'}}' \
--return-values TOUS LES NOUVEAUX
Les résultats de l'opération ci-dessus devraient ressembler à ceci :
Conclusion
DynamoDB UpdateItem Operation est facile à utiliser. Vous pouvez l'utiliser pour modifier des éléments dans des tableaux existants ou ajouter des éléments à un tableau déjà existant. Notez que vous devez spécifier la clé primaire et UpdateExpression pour que l'opération réussisse. Aussi, faites attention à votre environnement. Enfin, l'opération DynamoDB UpdateItem, comme le reste des opérations, fonctionne avec les kits SDK AWS et l'AWS CLI.