Skip to content

Commit c12f5db

Browse files
committed
Updating gifs for all consistency types
1 parent a4a7d1c commit c12f5db

File tree

1 file changed

+19
-4
lines changed

1 file changed

+19
-4
lines changed

articles/cosmos-db/consistency-levels.md

Lines changed: 19 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@ The semantics of the five consistency levels are described here:
3535

3636
- **Strong**: Strong consistency offers a linearizability guarantee. Linearizability refers to serving requests concurrently. The reads are guaranteed to return the most recent committed version of an item. A client never sees an uncommitted or partial write. Users are always guaranteed to read the latest committed write.
3737

38-
The following graphic illustrates the strong consistency with musical notes. After the data is written to the East US region, when you read the data from other regions, you get the most recent value:
38+
The following graphic illustrates the strong consistency with musical notes. After the data is written to the "East US" region, when you read the data from other regions, you get the most recent value:
3939

40-
![video](media/consistency-levels/strong-consistency.gif)
40+
![video](media/consistency-levels/strong-consistency.gif)
4141

4242
- **Bounded staleness**: The reads are guaranteed to honor the consistent-prefix guarantee. The reads might lag behind writes by at most *"K"* versions (i.e., "updates") of an item or by *"T"* time interval. In other words, when you choose bounded staleness, the "staleness" can be configured in two ways:
4343

@@ -46,11 +46,26 @@ The semantics of the five consistency levels are described here:
4646

4747
Bounded staleness offers total global order except within the "staleness window." The monotonic read guarantees exist within a region both inside and outside the staleness window. Strong consistency has the same semantics as the one offered by bounded staleness. The staleness window is equal to zero. Bounded staleness is also referred to as time-delayed linearizability. When a client performs read operations within a region that accepts writes, the guarantees provided by bounded staleness consistency are identical to those guarantees by the strong consistency.
4848

49-
- **Session**: Within a single client session reads are guaranteed to honor the consistent-prefix (assuming a single “writer” session), monotonic reads, monotonic writes, read-your-writes, and write-follows-reads guarantees. Clients outside of the session performing writes will see eventual consistency.
49+
Bounded staleness is frequently chosen by globally distributed applications that expect low write latencies but require total global order guarantee. Bounded staleness is great for applications featuring group collaboration and sharing, stock ticker, publish-subscribe/queueing etc. The following graphic illustrates the bounded staleness consistency with musical notes. After the data is written to the "East US" region, the "West US" and "Australia East" regions read the written value based on the configured maximum lag time or the maximum operations:
50+
51+
![video](media/consistency-levels/bounded-staleness-consistency.gif)
52+
53+
- **Session**: Within a single client session reads are guaranteed to honor the consistent-prefix (assuming a single "writer" session), monotonic reads, monotonic writes, read-your-writes, and write-follows-reads guarantees. Clients outside of the session performing writes will see eventual consistency.
54+
55+
Session consistency is the widely used consistency level for both single region as well as globally distributed applications. It provides write latencies, availability, and read throughput comparable to that of eventual consistency but also provides the consistency guarantees that suit the needs of applications written to operate in the context of a user. The following graphic illustrates the session consistency with musical notes. The "West US" region and the "East US" regions are using the same session (Session A) so they both read the data at the same time. Whereas the "Australia East" region is using "Session B" so it receives data a later but in the same order as the writes.
56+
57+
![video](media/consistency-levels/session-consistency.gif)
5058

5159
- **Consistent prefix**: Updates that are returned contain some prefix of all the updates, with no gaps. Consistent prefix consistency level guarantees that reads never see out-of-order writes.
5260

53-
- **Eventual**: There's no ordering guarantee for reads. In the absence of any further writes, the replicas eventually converge.
61+
If writes were performed in the order `A, B, C`, then a client sees either `A`, `A,B`, or `A,B,C`, but never out of order like `A,C` or `B,A,C`. Consistent Prefix provides write latencies, availability and read throughput comparable to that of eventual consistency, but also provides the order guarantees that suit the needs of scenarios where order is important. The following graphic illustrates the consistency prefix consistency with musical notes. In all the regions, the reads never see out of order writes:
62+
63+
![video](media/consistency-levels/consistent-prefix.gif)
64+
65+
- **Eventual**: There's no ordering guarantee for reads. In the absence of any further writes, the replicas eventually converge.
66+
Eventual consistency is the weakest form of consistency because a client may read the values which are older than the ones it had read before. Eventual consistency is ideal where the application does not require any ordering guarantees. Examples include count of Retweets, Likes or non-threaded comments. The following graphic illustrates the eventual consistency with musical notes.
67+
68+
![video](media/consistency-levels/eventual-consistency.gif)
5469

5570
## Additional reading
5671

0 commit comments

Comments
 (0)