Skip to content

Commit 401117a

Browse files
committed
Add more explanation for default region values
Fixes cockroachdb#10200. Add more explanation about how a default region is chosen for rows in a `REGIONAL BY ROW` table when you have not yet set a new value for the `crdb_region` column.
1 parent e72424f commit 401117a

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

v21.1/set-locality.md

+2
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,8 @@ To add a new row to a regional by row table, you must choose one of the followin
9898

9999
This is necessary because every row in a regional by row table must have a home region.
100100

101+
If you do not set a home region for a row in a regional by row table, it defaults to the value returned by the built-in function `gateway_region()`. If the value returned by `gateway_region()` does not belong to the multi-region database the table is a part of, the home region defaults to the database's primary region.
102+
101103
For more information about how this table locality works, see [Regional by row tables](multiregion-overview.html#regional-by-row-tables).
102104
103105
Note that you can use a name other than `crdb_region` for the hidden column by using the following statements:

0 commit comments

Comments
 (0)