TransactWriteItems in DynamoDB

Introduction

TransactWriteItems lets you make multiple changes to your database at once. It makes sure all changes happen together or none at all, so your data stays correct.

You want to update several related items and keep them in sync.

You need to add a new order and reduce stock at the same time.

You want to delete an item only if another item meets a condition.

You want to make sure no partial updates happen if something fails.

Syntax

DynamoDB

TransactWriteItems {
  TransactItems: [
    {
      Put: { TableName, Item },
      Update: { TableName, Key, UpdateExpression, ExpressionAttributeValues },
      Delete: { TableName, Key },
      ConditionCheck: { TableName, Key, ConditionExpression }
    },
    ...
  ]
}

You include an array of actions inside TransactItems.

Each action can be a Put, Update, Delete, or ConditionCheck.

Examples

This example adds a new user and decreases stock for a product in one transaction.

DynamoDB

TransactWriteItems {
  TransactItems: [
    { Put: { TableName: "Users", Item: { UserId: "123", Name: "Alice" } } },
    { Update: { TableName: "Inventory", Key: { ProductId: "A1" }, UpdateExpression: "SET Stock = Stock - :dec", ExpressionAttributeValues: { ":dec": { "N": "1" } } } }
  ]
}

This deletes a session only if the user exists.

DynamoDB

TransactWriteItems {
  TransactItems: [
    { Delete: { TableName: "Sessions", Key: { SessionId: "abc" } } },
    { ConditionCheck: { TableName: "Users", Key: { UserId: "123" }, ConditionExpression: "attribute_exists(UserId)" } }
  ]
}

Sample Program

This transaction adds a new order and reduces the stock of the product by 2. Both happen together or not at all.

DynamoDB

TransactWriteItems {
  TransactItems: [
    {
      Put: {
        TableName: "Orders",
        Item: { OrderId: "order123", ProductId: "prod456", Quantity: { "N": "2" } }
      }
    },
    {
      Update: {
        TableName: "Inventory",
        Key: { ProductId: "prod456" },
        UpdateExpression: "SET Stock = Stock - :qty",
        ExpressionAttributeValues: { ":qty": { "N": "2" } }
      }
    }
  ]
}

Important Notes

All actions in TransactWriteItems succeed or fail together.

Use ConditionCheck to prevent unwanted changes.

Maximum 100 actions per transaction.

Summary

TransactWriteItems lets you group multiple writes into one safe transaction.

It helps keep your data consistent by applying all changes together.

You can use Put, Update, Delete, and ConditionCheck actions inside it.

Practice

1. What is the main purpose of TransactWriteItems in DynamoDB?

easy

A. To group multiple write operations into a single atomic transaction

B. To read multiple items from different tables at once

C. To create a backup of the database automatically

D. To perform batch deletes without conditions

Solution

1. Step 1: Understand the role of TransactWriteItems

   TransactWriteItems groups multiple write actions (Put, Update, Delete) into one atomic transaction.

2. Step 2: Compare with other options

   It does not perform reads, backups, or unconditional batch deletes.

3. Final Answer:

   To group multiple write operations into a single atomic transaction -> Option A

4. Quick Check:

   Atomic transaction = group writes together [OK]

Hint: Remember: TransactWriteItems groups writes atomically [OK]

Common Mistakes:

• Confusing TransactWriteItems with batch read operations
• Thinking it automatically backs up data
• Assuming it only deletes items

2. Which of the following is the correct syntax structure for a TransactWriteItems request in DynamoDB?

easy

A. { TransactWriteItems: [{ Get: { TableName: 'MyTable', Key: {...} } }] }

B. { BatchWriteItems: [{ PutRequest: {...} }, { DeleteRequest: {...} }] }

C. { TransactItems: [{ Put: { TableName: 'MyTable', Item: {...} } }, { Update: {...} }] }

D. { WriteItems: [{ Put: {...} }, { Update: {...} }] }

Solution

1. Step 1: Identify correct TransactWriteItems syntax

   The correct syntax uses the key 'TransactItems' with an array of actions like Put and Update.

2. Step 2: Eliminate incorrect options

   BatchWriteItems is a different API; Get is not a write action; WriteItems is not a valid key.

3. Final Answer:

   { TransactItems: [{ Put: { TableName: 'MyTable', Item: {...} } }, { Update: {...} }] } -> Option C

4. Quick Check:

   TransactItems with Put/Update = correct syntax [OK]

Hint: Look for 'TransactItems' key with write actions inside [OK]

Common Mistakes:

• Using BatchWriteItems instead of TransactWriteItems
• Including Get operations inside TransactWriteItems
• Using incorrect key names like WriteItems

3. Given the following TransactWriteItems request, what will happen if the condition in the Update action fails?

{
  TransactItems: [
    { Put: { TableName: 'Users', Item: { UserId: '123', Name: 'Alice' } } },
    { Update: { TableName: 'Users', Key: { UserId: '123' }, UpdateExpression: 'SET Age = :age', ConditionExpression: 'attribute_exists(UserId)', ExpressionAttributeValues: { ':age': 30 } } }
  ]
}

medium

A. Put action succeeds; Update action is skipped

B. Both actions succeed regardless of the condition

C. Update action succeeds; Put action is skipped

