Ez a cikk mindent tárgyal az UpdateItem műveletről. Megismerheti a művelet szinopszisát, paramétereit és használatát.
A DynamoDB összefoglalója és paraméterei
Mint minden más adatbázis-művelet, a DynamoDB UpdateItem művelet is tartalmaz egy áttekintést és a vonatkozó paramétereket. A művelet Python-összefoglalója az alábbiak szerint látható. Ez kissé eltérhet a programozási nyelvtől függően, de a legtöbb paraméternek változatlannak kell maradnia.
Elem frissítése (
Táblanév = 'húr' ,
Kulcs = {
'húr' : { 'S' : 'húr' , 'N' : 'húr' , 'B' : b 'bájt' , 'SS' : [ 'húr' ,... ] , 'NS' : [ 'húr' ,... ] , 'BS' : [ b 'bájt' ,... ] }
} ,
UpdateExpression = 'húr' ,
FeltételKifejezés = 'húr' ,
ExpressionAttributeValues = {
':húr' : { 'S' : 'húr' , 'N' : 'húr' , 'B' : b 'bájt' , 'SS' : [ 'húr' ,... ] , 'NS' : [ 'húr' ,... ] , 'BS' : [ b 'bájt' ,... ] } ,
...
} ,
ReturnValues = 'EGYIK SEM' ,
ReturnConsumedCapacity = 'INDEXES' ,
ReturnItemCollectionMetrics = 'MÉRET'
)
Az UpdateItem művelet használatához az Amazon DynamoDB-ben a fenti szintaxist kell használnia, és több olyan paramétert kell megadnia, amelyek meghatározzák a frissíteni kívánt elemet. Az új beállításhoz meg kell adnia az új attribútumértékeket is.
Nevezetesen, egy tipikus DynamoDB UpdateItem parancsnak a következő paramétereket kell tartalmaznia:
- Táblanév : A frissíteni kívánt elemet tartalmazó DynamoDB tábla neve.
- Kulcs : A frissíteni kívánt elem elsődleges kulcsa (partíciókulcs/rendezési kulcs). Győződjön meg arról, hogy ezt az attribútumnév/érték párok térképeként adja meg.
- UpdateExpression : Olyan kifejezés, amely meghatározza a frissítendő attribútumokat és az attribútumok új értékeit.
Ezenkívül előfordulhat, hogy az alábbiakban meg kell adnia az opcionális paramétereket. Ezek a paraméterek nem kötelezőek, és a környezettől függenek:
- FeltételKifejezés : Ez az opcionális karakterlánc az updateitem művelet feltételét adja meg. A frissítés csak akkor lesz sikeres, ha a feltétel kiértékelése True.
- ExpressionAttributeNames : Az UpdateExpressionban gyakran használt helyőrző attribútumnevek leképezése a táblázatban használt tényleges attribútumnevekkel. Ez a paraméter csak akkor szükséges, ha az UpdateExpression attribútumnevei közül bármelyik tartalmaz fenntartott szavakat és/vagy speciális karaktereket.
- ExpressionAttributeValues : Ez az UpdateExpressionban használt helyőrző értékek leképezése a frissítési műveletben használni kívánt tényleges értékekhez. Akkor hasznos, ha az UpdateExpression attribútumértékei közül bármelyik kifejezés vagy változó.
- ReturnValues : Meghatározza, hogy milyen információkat kell visszaküldenie a művelet sikeressége esetén. Az alapértelmezett érték NONE, ami azt jelenti, hogy nem talál információt a válaszról.
- ReturnConsumedCapacity : Megadja, hogy a frissítési művelet mennyi kapacitást vett igénybe. Az alapértelmezett értéke NONE, ami azt jelenti, hogy ezt az információt nem fogja megtalálni a visszatérési értékben.
- ReturnItemCollectionMetrics : Megadja a DynamoDb frissítési elem művelete által érintett elemgyűjtemények számát. Az alapértelmezett érték NONE, ami azt jelenti, hogy ez az információ nem kerül visszaadásra.
Az AWS CLI használatakor a DynamoDB UpdateItem szintaxisának így kell kinéznie:
aws dynamodb frissítési elem \--táblanév TABLE_NAME \
--kulcs '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--frissítés-kifejezés 'ATTRIBUTE_NAME = :érték1, ATTRIBUTE_NAME2 = :érték2' \
--kifejezés-attribútumértékek '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--visszatérési értékek UPDATED_OLD
Példák a DynamoDB UpdateItem művelet használatára
A DynamoDB UpdateItem művelet könnyen használható. És közben ügyeljen arra, hogy tartalmazza az elsődleges kulcs attribútumot és az UpdateExpression-t.
Az alábbiakban egy példa látható arra, hogyan használhatja az UpdateItem műveletet egy DynamoDB tábla módosítására:
aws dynamodb frissítési elem \--táblanév zene \
--kulcs '{ 'Előadó': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--frissítés-kifejezés 'SET AlbumTitle = :newval' \
--kifejezés-attribútumértékek '{':newval':{'S':'Frissített albumcím'}}' \
--visszatérési értékek TELJESEN ÚJ
A fenti művelet eredményének így kell kinéznie:
Következtetés
A DynamoDB UpdateItem művelet könnyen használható. Használhatja meglévő táblákon belüli elemek módosítására, vagy elemek hozzáadására egy már meglévő táblához. Vegye figyelembe, hogy a művelet sikeres végrehajtásához meg kell adnia az elsődleges kulcsot és az UpdateExpression kifejezést. Emellett ügyeljen a környezetére is. Végül a DynamoDB UpdateItem művelet a többi művelethez hasonlóan AWS SDK-kkal és AWS CLI-vel működik.