DeleteItem in DynamoDB - Step-by-Step Execution

Concept Flow - DeleteItem

Start DeleteItem Request

↓

Identify Table & Key

↓

Check if Item Exists

↓

Delete Item

↓

Return Success

↓

End

The DeleteItem operation starts by identifying the table and key, checks if the item exists, deletes it if found (no-op otherwise), and returns success accordingly.

Execution Sample

DynamoDB

DeleteItem {
  TableName: 'Users',
  Key: { 'UserID': '123' }
}

This command deletes the item with UserID '123' from the 'Users' table.

Execution Table

Step	Action	Input	Check	Result	Output
1	Receive DeleteItem request	{TableName:'Users', Key:{UserID:'123'}}	N/A	Request accepted	Waiting to process
2	Look up item by key	Key: UserID='123'	Item exists?	Yes	Item found
3	Delete item	Item found	N/A	Item deleted	Success response
4	Return response	Success	N/A	Operation complete	DeleteItem succeeded

💡 Item with UserID '123' found and deleted, operation completed successfully.

Variable Tracker

Variable	Start	After Step 2	After Step 3	Final
ItemExists	Unknown	True	Deleted	Deleted
ResponseStatus	Pending	Pending	Success	Success

Key Moments - 2 Insights

What happens if the item does not exist when DeleteItem is called?

If the item does not exist, the check at Step 2 would return 'No', and the operation returns success (no item deleted).

Does DeleteItem return the deleted item by default?

No, DeleteItem does not return the deleted item unless you specify ReturnValues. By default, it only confirms success as shown in Step 4.

Visual Quiz - 3 Questions

Look at the execution_table, at which step is the item confirmed to exist?

A Step 1

B Step 3

C Step 2

D Step 4

💡 Hint

Check the 'Check' column in execution_table rows to find where 'Item exists?' is evaluated.

According to variable_tracker, what is the value of 'ItemExists' after Step 3?

A Deleted

B True

C Unknown

D False

💡 Hint

Look at the 'ItemExists' row and the 'After Step 3' column in variable_tracker.

If the item was not found, how would the execution_table change?

A Step 3 would delete a different item

B Step 4 would return success anyway

C Step 2 would show 'No' and Step 3 would be skipped

D Step 1 would fail

💡 Hint

Refer to the concept_flow where both paths end in success.

Concept Snapshot

DeleteItem syntax:
DeleteItem { TableName: 'Table', Key: { PrimaryKey: 'value' } }

Behavior:
- Checks if item exists by key
- Deletes item if found
- Returns success (even if not found)

Key rule:
No item returned unless ReturnValues specified

Full Transcript

The DeleteItem operation in DynamoDB starts by receiving a request specifying the table and the key of the item to delete. It then checks if the item exists. If the item is found, it deletes the item and returns a success response. If the item does not exist, it returns a success response (no item deleted). By default, DeleteItem does not return the deleted item unless requested. This process ensures safe deletion and clear feedback on the operation's result.

Practice

1. What does the DeleteItem operation do in DynamoDB?

easy

A. Deletes all items in a table

B. Reads an item from the table

C. Updates an item in the table

D. Removes a single item from a table using its primary key

Solution

1. Step 1: Understand the purpose of DeleteItem

   DeleteItem is designed to remove exactly one item identified by its primary key from a DynamoDB table.

2. Step 2: Compare with other operations

   Unlike update or read operations, DeleteItem specifically removes the item and does nothing if the item does not exist.

3. Final Answer:

   Removes a single item from a table using its primary key -> Option D

4. Quick Check:

   DeleteItem removes one item [OK]

Hint: DeleteItem removes by primary key only [OK]

Common Mistakes:

• Thinking DeleteItem deletes multiple items
• Confusing DeleteItem with UpdateItem
• Assuming DeleteItem reads data

2. Which of the following is the correct syntax to delete an item with primary key {"UserId": "123"} from a DynamoDB table named Users using AWS SDK for JavaScript v3?

easy

A. await client.deleteItem({ TableName: "Users", Key: { UserId: "123" } });

B. await client.send(new DeleteItemCommand({ TableName: "Users", Key: { UserId: { S: "123" } } }));

C. client.delete({ TableName: "Users", Key: { UserId: { S: "123" } } });

D. await client.send(new DeleteCommand({ TableName: "Users", Key: { UserId: "123" } }));

Solution

1. Step 1: Identify correct AWS SDK v3 syntax

   In AWS SDK v3 for JavaScript, DeleteItemCommand is used with client.send and the Key attribute must specify the data type (S for string).

