Skip to content

Commit 9a9e519

Browse files
jeevanshujeevanshu
committed
Update zone configuration constraints to provide cloud vendor region info
1 parent 383e08b commit 9a9e519

11 files changed

Lines changed: 286 additions & 0 deletions

‎src/current/v23.1/show-zone-configurations.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,32 @@ Parameter | Description
2727
`partition_name` | The name of the [partition]({% link {{ page.version.version }}/partitioning.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2828
`index_name` | The name of the [index]({% link {{ page.version.version }}/indexes.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2929

30+
## Cloud provider prefixes for region constraints
31+
32+
{{site.data.alerts.callout_info}}
33+
When specifying region constraints or lease preferences for nodes running on cloud providers, you must include the cloud provider prefix in the region name. The format is `{provider}-{region-name}`.
34+
{{site.data.alerts.end}}
35+
36+
For example:
37+
38+
Cloud Provider | Region Format | Example
39+
---------------|---------------|--------
40+
**AWS** | `aws-{region}` | `aws-us-east-1`, `aws-eu-central-1`
41+
**GCP** | `gcp-{region}` | `gcp-us-east1`, `gcp-asia-south1`
42+
**Azure** | `azure-{region}` | `azure-eastus`, `azure-westus2`
43+
44+
This applies when using `constraints` or `lease_preferences` in zone configurations. For instance:
45+
46+
{% include_cached copy-clipboard.html %}
47+
~~~ sql
48+
ALTER TABLE my_table CONFIGURE ZONE USING constraints = '[+region=gcp-us-east1]';
49+
~~~
50+
51+
{% include_cached copy-clipboard.html %}
52+
~~~ sql
53+
ALTER DATABASE my_db CONFIGURE ZONE USING constraints = '{"+region=aws-us-east-1": 2, "+region=aws-eu-central-1": 1}';
54+
~~~
55+
3056
## Examples
3157

3258
{% include {{ page.version.version }}/sql/movr-statements-geo-partitioned-replicas.md %}

‎src/current/v23.2/show-zone-configurations.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,32 @@ Parameter | Description
2727
`partition_name` | The name of the [partition]({% link {{ page.version.version }}/partitioning.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2828
`index_name` | The name of the [index]({% link {{ page.version.version }}/indexes.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2929

30+
## Cloud provider prefixes for region constraints
31+
32+
{{site.data.alerts.callout_info}}
33+
When specifying region constraints or lease preferences for nodes running on cloud providers, you must include the cloud provider prefix in the region name. The format is `{provider}-{region-name}`.
34+
{{site.data.alerts.end}}
35+
36+
For example:
37+
38+
Cloud Provider | Region Format | Example
39+
---------------|---------------|--------
40+
**AWS** | `aws-{region}` | `aws-us-east-1`, `aws-eu-central-1`
41+
**GCP** | `gcp-{region}` | `gcp-us-east1`, `gcp-asia-south1`
42+
**Azure** | `azure-{region}` | `azure-eastus`, `azure-westus2`
43+
44+
This applies when using `constraints` or `lease_preferences` in zone configurations. For instance:
45+
46+
{% include_cached copy-clipboard.html %}
47+
~~~ sql
48+
ALTER TABLE my_table CONFIGURE ZONE USING constraints = '[+region=gcp-us-east1]';
49+
~~~
50+
51+
{% include_cached copy-clipboard.html %}
52+
~~~ sql
53+
ALTER DATABASE my_db CONFIGURE ZONE USING constraints = '{"+region=aws-us-east-1": 2, "+region=aws-eu-central-1": 1}';
54+
~~~
55+
3056
## Examples
3157

3258
{% include {{ page.version.version }}/sql/movr-statements-geo-partitioned-replicas.md %}

‎src/current/v24.1/show-zone-configurations.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,32 @@ Parameter | Description
2727
`partition_name` | The name of the [partition]({% link {{ page.version.version }}/partitioning.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2828
`index_name` | The name of the [index]({% link {{ page.version.version }}/indexes.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2929

30+
## Cloud provider prefixes for region constraints
31+
32+
{{site.data.alerts.callout_info}}
33+
When specifying region constraints or lease preferences for nodes running on cloud providers, you must include the cloud provider prefix in the region name. The format is `{provider}-{region-name}`.
34+
{{site.data.alerts.end}}
35+
36+
For example:
37+
38+
Cloud Provider | Region Format | Example
39+
---------------|---------------|--------
40+
**AWS** | `aws-{region}` | `aws-us-east-1`, `aws-eu-central-1`
41+
**GCP** | `gcp-{region}` | `gcp-us-east1`, `gcp-asia-south1`
42+
**Azure** | `azure-{region}` | `azure-eastus`, `azure-westus2`
43+
44+
This applies when using `constraints` or `lease_preferences` in zone configurations. For instance:
45+
46+
{% include_cached copy-clipboard.html %}
47+
~~~ sql
48+
ALTER TABLE my_table CONFIGURE ZONE USING constraints = '[+region=gcp-us-east1]';
49+
~~~
50+
51+
{% include_cached copy-clipboard.html %}
52+
~~~ sql
53+
ALTER DATABASE my_db CONFIGURE ZONE USING constraints = '{"+region=aws-us-east-1": 2, "+region=aws-eu-central-1": 1}';
54+
~~~
55+
3056
## Examples
3157

3258
{% include {{ page.version.version }}/sql/movr-statements-geo-partitioned-replicas.md %}

‎src/current/v24.2/show-zone-configurations.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,32 @@ Parameter | Description
2727
`partition_name` | The name of the [partition]({% link {{ page.version.version }}/partitioning.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2828
`index_name` | The name of the [index]({% link {{ page.version.version }}/indexes.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2929

30+
## Cloud provider prefixes for region constraints
31+
32+
{{site.data.alerts.callout_info}}
33+
When specifying region constraints or lease preferences for nodes running on cloud providers, you must include the cloud provider prefix in the region name. The format is `{provider}-{region-name}`.
34+
{{site.data.alerts.end}}
35+
36+
For example:
37+
38+
Cloud Provider | Region Format | Example
39+
---------------|---------------|--------
40+
**AWS** | `aws-{region}` | `aws-us-east-1`, `aws-eu-central-1`
41+
**GCP** | `gcp-{region}` | `gcp-us-east1`, `gcp-asia-south1`
42+
**Azure** | `azure-{region}` | `azure-eastus`, `azure-westus2`
43+
44+
This applies when using `constraints` or `lease_preferences` in zone configurations. For instance:
45+
46+
{% include_cached copy-clipboard.html %}
47+
~~~ sql
48+
ALTER TABLE my_table CONFIGURE ZONE USING constraints = '[+region=gcp-us-east1]';
49+
~~~
50+
51+
{% include_cached copy-clipboard.html %}
52+
~~~ sql
53+
ALTER DATABASE my_db CONFIGURE ZONE USING constraints = '{"+region=aws-us-east-1": 2, "+region=aws-eu-central-1": 1}';
54+
~~~
55+
3056
## Examples
3157

3258
{% include {{ page.version.version }}/sql/movr-statements-geo-partitioned-replicas.md %}

‎src/current/v24.3/show-zone-configurations.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,32 @@ Parameter | Description
2727
`partition_name` | The name of the [partition]({% link {{ page.version.version }}/partitioning.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2828
`index_name` | The name of the [index]({% link {{ page.version.version }}/indexes.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2929

30+
## Cloud provider prefixes for region constraints
31+
32+
{{site.data.alerts.callout_info}}
33+
When specifying region constraints or lease preferences for nodes running on cloud providers, you must include the cloud provider prefix in the region name. The format is `{provider}-{region-name}`.
34+
{{site.data.alerts.end}}
35+
36+
For example:
37+
38+
Cloud Provider | Region Format | Example
39+
---------------|---------------|--------
40+
**AWS** | `aws-{region}` | `aws-us-east-1`, `aws-eu-central-1`
41+
**GCP** | `gcp-{region}` | `gcp-us-east1`, `gcp-asia-south1`
42+
**Azure** | `azure-{region}` | `azure-eastus`, `azure-westus2`
43+
44+
This applies when using `constraints` or `lease_preferences` in zone configurations. For instance:
45+
46+
{% include_cached copy-clipboard.html %}
47+
~~~ sql
48+
ALTER TABLE my_table CONFIGURE ZONE USING constraints = '[+region=gcp-us-east1]';
49+
~~~
50+
51+
{% include_cached copy-clipboard.html %}
52+
~~~ sql
53+
ALTER DATABASE my_db CONFIGURE ZONE USING constraints = '{"+region=aws-us-east-1": 2, "+region=aws-eu-central-1": 1}';
54+
~~~
55+
3056
## Examples
3157

3258
{% include {{ page.version.version }}/sql/movr-statements-geo-partitioned-replicas.md %}

‎src/current/v25.1/show-zone-configurations.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,32 @@ Parameter | Description
2727
`partition_name` | The name of the [partition]({% link {{ page.version.version }}/partitioning.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2828
`index_name` | The name of the [index]({% link {{ page.version.version }}/indexes.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2929

30+
## Cloud provider prefixes for region constraints
31+
32+
{{site.data.alerts.callout_info}}
33+
When specifying region constraints or lease preferences for nodes running on cloud providers, you must include the cloud provider prefix in the region name. The format is `{provider}-{region-name}`.
34+
{{site.data.alerts.end}}
35+
36+
For example:
37+
38+
Cloud Provider | Region Format | Example
39+
---------------|---------------|--------
40+
**AWS** | `aws-{region}` | `aws-us-east-1`, `aws-eu-central-1`
41+
**GCP** | `gcp-{region}` | `gcp-us-east1`, `gcp-asia-south1`
42+
**Azure** | `azure-{region}` | `azure-eastus`, `azure-westus2`
43+
44+
This applies when using `constraints` or `lease_preferences` in zone configurations. For instance:
45+
46+
{% include_cached copy-clipboard.html %}
47+
~~~ sql
48+
ALTER TABLE my_table CONFIGURE ZONE USING constraints = '[+region=gcp-us-east1]';
49+
~~~
50+
51+
{% include_cached copy-clipboard.html %}
52+
~~~ sql
53+
ALTER DATABASE my_db CONFIGURE ZONE USING constraints = '{"+region=aws-us-east-1": 2, "+region=aws-eu-central-1": 1}';
54+
~~~
55+
3056
## Examples
3157

3258
{% include {{ page.version.version }}/sql/movr-statements-geo-partitioned-replicas.md %}

‎src/current/v25.2/show-zone-configurations.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,32 @@ Parameter | Description
2727
`partition_name` | The name of the [partition]({% link {{ page.version.version }}/partitioning.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2828
`index_name` | The name of the [index]({% link {{ page.version.version }}/indexes.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2929

30+
## Cloud provider prefixes for region constraints
31+
32+
{{site.data.alerts.callout_info}}
33+
When specifying region constraints or lease preferences for nodes running on cloud providers, you must include the cloud provider prefix in the region name. The format is `{provider}-{region-name}`.
34+
{{site.data.alerts.end}}
35+
36+
For example:
37+
38+
Cloud Provider | Region Format | Example
39+
---------------|---------------|--------
40+
**AWS** | `aws-{region}` | `aws-us-east-1`, `aws-eu-central-1`
41+
**GCP** | `gcp-{region}` | `gcp-us-east1`, `gcp-asia-south1`
42+
**Azure** | `azure-{region}` | `azure-eastus`, `azure-westus2`
43+
44+
This applies when using `constraints` or `lease_preferences` in zone configurations. For instance:
45+
46+
{% include_cached copy-clipboard.html %}
47+
~~~ sql
48+
ALTER TABLE my_table CONFIGURE ZONE USING constraints = '[+region=gcp-us-east1]';
49+
~~~
50+
51+
{% include_cached copy-clipboard.html %}
52+
~~~ sql
53+
ALTER DATABASE my_db CONFIGURE ZONE USING constraints = '{"+region=aws-us-east-1": 2, "+region=aws-eu-central-1": 1}';
54+
~~~
55+
3056
## Examples
3157

3258
{% include {{ page.version.version }}/sql/movr-statements-geo-partitioned-replicas.md %}

‎src/current/v25.3/show-zone-configurations.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,32 @@ Parameter | Description
2727
`partition_name` | The name of the [partition]({% link {{ page.version.version }}/partitioning.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2828
`index_name` | The name of the [index]({% link {{ page.version.version }}/indexes.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2929

30+
## Cloud provider prefixes for region constraints
31+
32+
{{site.data.alerts.callout_info}}
33+
When specifying region constraints or lease preferences for nodes running on cloud providers, you must include the cloud provider prefix in the region name. The format is `{provider}-{region-name}`.
34+
{{site.data.alerts.end}}
35+
36+
For example:
37+
38+
Cloud Provider | Region Format | Example
39+
---------------|---------------|--------
40+
**AWS** | `aws-{region}` | `aws-us-east-1`, `aws-eu-central-1`
41+
**GCP** | `gcp-{region}` | `gcp-us-east1`, `gcp-asia-south1`
42+
**Azure** | `azure-{region}` | `azure-eastus`, `azure-westus2`
43+
44+
This applies when using `constraints` or `lease_preferences` in zone configurations. For instance:
45+
46+
{% include_cached copy-clipboard.html %}
47+
~~~ sql
48+
ALTER TABLE my_table CONFIGURE ZONE USING constraints = '[+region=gcp-us-east1]';
49+
~~~
50+
51+
{% include_cached copy-clipboard.html %}
52+
~~~ sql
53+
ALTER DATABASE my_db CONFIGURE ZONE USING constraints = '{"+region=aws-us-east-1": 2, "+region=aws-eu-central-1": 1}';
54+
~~~
55+
3056
## Examples
3157

3258
{% include {{ page.version.version }}/sql/movr-statements-geo-partitioned-replicas.md %}

‎src/current/v25.4/show-zone-configurations.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,32 @@ Parameter | Description
2727
`partition_name` | The name of the [partition]({% link {{ page.version.version }}/partitioning.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2828
`index_name` | The name of the [index]({% link {{ page.version.version }}/indexes.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2929

30+
## Cloud provider prefixes for region constraints
31+
32+
{{site.data.alerts.callout_info}}
33+
When specifying region constraints or lease preferences for nodes running on cloud providers, you must include the cloud provider prefix in the region name. The format is `{provider}-{region-name}`.
34+
{{site.data.alerts.end}}
35+
36+
For example:
37+
38+
Cloud Provider | Region Format | Example
39+
---------------|---------------|--------
40+
**AWS** | `aws-{region}` | `aws-us-east-1`, `aws-eu-central-1`
41+
**GCP** | `gcp-{region}` | `gcp-us-east1`, `gcp-asia-south1`
42+
**Azure** | `azure-{region}` | `azure-eastus`, `azure-westus2`
43+
44+
This applies when using `constraints` or `lease_preferences` in zone configurations. For instance:
45+
46+
{% include_cached copy-clipboard.html %}
47+
~~~ sql
48+
ALTER TABLE my_table CONFIGURE ZONE USING constraints = '[+region=gcp-us-east1]';
49+
~~~
50+
51+
{% include_cached copy-clipboard.html %}
52+
~~~ sql
53+
ALTER DATABASE my_db CONFIGURE ZONE USING constraints = '{"+region=aws-us-east-1": 2, "+region=aws-eu-central-1": 1}';
54+
~~~
55+
3056
## Examples
3157

3258
{% include {{ page.version.version }}/sql/movr-statements-geo-partitioned-replicas.md %}

‎src/current/v26.1/show-zone-configurations.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,32 @@ Parameter | Description
2727
`partition_name` | The name of the [partition]({% link {{ page.version.version }}/partitioning.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2828
`index_name` | The name of the [index]({% link {{ page.version.version }}/indexes.md %}) for which to show [replication zone configurations]({% link {{ page.version.version }}/configure-replication-zones.md %}).
2929

30+
## Cloud provider prefixes for region constraints
31+
32+
{{site.data.alerts.callout_info}}
33+
When specifying region constraints or lease preferences for nodes running on cloud providers, you must include the cloud provider prefix in the region name. The format is `{provider}-{region-name}`.
34+
{{site.data.alerts.end}}
35+
36+
For example:
37+
38+
Cloud Provider | Region Format | Example
39+
---------------|---------------|--------
40+
**AWS** | `aws-{region}` | `aws-us-east-1`, `aws-eu-central-1`
41+
**GCP** | `gcp-{region}` | `gcp-us-east1`, `gcp-asia-south1`
42+
**Azure** | `azure-{region}` | `azure-eastus`, `azure-westus2`
43+
44+
This applies when using `constraints` or `lease_preferences` in zone configurations. For instance:
45+
46+
{% include_cached copy-clipboard.html %}
47+
~~~ sql
48+
ALTER TABLE my_table CONFIGURE ZONE USING constraints = '[+region=gcp-us-east1]';
49+
~~~
50+
51+
{% include_cached copy-clipboard.html %}
52+
~~~ sql
53+
ALTER DATABASE my_db CONFIGURE ZONE USING constraints = '{"+region=aws-us-east-1": 2, "+region=aws-eu-central-1": 1}';
54+
~~~
55+
3056
## Examples
3157

3258
{% include {{ page.version.version }}/sql/movr-statements-geo-partitioned-replicas.md %}

0 commit comments

Comments
 (0)