D. Both Put and Update actions are rolled back; no changes are applied

Solution

1. Step 1: Understand TransactWriteItems atomicity

   All actions in TransactWriteItems succeed or all fail together as one transaction.

2. Step 2: Analyze condition failure effect

   If the Update's condition fails, the entire transaction rolls back, including the Put.

3. Final Answer:

   Both Put and Update actions are rolled back; no changes are applied -> Option D

4. Quick Check:

   Condition failure rolls back entire transaction [OK]

Hint: If any condition fails, whole TransactWriteItems rolls back [OK]

Common Mistakes:

• Assuming partial success when condition fails
• Thinking Put action always succeeds
• Ignoring atomicity of TransactWriteItems

4. You wrote this TransactWriteItems request but it fails with a syntax error:

{
  TransactItems: [
    { Put: { TableName: 'Orders', Item: { OrderId: '001', Status: 'Pending' } } },
    { Delete: { TableName: 'Orders', Key: { OrderId: '002' } } }
  ],
  ReturnConsumedCapacity: 'TOTAL'
}

What is the likely cause of the error?

medium

A. Delete action requires a ConditionExpression

B. Missing comma after the TransactItems array

C. TransactItems must be an object, not an array

D. TableName cannot be specified inside Put or Delete actions

Solution

1. Step 1: Check JSON syntax in the request

   ReturnConsumedCapacity is a valid parameter, but the JSON is invalid due to a missing comma after the closing bracket (]) of the TransactItems array.

2. Step 2: Validate other parts

   Delete and Put actions are correctly structured; TransactItems must be an array; TableName is required inside actions.

3. Final Answer:

   Missing comma after the TransactItems array -> Option B

4. Quick Check:

   JSON requires commas between object properties [OK]

Hint: Validate JSON syntax: add commas between top-level properties [OK]

Common Mistakes:

• Omitting commas in JSON request objects
• Forgetting TableName inside each action
• Misusing array vs object for TransactItems

5. You want to atomically update a user's email and delete a related temporary token in DynamoDB using TransactWriteItems. Which of the following request structures correctly achieves this?

hard

A. { TransactItems: [ { Update: { TableName: 'Users', Key: { UserId: 'u1' }, UpdateExpression: 'SET Email = :e', ExpressionAttributeValues: { ':e': '[e-mail]' } } }, { Delete: { TableName: 'Tokens', Key: { TokenId: 't1' } } } ] }

B. { BatchWriteItems: [ { UpdateRequest: { Key: { UserId: 'u1' }, UpdateExpression: 'SET Email = :e' } }, { DeleteRequest: { Key: { TokenId: 't1' } } } ] }

C. { TransactItems: [ { Put: { TableName: 'Users', Item: { UserId: 'u1', Email: '[e-mail]' } } }, { Delete: { TableName: 'Tokens', Key: { TokenId: 't1' } } } ] }

D. { TransactItems: [ { Update: { TableName: 'Users', Key: { UserId: 'u1' }, UpdateExpression: 'SET Email = :e' } }, { Delete: { TableName: 'Tokens', Key: { TokenId: 't1' } } } ], ReturnValuesOnConditionCheckFailure: 'ALL_OLD' }

Solution

1. Step 1: Identify correct atomic update and delete

   { TransactItems: [ { Update: { TableName: 'Users', Key: { UserId: 'u1' }, UpdateExpression: 'SET Email = :e', ExpressionAttributeValues: { ':e': '[e-mail]' } } }, { Delete: { TableName: 'Tokens', Key: { TokenId: 't1' } } } ] } uses TransactWriteItems with Update and Delete actions correctly structured.

2. Step 2: Eliminate incorrect options

   { BatchWriteItems: [ { UpdateRequest: { Key: { UserId: 'u1' }, UpdateExpression: 'SET Email = :e' } }, { DeleteRequest: { Key: { TokenId: 't1' } } } ] } uses BatchWriteItems which does not support Update; { TransactItems: [ { Put: { TableName: 'Users', Item: { UserId: 'u1', Email: '[e-mail]' } } }, { Delete: { TableName: 'Tokens', Key: { TokenId: 't1' } } } ] } uses Put which replaces entire item, not update; { TransactItems: [ { Update: { TableName: 'Users', Key: { UserId: 'u1' }, UpdateExpression: 'SET Email = :e' } }, { Delete: { TableName: 'Tokens', Key: { TokenId: 't1' } } } ], ReturnValuesOnConditionCheckFailure: 'ALL_OLD' } includes unsupported parameter ReturnValuesOnConditionCheckFailure.

3. Final Answer:

   { TransactItems: [ { Update: { TableName: 'Users', Key: { UserId: 'u1' }, UpdateExpression: 'SET Email = :e', ExpressionAttributeValues: { ':e': '[e-mail]' } } }, { Delete: { TableName: 'Tokens', Key: { TokenId: 't1' } } } ] } -> Option A

4. Quick Check:

   Use Update and Delete inside TransactItems for atomic changes [OK]

Hint: Use Update and Delete inside TransactItems for atomic writes [OK]

Common Mistakes:

• Using BatchWriteItems for updates
• Using Put instead of Update to change attributes
• Adding unsupported parameters in TransactWriteItems