Boto3 (Python) client vs resource in DynamoDB - Hands-On Comparison

Using Boto3 Client and Resource with DynamoDB

📖 Scenario: You are working on a simple inventory system that stores product information in an AWS DynamoDB table. You want to learn how to interact with DynamoDB using Boto3's client and resource interfaces in Python.

🎯 Goal: Build a Python script that creates a DynamoDB table structure in memory, sets up a configuration variable for the table name, uses both Boto3 client and resource to put and get an item, and completes the script with a final confirmation variable.

📋 What You'll Learn

Create a dictionary called product_item with keys 'ProductId' and 'Name' and values '101' and 'Notebook' respectively.

Create a variable called table_name and set it to 'Products'.

Use Boto3 client to put product_item into the DynamoDB table named table_name.

Use Boto3 resource to get the item with ProductId '101' from the same table.

Create a variable called operation_complete and set it to True to indicate the script finished.

💡 Why This Matters

🌍 Real World

Many applications use AWS DynamoDB to store and retrieve data. Knowing how to use Boto3 client and resource interfaces helps developers interact with DynamoDB efficiently.

💼 Career

Understanding Boto3 client vs resource is important for AWS developers, cloud engineers, and backend developers working with AWS services.

1

DATA SETUP: Create the product item dictionary

Create a dictionary called product_item with these exact entries: 'ProductId': '101' and 'Name': 'Notebook'.

DynamoDB

# Create the product_item dictionary with ProductId and Name
# Your code here

Hint

Use curly braces {} to create a dictionary with the exact keys and values.

2

CONFIGURATION: Set the DynamoDB table name

Create a variable called table_name and set it to the string 'Products'.

DynamoDB

product_item = {'ProductId': '101', 'Name': 'Notebook'}
# Set the table_name variable to 'Products'
# Your code here

Hint

Assign the string 'Products' to the variable table_name.

3

CORE LOGIC: Use Boto3 client and resource to put and get item

Import boto3. Create a dynamodb_client using boto3.client('dynamodb'). Use dynamodb_client.put_item to put product_item into the table named table_name. Then create a dynamodb_resource using boto3.resource('dynamodb'). Use dynamodb_resource.Table(table_name).get_item to get the item with Key={'ProductId': '101'}.

DynamoDB

product_item = {'ProductId': '101', 'Name': 'Notebook'}
table_name = 'Products'
# Import boto3 and create dynamodb_client
# Use dynamodb_client.put_item to add product_item to table_name
# Create dynamodb_resource and get the item with ProductId '101'
# Your code here

Hint

Remember that put_item with client requires the item attributes to be typed as {'S': 'value'} for strings.

4

COMPLETION: Add a final confirmation variable

Create a variable called operation_complete and set it to True to indicate the script finished successfully.

DynamoDB

import boto3

product_item = {'ProductId': '101', 'Name': 'Notebook'}
table_name = 'Products'

dynamodb_client = boto3.client('dynamodb')
dynamodb_client.put_item(TableName=table_name, Item={'ProductId': {'S': '101'}, 'Name': {'S': 'Notebook'}})

dynamodb_resource = boto3.resource('dynamodb')
table = dynamodb_resource.Table(table_name)
response = table.get_item(Key={'ProductId': '101'})
# Set operation_complete to True
# Your code here

Hint

Simply assign True to the variable operation_complete.

Practice

1. What is the main difference between Boto3 client and resource when working with DynamoDB?

easy

A. client is deprecated, resource is the new standard.

B. client is only for S3, resource is only for DynamoDB.

C. client is low-level and matches AWS API calls exactly, while resource is higher-level and easier to use.

D. client automatically manages retries, resource does not.

Solution

1. Step 1: Understand the roles of client and resource

   The client provides direct access to AWS service APIs with low-level calls, matching the exact API structure.

2. Step 2: Compare with resource abstraction

   The resource offers a higher-level, object-oriented interface that simplifies interactions with AWS services like DynamoDB.

3. Final Answer:

   client is low-level and matches AWS API calls exactly, while resource is higher-level and easier to use. -> Option C

4. Quick Check:

   client = low-level, resource = high-level [OK]

Hint: Client = low-level API, resource = easier Python objects [OK]

Common Mistakes:

• Thinking client is deprecated
• Confusing client and resource usage scope
• Assuming resource has full API coverage

2. Which of the following is the correct way to create a DynamoDB resource using Boto3 in Python?

easy

A. dynamodb = boto3.client('dynamodb')

B. dynamodb = boto3.resource('dynamodb')

C. dynamodb = boto3.connect('dynamodb')

D. dynamodb = boto3.session('dynamodb')

Solution

1. Step 1: Recall Boto3 resource creation syntax

   To create a resource, use boto3.resource('service_name'). For DynamoDB, it is boto3.resource('dynamodb').

