DeleteItem in DynamoDB

Introduction

DeleteItem lets you remove a single item from a DynamoDB table. It helps keep your data clean by deleting things you no longer need.

You want to remove a user's old session data after they log out.

You need to delete a product from your inventory when it is discontinued.

You want to clear a temporary record after processing it.

You want to remove a specific comment from a post.

You want to delete a booking that was canceled.

Syntax

DynamoDB

DeleteItem {
  TableName: "YourTableName",
  Key: {
    "PrimaryKeyName": { "S": "PrimaryKeyValue" }
  }
}

The TableName is the name of your DynamoDB table.

The Key specifies which item to delete using its primary key.

Examples

Deletes the user with UserId '123' from the Users table.

DynamoDB

DeleteItem {
  TableName: "Users",
  Key: {
    "UserId": { "S": "123" }
  }
}

Deletes the product with ProductId 'A1B2C3' from the Products table.

DynamoDB

DeleteItem {
  TableName: "Products",
  Key: {
    "ProductId": { "S": "A1B2C3" }
  }
}

Sample Program

This command deletes the book with the ISBN '978-3-16-148410-0' from the Books table.

DynamoDB

DeleteItem {
  TableName: "Books",
  Key: {
    "ISBN": { "S": "978-3-16-148410-0" }
  }
}

Important Notes

If the item does not exist, DeleteItem does nothing and returns success.

You can use ReturnValues to get the deleted item's attributes if needed.

Summary

DeleteItem removes one item from a DynamoDB table using its primary key.

It is useful for cleaning up or removing specific records.

The operation is simple and fast, and does nothing if the item is not found.

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