ADD expression for numeric increment in DynamoDB

Introduction

The ADD expression lets you increase or decrease a number in your database easily without replacing the whole item.

When you want to count how many times something happens, like page views.

When you need to add points to a user's score in a game.

When you want to update inventory counts after a sale.

When you want to track how many times a button is clicked.

When you want to increase a numeric value without reading it first.

Syntax

DynamoDB

UpdateExpression: "ADD attributeName :incrementValue"
ExpressionAttributeValues: { ":incrementValue": {"N": "number"} }

The ADD expression only works with numbers or sets in DynamoDB.

You provide the amount to add as a value with a colon prefix, like :incrementValue.

Examples

This adds 1 to the 'visits' attribute.

DynamoDB

UpdateExpression: "ADD visits :inc"
ExpressionAttributeValues: { ":inc": {"N": "1"} }

This adds 10 to the 'score' attribute.

DynamoDB

UpdateExpression: "ADD score :points"
ExpressionAttributeValues: { ":points": {"N": "10"} }

This subtracts 5 from the 'stock' attribute (using a negative number).

DynamoDB

UpdateExpression: "ADD stock :amount"
ExpressionAttributeValues: { ":amount": {"N": "-5"} }

Sample Program

This command adds 3 to the Quantity attribute of the product with ProductId '123'. It returns the new Quantity value.

DynamoDB

aws dynamodb update-item \
  --table-name Products \
  --key '{"ProductId": {"S": "123"}}' \
  --update-expression "ADD Quantity :inc" \
  --expression-attribute-values '{":inc": {"N": "3"}}' \
  --return-values UPDATED_NEW

Important Notes

If the attribute does not exist, ADD creates it with the value you provide.

You can use negative numbers to subtract values.

ADD works only with number or set types, not strings.

Summary

ADD expression updates numeric attributes by adding a value.

It can increase or decrease numbers without reading the current value first.

Useful for counters, scores, and inventory updates.

Practice

1. What does the ADD expression do in DynamoDB when updating a numeric attribute?

easy

A. It increases or decreases the numeric attribute by a specified value without reading the current value first.

B. It replaces the numeric attribute with a new value directly.

C. It deletes the numeric attribute from the item.

D. It multiplies the numeric attribute by a specified value.

Solution

1. Step 1: Understand the ADD expression purpose

   The ADD expression in DynamoDB is used to increment or decrement numeric attributes by adding a value.

2. Step 2: Compare with other operations

   Unlike SET which replaces values, ADD modifies the existing numeric value by adding to it without reading it first.

3. Final Answer:

   It increases or decreases the numeric attribute by a specified value without reading the current value first. -> Option A

4. Quick Check:

   ADD expression updates numeric attributes by adding value [OK]

Hint: ADD changes numbers by adding without reading current value [OK]

Common Mistakes:

• Thinking ADD replaces the value instead of adding
• Confusing ADD with DELETE operation
• Assuming ADD multiplies the number

2. Which of the following is the correct syntax to increment a numeric attribute score by 5 using the ADD expression in DynamoDB UpdateExpression?

easy

A. SET score ADD 5

B. SET score = score + 5

C. ADD score '5'

D. ADD score :inc

Solution

1. Step 1: Recall DynamoDB UpdateExpression syntax for ADD

   The ADD expression requires the attribute name followed by a placeholder for the value, like ADD score :inc.

2. Step 2: Check other options for syntax errors

   SET score = score + 5 uses SET with arithmetic which is invalid. ADD score '5' uses a string literal which is invalid for ADD. SET score ADD 5 mixes SET and ADD incorrectly.

3. Final Answer:

   ADD score :inc -> Option D

4. Quick Check:

   Correct ADD syntax uses attribute and value placeholder [OK]

Hint: Use ADD attribute :value with placeholder for increment [OK]

Common Mistakes:

• Using SET with arithmetic instead of ADD
• Using a string literal instead of numeric placeholder
• Mixing SET and ADD keywords incorrectly

3. Given the following DynamoDB update code snippet:

UpdateExpression: "ADD inventory :inc",
ExpressionAttributeValues: {":inc": 3}

If the current inventory value is 7, what will be the new value after the update?

medium

A. 3

B. Error: Cannot add without reading value

C. 10

D. 7

Solution

1. Step 1: Understand ADD increments current value

   The ADD expression adds the given value (3) to the existing attribute value (7).

2. Step 2: Calculate the new value

   7 + 3 = 10, so the new inventory value will be 10.

3. Final Answer:

   10 -> Option C

4. Quick Check:

   7 + 3 = 10 after ADD update [OK]

Hint: ADD adds value to current number, no read needed [OK]

Common Mistakes:

• Assuming ADD replaces value instead of adding
• Thinking ADD requires reading current value first
• Choosing the original value instead of updated

4. You wrote this DynamoDB update:

UpdateExpression: "ADD count :val",
ExpressionAttributeValues: {":val": "2"}

But it fails with a validation error. What is the most likely cause?

medium

A. The attribute name 'count' is reserved and cannot be used.

B. The value for :val is a string instead of a number.

C. ADD expression cannot be used with numeric attributes.

D. ExpressionAttributeValues must not use colons in keys.

Solution

1. Step 1: Check the type of ExpressionAttributeValues

   The value for :val is given as a string "2" instead of a numeric type.

2. Step 2: Understand ADD requires numeric values

   ADD expression only works with numbers, so passing a string causes a validation error.

3. Final Answer:

   The value for :val is a string instead of a number. -> Option B

4. Quick Check:

   ADD needs numeric value, not string [OK]

Hint: Ensure increment value is numeric, not string [OK]

Common Mistakes:

• Passing increment as string instead of number
• Misunderstanding reserved words error
• Incorrectly formatting ExpressionAttributeValues keys

5. You want to decrement a user's loginAttempts count by 1 using DynamoDB's ADD expression. Which UpdateExpression and ExpressionAttributeValues correctly achieve this?

hard

A. UpdateExpression: "ADD loginAttempts :dec", ExpressionAttributeValues: {":dec": -1}

B. UpdateExpression: "ADD loginAttempts '-1'", ExpressionAttributeValues: {}

C. UpdateExpression: "SET loginAttempts = loginAttempts - 1", ExpressionAttributeValues: {}

D. UpdateExpression: "ADD loginAttempts :dec", ExpressionAttributeValues: {":dec": 1}

Solution

1. Step 1: Use ADD with a negative number to decrement

   To decrease a numeric attribute, ADD accepts a negative value as the increment.

2. Step 2: Check syntax correctness

   UpdateExpression: "ADD loginAttempts :dec", ExpressionAttributeValues: {":dec": -1} correctly uses a placeholder :dec with value -1, which is valid syntax.

3. Step 3: Eliminate incorrect options

   UpdateExpression: "ADD loginAttempts '-1'", ExpressionAttributeValues: {} uses a string literal '-1' which is invalid for ADD. UpdateExpression: "SET loginAttempts = loginAttempts - 1", ExpressionAttributeValues: {} uses SET with arithmetic which is not allowed. UpdateExpression: "ADD loginAttempts :dec", ExpressionAttributeValues: {":dec": 1} adds +1, which increments instead of decrementing.

4. Final Answer:

   UpdateExpression: "ADD loginAttempts :dec", ExpressionAttributeValues: {":dec": -1} -> Option A

5. Quick Check:

   Use ADD with negative value to decrement [OK]

Hint: Use ADD with negative number placeholder to decrement [OK]

Common Mistakes:

• Trying to use SET with arithmetic expressions
• Using string literal for decrement value
• Using positive number to decrement