Amazon DynamoDB
Developer Guide (API Version 2012-08-10)

Global Tables: How It Works

The following sections help you understand the concepts and behavior of global tables in Amazon DynamoDB.

Global Table Concepts

A global table is a collection of one or more replica tables, all owned by a single AWS account.

A replica table (or replica, for short) is a single DynamoDB table that functions as a part of a global table. Each replica stores the same set of data items. Any given global table can only have one replica table per region.

The following is a conceptual overview of how a global table is created.

  1. Create an ordinary DynamoDB table, with DynamoDB Streams enabled, in an AWS region.

  2. Repeat step 1 for every other AWS region where you want to replicate your data.

  3. Define a DynamoDB global table, based upon the tables that you have created.

The AWS Management Console automates these tasks, so you can create a global table quickly and easily. (For detailed instructions, see Creating a Global Table.)

The resulting DynamoDB global table consists of multiple replica tables, one per region, that DynamoDB treats as a single unit. Every replica has the same table name and the same primary key schema. When an application writes data to a replica table in one region, DynamoDB automatically propagates the write to the other replica tables in the other AWS regions.


Global Tables automatically creates the following attributes for every item to keep your table data in sync:

  • aws:rep:deleting

  • aws:rep:updatetime

  • aws:rep:updateregion

You should not alter these attributes or create attributes with the same name.

You can add replica tables to the global table, so that it can be available in additional AWS regions. (In order to do this, the global table must be empty. In other words, none of the replica tables can have any data in them.)

You can also remove a replica table from a global table. If you do this, then the table is completely disassociated from the global table. This newly-independent table no longer interacts with the global table, and data is no longer propagated to or from the global table.

Consistency and Conflict Resolution

Any changes made to any item in any replica table will be replicated to all of the other replicas within the same global table. In a global table, a newly-written item is usually propagated to all replica tables within seconds.

With a global table, each replica table stores the same set of data items. DynamoDB does not support partial replication of only some of the items.

An application can read and write data to any replica table. If your application only uses eventually consistent reads, and only issues reads against one AWS region, then it will work without any modification.

However, if your application requires strongly consistent reads, then it must perform all of its strongly consistent reads and writes in the same region. DynamoDB does not support strongly consistent reads across AWS regions; therefore, if you write to one region and read from another region, the read response might include stale data that doesn't reflect the results of recently-completed writes in the other region.

Conflicts can arise if applications update the same item in different regions at about the same time. To ensure eventual consistency, DynamoDB global tables use a “last writer wins” reconciliation between concurrent updates, where DynamoDB makes a best effort to determine the last writer. With this conflict resolution mechanism, all of the replicas will agree on the latest update, and converge toward a state in which they all have identical data.

Availability and Durability

If a single AWS region becomes isolated or degraded, your application can redirect to a different region and perform reads and writes against a different replica table. You can apply custom business logic to determine when to redirect requests to other regions.

If a region becomes isolated or degraded, DynamoDB keeps track of any writes that have been performed, but have not yet been propagated to all of the replica tables. When the region comes back online, DynamoDB will resume propagating any pending writes from that region to the replica tables in other regions. It will also resume propagating writes from other replica tables to the region that is now back online.