DeleteItem in DynamoDB - Mini Project: Build & Apply

Delete an Item from a DynamoDB Table

📖 Scenario: You manage a small online bookstore. You keep track of books in a DynamoDB table called Books. Sometimes, a book is no longer available and you need to remove it from your database.

🎯 Goal: Learn how to delete a specific item from a DynamoDB table using the DeleteItem operation.

📋 What You'll Learn

Create a DynamoDB table named Books with a primary key ISBN.

Set up a variable with the ISBN of the book to delete.

Write the DeleteItem command to remove the book with the specified ISBN.

Complete the deletion request with the correct table name and key.

💡 Why This Matters

🌍 Real World

Deleting items from a database is common when data becomes outdated or incorrect, such as removing discontinued products or outdated records.

💼 Career

Database administrators and backend developers often need to delete records safely and efficiently using commands like DeleteItem in DynamoDB.

1

Create the Books table data structure

Create a dictionary called Books that represents your DynamoDB table with these exact items: {'ISBN': '978-0132350884', 'Title': 'Clean Code', 'Author': 'Robert C. Martin'} and {'ISBN': '978-0201616224', 'Title': 'The Pragmatic Programmer', 'Author': 'Andrew Hunt'}.

DynamoDB

# Create the Books table with two items
# Your code here

Hint

Use a list of dictionaries to represent the table items exactly as shown.

2

Set the ISBN to delete

Create a variable called isbn_to_delete and set it to the string '978-0132350884' which is the ISBN of the book you want to remove.

DynamoDB

Books = [
    {'ISBN': '978-0132350884', 'Title': 'Clean Code', 'Author': 'Robert C. Martin'},
    {'ISBN': '978-0201616224', 'Title': 'The Pragmatic Programmer', 'Author': 'Andrew Hunt'}
]
# Set the ISBN of the book to delete
# Your code here

Hint

Assign the exact string to the variable isbn_to_delete.

3

Write the DeleteItem command

Create a dictionary called delete_request that represents the DynamoDB DeleteItem command. It should have a key TableName set to 'Books' and a key Key which is a dictionary with 'ISBN' set to the value of isbn_to_delete.

DynamoDB

Books = [
    {'ISBN': '978-0132350884', 'Title': 'Clean Code', 'Author': 'Robert C. Martin'},
    {'ISBN': '978-0201616224', 'Title': 'The Pragmatic Programmer', 'Author': 'Andrew Hunt'}
]
isbn_to_delete = '978-0132350884'
# Create the DeleteItem command dictionary
# Your code here

Hint

Use a dictionary with keys TableName and Key exactly as shown, with the key value wrapped in a type dictionary.

4

Complete the DeleteItem request

Add a key ReturnValues to the delete_request dictionary and set it to 'ALL_OLD' to return the deleted item details.

DynamoDB

Books = [
    {'ISBN': '978-0132350884', 'Title': 'Clean Code', 'Author': 'Robert C. Martin'},
    {'ISBN': '978-0201616224', 'Title': 'The Pragmatic Programmer', 'Author': 'Andrew Hunt'}
]
isbn_to_delete = '978-0132350884'
delete_request = {
    'TableName': 'Books',
    'Key': {'ISBN': {'S': isbn_to_delete}}
}
# Add ReturnValues to delete_request
# Your code here

Hint

Set ReturnValues to 'ALL_OLD' inside the delete_request dictionary.

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