2. Step 2: Check each option

   await client.send(new DeleteItemCommand({ TableName: "Users", Key: { UserId: { S: "123" } } })); correctly uses DeleteItemCommand with Key including data type. Distractors use incorrect method names like deleteItem or delete, omit data types, lack await or send, or use DeleteCommand which is not valid.

3. Final Answer:

   await client.send(new DeleteItemCommand({ TableName: "Users", Key: { UserId: { S: "123" } } })); -> Option B

4. Quick Check:

   Correct command and key format = await client.send(new DeleteItemCommand({ TableName: "Users", Key: { UserId: { S: "123" } } })); [OK]

Hint: Use DeleteItemCommand with typed Key in AWS SDK v3 [OK]

Common Mistakes:

• Omitting data type in Key
• Using wrong command name
• Not awaiting the promise

3. Given the following DynamoDB table Products with primary key ProductId, what will be the result of this DeleteItem operation?

await client.send(new DeleteItemCommand({
  TableName: "Products",
  Key: { ProductId: { S: "P100" } }
}));

Assuming the item with ProductId = "P100" exists.

medium

A. The item with ProductId "P100" is removed from the table

B. The item is updated with empty attributes

C. An error is thrown because DeleteItem cannot delete existing items

D. Nothing happens because DeleteItem only works on non-existing items

Solution

1. Step 1: Understand DeleteItem behavior on existing items

   DeleteItem removes the specified item if it exists, identified by the primary key.

2. Step 2: Analyze the given operation

   The command targets ProductId "P100" which exists, so the item will be deleted from the table.

3. Final Answer:

   The item with ProductId "P100" is removed from the table -> Option A

4. Quick Check:

   DeleteItem removes existing item = The item with ProductId "P100" is removed from the table [OK]

Hint: DeleteItem removes existing item by key [OK]

Common Mistakes:

• Thinking DeleteItem updates instead of deletes
• Assuming DeleteItem throws error if item exists
• Believing DeleteItem does nothing on existing items

4. You wrote this code to delete an item but it throws an error:

await client.send(new DeleteItemCommand({
  TableName: "Orders",
  Key: { OrderId: "O123" }
}));

What is the most likely cause of the error?

medium

A. The Key attribute must specify data types like { S: "O123" }

B. TableName is incorrect and must be lowercase

C. DeleteItemCommand cannot be awaited

D. OrderId is not a valid primary key

Solution

1. Step 1: Check the Key format in DeleteItemCommand

   In DynamoDB SDK, the Key must specify attribute values with their data types, e.g., { S: "O123" } for string.

2. Step 2: Identify the error cause

   The code uses { OrderId: "O123" } without data type, causing a validation error.

3. Final Answer:

   The Key attribute must specify data types like { S: "O123" } -> Option A

4. Quick Check:

   Key requires data type = The Key attribute must specify data types like { S: "O123" } [OK]

Hint: Always include data types in Key for DeleteItem [OK]

Common Mistakes:

• Omitting data types in Key
• Assuming TableName case matters
• Not awaiting async calls

5. You want to delete an item only if it exists and has the attribute Status set to "Pending". Which DeleteItem parameter should you use to ensure this conditional delete?

hard

A. Use KeyConditionExpression to filter the item

B. Use ReturnValues: "ALL_OLD" to check the old item

C. Use ConditionExpression: "Status = :val" with ExpressionAttributeValues: { ":val": { S: "Pending" } }

D. Use UpdateExpression to set Status to null before deleting

Solution

1. Step 1: Understand conditional deletes in DynamoDB

   DeleteItem supports a ConditionExpression to delete only if the condition is true.

2. Step 2: Apply condition to Status attribute

   Using ConditionExpression "Status = :val" with ExpressionAttributeValues specifying "Pending" ensures deletion only if Status is "Pending".

3. Step 3: Evaluate other options

   ReturnValues returns old data but does not conditionally delete. KeyConditionExpression is for queries, not deletes. UpdateExpression is for updates, not deletes.

4. Final Answer:

   Use ConditionExpression: "Status = :val" with ExpressionAttributeValues: { ":val": { S: "Pending" } } -> Option C

5. Quick Check:

   Conditional delete uses ConditionExpression = Use ConditionExpression: "Status = :val" with ExpressionAttributeValues: { ":val": { S: "Pending" } } [OK]

Hint: Use ConditionExpression to delete conditionally [OK]

Common Mistakes:

• Using KeyConditionExpression in DeleteItem
• Confusing ReturnValues with conditions
• Trying to update before delete