2. Step 2: Identify incorrect options

   boto3.client('dynamodb') creates a client, not a resource. connect and session are not valid Boto3 methods for this purpose.

3. Final Answer:

   dynamodb = boto3.resource('dynamodb') -> Option B

4. Quick Check:

   Resource creation uses boto3.resource('service') [OK]

Hint: Use boto3.resource('dynamodb') for resource creation [OK]

Common Mistakes:

• Using boto3.client instead of boto3.resource
• Trying to use boto3.connect which doesn't exist
• Confusing session with resource creation

3. Given the following code snippet using Boto3 resource:

import boto3
dynamodb = boto3.resource('dynamodb')
table = dynamodb.Table('Users')
response = table.get_item(Key={'UserId': '123'})
print(response['Item']['Name'])

What will this code print if the item exists with Name 'Alice'?

medium

A. 123

B. None

C. KeyError

D. Alice

Solution

1. Step 1: Understand the get_item call on resource Table

   The get_item method returns a dictionary with an 'Item' key containing the requested item if it exists.

2. Step 2: Access the 'Name' attribute from the returned item

   The code prints response['Item']['Name'], which will be 'Alice' if the item exists with that attribute.

3. Final Answer:

   Alice -> Option D

4. Quick Check:

   response['Item']['Name'] = Alice [OK]

Hint: get_item returns dict with 'Item' key holding data [OK]

Common Mistakes:

• Assuming response is just the item dict
• Forgetting to check 'Item' key
• Confusing client and resource response formats

4. What is wrong with this Boto3 client code snippet for DynamoDB?

import boto3
client = boto3.client('dynamodb')
response = client.get_item(TableName='Users', Key={'UserId': '123'})
print(response['Item'])

medium

A. The Key value should be a dict with attribute type, e.g., {'UserId': {'S': '123'}}

B. TableName should be lowercase 'users'

C. client.get_item does not exist, use resource instead

D. print statement should be print(response.Item)

Solution

1. Step 1: Check the Key format for client get_item

   When using the low-level client, the Key must specify attribute types, e.g., {'UserId': {'S': '123'}}.

2. Step 2: Identify other issues

   TableName is case-sensitive and usually capitalized as in the table creation. The method get_item exists on client. The print syntax is correct for a dict.

3. Final Answer:

   The Key value should be a dict with attribute type, e.g., {'UserId': {'S': '123'}} -> Option A

4. Quick Check:

   Client Key needs attribute type dict [OK]

Hint: Client Key needs attribute type dict like {'S': 'value'} [OK]

Common Mistakes:

• Using simple dict for Key with client
• Assuming client and resource Key formats are same
• Ignoring case sensitivity of TableName

5. You want to update an item attribute in DynamoDB using Boto3. Which approach correctly uses the resource and client to update the attribute 'Age' to 30 for UserId '123'?

hard

A. Resource: table.update_item(Key={'UserId': '123'}, UpdateExpression='SET Age = :val', ExpressionAttributeValues={':val': 30})
Client: client.update_item(TableName='Users', Key={'UserId': {'S': '123'}}, UpdateExpression='SET Age = :val', ExpressionAttributeValues={':val': {'N': '30'}})

B. Resource: table.update_item(Key={'UserId': {'S': '123'}}, UpdateExpression='SET Age = :val', ExpressionAttributeValues={':val': {'N': '30'}})
Client: client.update_item(TableName='Users', Key={'UserId': '123'}, UpdateExpression='SET Age = :val', ExpressionAttributeValues={':val': 30})

C. Resource: table.put_item(Item={'UserId': '123', 'Age': 30})
Client: client.put_item(TableName='Users', Item={'UserId': {'S': '123'}, 'Age': {'N': '30'}})

D. Resource: table.update_item(Key={'UserId': '123'}, UpdateExpression='ADD Age :val', ExpressionAttributeValues={':val': 30})
Client: client.update_item(TableName='Users', Key={'UserId': {'S': '123'}}, UpdateExpression='ADD Age :val', ExpressionAttributeValues={':val': {'N': '30'}})

Solution

1. Step 1: Understand resource update_item usage

   Resource expects simple Python types for Key and ExpressionAttributeValues, so {'UserId': '123'} and {':val': 30} are correct.

2. Step 2: Understand client update_item usage

   Client requires attribute types in Key and ExpressionAttributeValues, so {'UserId': {'S': '123'}} and {':val': {'N': '30'}} are needed.

3. Step 3: Confirm UpdateExpression syntax

   Using SET Age = :val is correct for updating an attribute value.

4. Final Answer:

   Resource and client update_item calls with correct Key and ExpressionAttributeValues formats as in option A -> Option A

5. Quick Check:

   Resource uses plain types, client uses typed dicts [OK]

Hint: Resource uses plain dicts; client needs typed attribute dicts [OK]

Common Mistakes:

• Mixing client and resource Key formats
• Using ADD instead of SET for update
• Passing raw values in client ExpressionAttributeValues