Skip to content

Commit ca8a352

Browse files
committed
Updating Data Locations chapter to reference RR.
1 parent cf40610 commit ca8a352

File tree

1 file changed

+11
-5
lines changed

1 file changed

+11
-5
lines changed

src/content/docs/d1/configuration/data-location.mdx

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,13 @@ Learn how the location of data stored in D1 is determined, including where the l
99

1010
## Automatic (recommended)
1111

12-
By default, D1 will automatically create your database in a location close to where you issued the request to create a database. In most cases this allows D1 to choose the optimal location for your database on your behalf.
12+
By default, D1 will automatically create your primary database instance in a location close to where you issued the request to create a database. In most cases this allows D1 to choose the optimal location for your database on your behalf.
1313

1414
## Provide a location hint
1515

16-
Location hint is an optional parameter you can provide to indicate your desired geographical location for your database.
16+
Location hint is an optional parameter you can provide to indicate your desired geographical location for your primary database instance.
1717

18-
You may want to explicitly provide a location hint in cases where the majority of your writes to a specific database come from a different location than where you are creating the database from. location hints can be useful when:
18+
You may want to explicitly provide a location hint in cases where the majority of your writes to a specific database come from a different location than where you are creating the database from. Location hints can be useful when:
1919

2020
- Working in a distributed team.
2121
- Creating databases specific to users in specific locations.
@@ -33,9 +33,7 @@ Providing a location hint does not guarantee that D1 runs in your preferred loca
3333
### Use Wrangler
3434

3535
:::note
36-
3736
To install Wrangler, the command-line interface for D1 and Workers, refer to [Install and Update Wrangler](/workers/wrangler/install-and-update/).
38-
3937
:::
4038

4139
To provide a location hint when creating a new database, pass the `--location` flag with a valid location hint:
@@ -70,3 +68,11 @@ D1 supports the following location hints:
7068
:::caution
7169
D1 location hints are not currently supported for South America (`sam`), Africa (`afr`), and the Middle East (`me`). D1 databases do not run in these locations.
7270
:::
71+
72+
## Read replica locations
73+
74+
D1 read replication allows you to create and distribute read-only copies of the primary database instance around the world. This reduces the query latency for users located far away from the primary database instance.
75+
76+
When using D1 read replication through [Sessions API](/d1/concepts/read-replication/#how-d1-read-replication-works), D1 automatically creates a read replica in [every available region](/d1/configuration/data-location#available-location-hints), including the region where the primary database instance is located.
77+
78+
Refer to [D1 read replication](/d1/concepts/read-replication/) for more information.

0 commit comments

Comments
 (0)