From 3d445e4d0668d1dcbe3cb6e1a21b9c91fd5b66aa Mon Sep 17 00:00:00 2001 From: Gemma Shay Date: Thu, 21 Sep 2023 14:19:35 -0400 Subject: [PATCH 1/9] Multi-region Serverless GA --- src/current/_data/cloud_releases.csv | 1 + src/current/_includes/releases/cloud/2023-09-27.md | 5 +++++ .../cockroachcloud/connect-to-a-serverless-cluster.md | 2 +- .../cockroachcloud/create-a-serverless-cluster.md | 4 ++-- .../cockroachcloud/plan-your-cluster-serverless.md | 11 ++++++----- 5 files changed, 15 insertions(+), 8 deletions(-) create mode 100644 src/current/_includes/releases/cloud/2023-09-27.md diff --git a/src/current/_data/cloud_releases.csv b/src/current/_data/cloud_releases.csv index e2dadd98cac..f7082e83c30 100644 --- a/src/current/_data/cloud_releases.csv +++ b/src/current/_data/cloud_releases.csv @@ -64,3 +64,4 @@ date,sha 2023-09-06,null 2023-09-08,null 2023-09-11,null +2023-09-27,null diff --git a/src/current/_includes/releases/cloud/2023-09-27.md b/src/current/_includes/releases/cloud/2023-09-27.md new file mode 100644 index 00000000000..e8ea3cdde24 --- /dev/null +++ b/src/current/_includes/releases/cloud/2023-09-27.md @@ -0,0 +1,5 @@ +## September 27, 2023 + +

General changes

+ +- [Multi-region CockroachDB {{ site.data.products.serverless }}]({% link cockroachcloud/plan-your-cluster-serverless.md %}#multi-region-clusters) clusters are now [generally available]({% link /{{ site.current_cloud_version }}/cockroachdb-feature-availabilty.md %}), and cross-region network charges are now accounted for in RU consumption. \ No newline at end of file diff --git a/src/current/cockroachcloud/connect-to-a-serverless-cluster.md b/src/current/cockroachcloud/connect-to-a-serverless-cluster.md index d4cdc5060d4..29c31e3cd7e 100644 --- a/src/current/cockroachcloud/connect-to-a-serverless-cluster.md +++ b/src/current/cockroachcloud/connect-to-a-serverless-cluster.md @@ -33,7 +33,7 @@ AWS PrivateLink for CockroachDB {{ site.data.products.serverless }} is in **[lim Amazon Web Services (AWS) PrivateLink support allows customers to establish SQL access to their clusters entirely through private AWS infrastructure, without exposure to the public internet, affording enhanced security and performance. -AWS PrivateLink is available only for multiregion CockroachDB {{ site.data.products.serverless }} clusters deployed on AWS. +AWS PrivateLink is available only for multi-region CockroachDB {{ site.data.products.serverless }} clusters deployed on AWS. To configure PrivateLink, you create the AWS PrivateLink connection in your AWS account, then configure your cluster to allow connections from your private endpoint. For more information and detailed instructions, refer to[Network Authorization: AWS PrivateLink]({% link cockroachcloud/network-authorization.md %}#aws-privatelink). diff --git a/src/current/cockroachcloud/create-a-serverless-cluster.md b/src/current/cockroachcloud/create-a-serverless-cluster.md index 76b2fecbfd4..f232dd98828 100644 --- a/src/current/cockroachcloud/create-a-serverless-cluster.md +++ b/src/current/cockroachcloud/create-a-serverless-cluster.md @@ -40,12 +40,12 @@ For optimal performance, select the cloud provider and region nearest to where y To create a multi-region cluster, click **Add regions** and select additional regions. A cluster can have at most six regions. {{site.data.alerts.callout_info}} -**Multi-region for CockroachDB {{ site.data.products.serverless }} is in [preview](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/cockroachdb-feature-availability)** and subject to change. You cannot currently add or remove regions once a cluster has been created. To share feedback and/or issues, contact [Support](https://support.cockroachlabs.com/). +You cannot currently remove regions once a cluster has been created. {{site.data.alerts.end}} After creating a multi-region cluster deployed on AWS, you can optionally [set up AWS PrivateLink (Limited Access)]({% link cockroachcloud/network-authorization.md %}#aws-privatelink) so that incoming connections to your cluster from applications or services running in your AWS account flow over private AWS network infrastructure rather than the public internet. -Private connectivity is not available for {{ site.data.products.serverless-plan }} clusters on GCP. +Private connectivity is not available for {{ site.data.products.serverless }} clusters on GCP. ## Step 4. Set resource limits diff --git a/src/current/cockroachcloud/plan-your-cluster-serverless.md b/src/current/cockroachcloud/plan-your-cluster-serverless.md index 4a798946b1f..7c046ab6b4f 100644 --- a/src/current/cockroachcloud/plan-your-cluster-serverless.md +++ b/src/current/cockroachcloud/plan-your-cluster-serverless.md @@ -48,10 +48,6 @@ Each [Org Administrator]({% link cockroachcloud/authorization.md %}#org-administ ## Multi-region clusters -{{site.data.alerts.callout_info}} -{% include feature-phases/preview.md %} -{{site.data.alerts.end}} - You can [create a CockroachDB {{ site.data.products.serverless }} cluster]({% link cockroachcloud/create-a-serverless-cluster.md %}) with up to [six regions]({% link cockroachcloud/serverless-faqs.md %}#what-regions-are-available-for-cockroachdb-serverless-clusters). When you create a multi-region {{ site.data.products.serverless-plan }} cluster, you will be prompted to select a **Primary region** from which CockroachDB will optimize access to data. If you want to change your region configuration, [you can use the {{ site.data.products.cloud }} Console]({% link cockroachcloud/serverless-cluster-management.md %}#edit-regions), or you can [back up and restore]({% link cockroachcloud/use-managed-service-backups.md %}) your data into a new cluster with the desired configuration. {{site.data.alerts.callout_info}} @@ -66,7 +62,12 @@ Databases created in CockroachDB {{ site.data.products.serverless }} will automa Storage for a multi-region cluster is billed at the same rate as a single-region cluster. However, by default data is replicated three times in the primary region and once in each additional region, and each replica in the additional regions will accrue more storage costs. For example, a three-region cluster with data replicated five times will use 5/3 times the storage space of a single-region cluster where data is replicated three times. +Cross-region operations will use additional RUs because of the cost of cross-region networking. Cross-region networking costs depend on the source and destination regions. For read operations, the source region contains the replica and the destination region is the gateway region. For write operations, the source region is the gateway region and the destination region is the region containing the replica. There is a network charge for each replica to which the SQL statement writes. Refer to [Pricing](https://www.cockroachlabs.com/pricing) for a matrix of cross-region costs. + +Keep in mind the following key points when planning your multi-region CockroachDB {{ site.data.products.serverless }} application's architecture: + - Write-heavy applications may experience a significant increase in RU consumption because replicating writes across all regions consumes more resources. - Read-heavy applications may experience a smaller increase in RU consumption because the resources required to read from a single region of a multi-region cluster are comparable with a single-region cluster. +- Cross-region reads are an anti-pattern and may significantly increase RU consumption. +- Cross-region writes will also consume additional RUs, but should not significantly increase consumption. -During the multi-region {{ site.data.products.serverless-plan }} [preview](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/cockroachdb-feature-availability#feature-availability-phases), RU usage for queries that cross regions will not account for inter-region bandwidth. From 013898fa636174174ee38191e7dc277210abb41b Mon Sep 17 00:00:00 2001 From: Gemma Shay Date: Thu, 21 Sep 2023 14:44:52 -0400 Subject: [PATCH 2/9] callout --- src/current/cockroachcloud/create-a-serverless-cluster.md | 2 +- src/current/cockroachcloud/plan-your-cluster-serverless.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/current/cockroachcloud/create-a-serverless-cluster.md b/src/current/cockroachcloud/create-a-serverless-cluster.md index f232dd98828..e0ebd02d4ee 100644 --- a/src/current/cockroachcloud/create-a-serverless-cluster.md +++ b/src/current/cockroachcloud/create-a-serverless-cluster.md @@ -40,7 +40,7 @@ For optimal performance, select the cloud provider and region nearest to where y To create a multi-region cluster, click **Add regions** and select additional regions. A cluster can have at most six regions. {{site.data.alerts.callout_info}} -You cannot currently remove regions once a cluster has been created. +You cannot currently remove regions once they have been added. {{site.data.alerts.end}} After creating a multi-region cluster deployed on AWS, you can optionally [set up AWS PrivateLink (Limited Access)]({% link cockroachcloud/network-authorization.md %}#aws-privatelink) so that incoming connections to your cluster from applications or services running in your AWS account flow over private AWS network infrastructure rather than the public internet. diff --git a/src/current/cockroachcloud/plan-your-cluster-serverless.md b/src/current/cockroachcloud/plan-your-cluster-serverless.md index 7c046ab6b4f..24b331f3076 100644 --- a/src/current/cockroachcloud/plan-your-cluster-serverless.md +++ b/src/current/cockroachcloud/plan-your-cluster-serverless.md @@ -51,7 +51,7 @@ Each [Org Administrator]({% link cockroachcloud/authorization.md %}#org-administ You can [create a CockroachDB {{ site.data.products.serverless }} cluster]({% link cockroachcloud/create-a-serverless-cluster.md %}) with up to [six regions]({% link cockroachcloud/serverless-faqs.md %}#what-regions-are-available-for-cockroachdb-serverless-clusters). When you create a multi-region {{ site.data.products.serverless-plan }} cluster, you will be prompted to select a **Primary region** from which CockroachDB will optimize access to data. If you want to change your region configuration, [you can use the {{ site.data.products.cloud }} Console]({% link cockroachcloud/serverless-cluster-management.md %}#edit-regions), or you can [back up and restore]({% link cockroachcloud/use-managed-service-backups.md %}) your data into a new cluster with the desired configuration. {{site.data.alerts.callout_info}} -You cannot currently edit the region configuration for a single-region cluster once it has been created, and you cannot remove a region once it has been added. +You cannot currently remove regions once they have been added. {{site.data.alerts.end}} For optimal performance, deploy client applications in one of your cluster's configured regions. CockroachDB {{ site.data.products.serverless }} uses a geolocation routing policy to automatically route clients to the nearest region, even if that region is not one of your cluster's configured regions. This means that if you are running an application from a region that is not used by your cluster, connecting to that region may cause high network latency. This may be acceptable for development, but should be avoided for any production or performance-sensitive applications. Refer to the [CockroachDB {{ site.data.products.serverless }} FAQs]({% link cockroachcloud/serverless-faqs.md %}#how-do-i-get-the-sql-endpoint-for-a-specific-region-of-my-multi-region-cluster) for information on overriding the automatic routing policy. From 9fd25ef576c522e69cf3883a6fa822788c75476d Mon Sep 17 00:00:00 2001 From: Gemma Shay Date: Mon, 25 Sep 2023 17:16:31 -0400 Subject: [PATCH 3/9] link --- src/current/_includes/releases/cloud/2023-09-27.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/current/_includes/releases/cloud/2023-09-27.md b/src/current/_includes/releases/cloud/2023-09-27.md index e8ea3cdde24..4105e1aed0b 100644 --- a/src/current/_includes/releases/cloud/2023-09-27.md +++ b/src/current/_includes/releases/cloud/2023-09-27.md @@ -2,4 +2,4 @@

General changes

-- [Multi-region CockroachDB {{ site.data.products.serverless }}]({% link cockroachcloud/plan-your-cluster-serverless.md %}#multi-region-clusters) clusters are now [generally available]({% link /{{ site.current_cloud_version }}/cockroachdb-feature-availabilty.md %}), and cross-region network charges are now accounted for in RU consumption. \ No newline at end of file +- [Multi-region CockroachDB {{ site.data.products.serverless }}]({% link cockroachcloud/plan-your-cluster-serverless.md %}#multi-region-clusters) clusters are now [generally available](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/cockroachdb-feature-availability), and cross-region network charges are now accounted for in RU consumption. \ No newline at end of file From 84ed52478e8783a92c3bbc67002c465546a49b50 Mon Sep 17 00:00:00 2001 From: Gemma Shay Date: Tue, 26 Sep 2023 14:09:27 -0400 Subject: [PATCH 4/9] condensed limited access callout --- .../cockroachcloud/connect-to-a-serverless-cluster.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/src/current/cockroachcloud/connect-to-a-serverless-cluster.md b/src/current/cockroachcloud/connect-to-a-serverless-cluster.md index 29c31e3cd7e..1be84e83267 100644 --- a/src/current/cockroachcloud/connect-to-a-serverless-cluster.md +++ b/src/current/cockroachcloud/connect-to-a-serverless-cluster.md @@ -28,14 +28,12 @@ Removing or adding an authorized network on your CockroachDB {{ site.data.produc ### Establish AWS PrivateLink {{site.data.alerts.callout_info}} -AWS PrivateLink for CockroachDB {{ site.data.products.serverless }} is in **[limited access](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/cockroachdb-feature-availability)** and is only available to enrolled organizations. To enroll your organization, contact your Cockroach Labs account team. This feature is subject to change. +AWS PrivateLink for CockroachDB {{ site.data.products.serverless }} is in **[limited access](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/cockroachdb-feature-availability)** and is only available for multi-region CockroachDB {{ site.data.products.serverless }} clusters deployed on AWS. To enroll your organization, contact your Cockroach Labs account team. This feature is subject to change. {{site.data.alerts.end}} Amazon Web Services (AWS) PrivateLink support allows customers to establish SQL access to their clusters entirely through private AWS infrastructure, without exposure to the public internet, affording enhanced security and performance. -AWS PrivateLink is available only for multi-region CockroachDB {{ site.data.products.serverless }} clusters deployed on AWS. - -To configure PrivateLink, you create the AWS PrivateLink connection in your AWS account, then configure your cluster to allow connections from your private endpoint. For more information and detailed instructions, refer to[Network Authorization: AWS PrivateLink]({% link cockroachcloud/network-authorization.md %}#aws-privatelink). +To configure PrivateLink, you create the AWS PrivateLink connection in your AWS account, then configure your cluster to allow connections from your private endpoint. For more information and detailed instructions, refer to [Network Authorization: AWS PrivateLink]({% link cockroachcloud/network-authorization.md %}#aws-privatelink). AWS PrivateLink can be configured only after the cluster is created. For detailed instructions, refer to [Managing AWS PrivateLink for a cluster](aws-privatelink.html?filter-content=serverless). From 9362679a67e5a1fede1e59076921e6ca66c9b73f Mon Sep 17 00:00:00 2001 From: Gemma Shay Date: Tue, 26 Sep 2023 14:24:58 -0400 Subject: [PATCH 5/9] link to multi-region overview --- src/current/_includes/releases/cloud/2023-09-27.md | 2 +- src/current/cockroachcloud/plan-your-cluster-serverless.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/current/_includes/releases/cloud/2023-09-27.md b/src/current/_includes/releases/cloud/2023-09-27.md index 4105e1aed0b..9f4a51d0a5a 100644 --- a/src/current/_includes/releases/cloud/2023-09-27.md +++ b/src/current/_includes/releases/cloud/2023-09-27.md @@ -2,4 +2,4 @@

General changes

-- [Multi-region CockroachDB {{ site.data.products.serverless }}]({% link cockroachcloud/plan-your-cluster-serverless.md %}#multi-region-clusters) clusters are now [generally available](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/cockroachdb-feature-availability), and cross-region network charges are now accounted for in RU consumption. \ No newline at end of file +- [Multi-region CockroachDB {{ site.data.products.serverless }}]({% link cockroachcloud/plan-your-cluster-serverless.md %}#multi-region-clusters) clusters are now [generally available](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/cockroachdb-feature-availability), and [cross-region network charges](https://www.cockroachlabs.com/pricing) are now accounted for in RU consumption. \ No newline at end of file diff --git a/src/current/cockroachcloud/plan-your-cluster-serverless.md b/src/current/cockroachcloud/plan-your-cluster-serverless.md index 24b331f3076..c04c9668206 100644 --- a/src/current/cockroachcloud/plan-your-cluster-serverless.md +++ b/src/current/cockroachcloud/plan-your-cluster-serverless.md @@ -68,6 +68,6 @@ Keep in mind the following key points when planning your multi-region CockroachD - Write-heavy applications may experience a significant increase in RU consumption because replicating writes across all regions consumes more resources. - Read-heavy applications may experience a smaller increase in RU consumption because the resources required to read from a single region of a multi-region cluster are comparable with a single-region cluster. -- Cross-region reads are an anti-pattern and may significantly increase RU consumption. +- Cross-region reads are an anti-pattern and may significantly increase RU consumption. Features such as [global tables]({% link /{{ site.current_cloud_version }}/multiregion-overview.md %}), [regional by row tables]({% link /{{ site.current_cloud_version }}/multiregion-overview.md %}), and [follower reads]({% link /{{ site.current_cloud_version }}/multiregion-overview.md %}) make it possible to avoid most cross-region reads. - Cross-region writes will also consume additional RUs, but should not significantly increase consumption. From 5bd27fb5eda549efc369a989646aae742858c9c5 Mon Sep 17 00:00:00 2001 From: Gemma Shay Date: Fri, 29 Sep 2023 11:18:34 -0400 Subject: [PATCH 6/9] optimization addition --- src/current/cockroachcloud/plan-your-cluster-serverless.md | 2 +- src/current/cockroachcloud/serverless-resource-usage.md | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/src/current/cockroachcloud/plan-your-cluster-serverless.md b/src/current/cockroachcloud/plan-your-cluster-serverless.md index e2fcd037498..2d6cee754ed 100644 --- a/src/current/cockroachcloud/plan-your-cluster-serverless.md +++ b/src/current/cockroachcloud/plan-your-cluster-serverless.md @@ -62,7 +62,7 @@ Databases created in CockroachDB {{ site.data.products.serverless }} will automa Storage for a multi-region cluster is billed at the same rate as a single-region cluster. However, by default data is replicated three times in the primary region and once in each additional region, and each replica in the additional regions will accrue more storage costs. For example, a three-region cluster with data replicated five times will use 5/3 times the storage space of a single-region cluster where data is replicated three times. -Cross-region operations will use additional RUs because of the cost of cross-region networking. Cross-region networking costs depend on the source and destination regions. For read operations, the source region contains the replica and the destination region is the gateway region. For write operations, the source region is the gateway region and the destination region is the region containing the replica. There is a network charge for each replica to which the SQL statement writes. Refer to [Pricing](https://www.cockroachlabs.com/pricing) for a matrix of cross-region costs. +Cross-region operations will use additional RUs because of the cost of cross-region networking. Cross-region networking costs depend on the source and destination regions. For read operations, the source region contains the replica and the destination region is the gateway region. For write operations, the source region is the gateway region and the destination region contains the replica. There is a network charge for each replica to which an operation writes. Refer to [Pricing](https://www.cockroachlabs.com/pricing) for a matrix of cross-region costs. Keep in mind the following key points when planning your multi-region CockroachDB {{ site.data.products.serverless }} application's architecture: diff --git a/src/current/cockroachcloud/serverless-resource-usage.md b/src/current/cockroachcloud/serverless-resource-usage.md index d48812ad894..c70c57d9ca8 100644 --- a/src/current/cockroachcloud/serverless-resource-usage.md +++ b/src/current/cockroachcloud/serverless-resource-usage.md @@ -114,6 +114,7 @@ The following recommendations can help reduce the RU cost of a query by reducing - Use range `UPDATE` and `DELETE` statements to affect many rows in a single statement, rather than sending a separate statement per row. - Avoid returning columns that your application does not need. - Don't disable automatic statistics, as they are needed to power the [optimizer](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/cost-based-optimizer). +- For multi-region clusters, avoid cross-region reads by using features such as [global tables]({% link /{{ site.current_cloud_version }}/multiregion-overview.md %}), [regional by row tables]({% link /{{ site.current_cloud_version }}/multiregion-overview.md %}), and [follower reads]({% link /{{ site.current_cloud_version }}/multiregion-overview.md %}) where possible. ### Example Request Unit calculation From cb27cc7d0cd61243c0d4ae5ccabb09da7c14d43c Mon Sep 17 00:00:00 2001 From: Gemma Shay Date: Fri, 29 Sep 2023 11:23:28 -0400 Subject: [PATCH 7/9] crdb links --- src/current/cockroachcloud/plan-your-cluster-serverless.md | 2 +- src/current/cockroachcloud/serverless-resource-usage.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/current/cockroachcloud/plan-your-cluster-serverless.md b/src/current/cockroachcloud/plan-your-cluster-serverless.md index 2d6cee754ed..923cefd6711 100644 --- a/src/current/cockroachcloud/plan-your-cluster-serverless.md +++ b/src/current/cockroachcloud/plan-your-cluster-serverless.md @@ -68,6 +68,6 @@ Keep in mind the following key points when planning your multi-region CockroachD - Write-heavy applications may experience a significant increase in RU consumption because replicating writes across all regions consumes more resources. - Read-heavy applications may experience a smaller increase in RU consumption because the resources required to read from a single region of a multi-region cluster are comparable with a single-region cluster. -- Cross-region reads are an anti-pattern and may significantly increase RU consumption. Features such as [global tables]({% link /{{ site.current_cloud_version }}/multiregion-overview.md %}), [regional by row tables]({% link /{{ site.current_cloud_version }}/multiregion-overview.md %}), and [follower reads]({% link /{{ site.current_cloud_version }}/multiregion-overview.md %}) make it possible to avoid most cross-region reads. +- Cross-region reads are an anti-pattern and may significantly increase RU consumption. Features such as [global tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/global-tables.md %}), [regional by row tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/regional-tables.md %}), and [follower reads](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/follower-reads.md %}) make it possible to avoid most cross-region reads. - Cross-region writes will also consume additional RUs, but should not significantly increase consumption. diff --git a/src/current/cockroachcloud/serverless-resource-usage.md b/src/current/cockroachcloud/serverless-resource-usage.md index c70c57d9ca8..c1baa5be40e 100644 --- a/src/current/cockroachcloud/serverless-resource-usage.md +++ b/src/current/cockroachcloud/serverless-resource-usage.md @@ -114,7 +114,7 @@ The following recommendations can help reduce the RU cost of a query by reducing - Use range `UPDATE` and `DELETE` statements to affect many rows in a single statement, rather than sending a separate statement per row. - Avoid returning columns that your application does not need. - Don't disable automatic statistics, as they are needed to power the [optimizer](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/cost-based-optimizer). -- For multi-region clusters, avoid cross-region reads by using features such as [global tables]({% link /{{ site.current_cloud_version }}/multiregion-overview.md %}), [regional by row tables]({% link /{{ site.current_cloud_version }}/multiregion-overview.md %}), and [follower reads]({% link /{{ site.current_cloud_version }}/multiregion-overview.md %}) where possible. +- For multi-region clusters, avoid cross-region reads by using features such as [global tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/global-tables.md %}), [regional by row tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/regional-tables.md %}), and [follower reads](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/follower-reads.md %}) where possible. ### Example Request Unit calculation From 8f1519fd96f43fb89ea31cc9eb24d9294a825105 Mon Sep 17 00:00:00 2001 From: Gemma Shay Date: Fri, 29 Sep 2023 11:35:23 -0400 Subject: [PATCH 8/9] typo --- src/current/cockroachcloud/plan-your-cluster-serverless.md | 2 +- src/current/cockroachcloud/serverless-resource-usage.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/current/cockroachcloud/plan-your-cluster-serverless.md b/src/current/cockroachcloud/plan-your-cluster-serverless.md index 923cefd6711..0f672a8ff94 100644 --- a/src/current/cockroachcloud/plan-your-cluster-serverless.md +++ b/src/current/cockroachcloud/plan-your-cluster-serverless.md @@ -68,6 +68,6 @@ Keep in mind the following key points when planning your multi-region CockroachD - Write-heavy applications may experience a significant increase in RU consumption because replicating writes across all regions consumes more resources. - Read-heavy applications may experience a smaller increase in RU consumption because the resources required to read from a single region of a multi-region cluster are comparable with a single-region cluster. -- Cross-region reads are an anti-pattern and may significantly increase RU consumption. Features such as [global tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/global-tables.md %}), [regional by row tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/regional-tables.md %}), and [follower reads](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/follower-reads.md %}) make it possible to avoid most cross-region reads. +- Cross-region reads are an anti-pattern and may significantly increase RU consumption. Features such as [global tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/global-tables.md), [regional by row tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/regional-tables.md), and [follower reads](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/follower-reads.md) make it possible to avoid most cross-region reads. - Cross-region writes will also consume additional RUs, but should not significantly increase consumption. diff --git a/src/current/cockroachcloud/serverless-resource-usage.md b/src/current/cockroachcloud/serverless-resource-usage.md index c1baa5be40e..a90f6a8953c 100644 --- a/src/current/cockroachcloud/serverless-resource-usage.md +++ b/src/current/cockroachcloud/serverless-resource-usage.md @@ -114,7 +114,7 @@ The following recommendations can help reduce the RU cost of a query by reducing - Use range `UPDATE` and `DELETE` statements to affect many rows in a single statement, rather than sending a separate statement per row. - Avoid returning columns that your application does not need. - Don't disable automatic statistics, as they are needed to power the [optimizer](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/cost-based-optimizer). -- For multi-region clusters, avoid cross-region reads by using features such as [global tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/global-tables.md %}), [regional by row tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/regional-tables.md %}), and [follower reads](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/follower-reads.md %}) where possible. +- For multi-region clusters, avoid cross-region reads by using features such as [global tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/global-tables.md), [regional by row tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/regional-tables.md), and [follower reads](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/follower-reads.md) where possible. ### Example Request Unit calculation From 8ef393ddb377ee1a24af57bac39410bb5e0508cd Mon Sep 17 00:00:00 2001 From: Gemma Shay Date: Fri, 29 Sep 2023 14:49:43 -0400 Subject: [PATCH 9/9] review --- src/current/cockroachcloud/plan-your-cluster-serverless.md | 4 ++-- src/current/cockroachcloud/serverless-resource-usage.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/current/cockroachcloud/plan-your-cluster-serverless.md b/src/current/cockroachcloud/plan-your-cluster-serverless.md index 0f672a8ff94..6d9232f17c6 100644 --- a/src/current/cockroachcloud/plan-your-cluster-serverless.md +++ b/src/current/cockroachcloud/plan-your-cluster-serverless.md @@ -62,12 +62,12 @@ Databases created in CockroachDB {{ site.data.products.serverless }} will automa Storage for a multi-region cluster is billed at the same rate as a single-region cluster. However, by default data is replicated three times in the primary region and once in each additional region, and each replica in the additional regions will accrue more storage costs. For example, a three-region cluster with data replicated five times will use 5/3 times the storage space of a single-region cluster where data is replicated three times. -Cross-region operations will use additional RUs because of the cost of cross-region networking. Cross-region networking costs depend on the source and destination regions. For read operations, the source region contains the replica and the destination region is the gateway region. For write operations, the source region is the gateway region and the destination region contains the replica. There is a network charge for each replica to which an operation writes. Refer to [Pricing](https://www.cockroachlabs.com/pricing) for a matrix of cross-region costs. +Cross-region operations consume RUs for cross-region networking. Cross-region networking costs depend on the source and destination regions. For read operations, the source region contains the replica and the destination region is the gateway region. For write operations, the source region is the gateway region and the destination region contains the replica. There is a network charge for each replica to which an operation writes. Refer to [Pricing](https://www.cockroachlabs.com/pricing) for a matrix of cross-region costs. Keep in mind the following key points when planning your multi-region CockroachDB {{ site.data.products.serverless }} application's architecture: - Write-heavy applications may experience a significant increase in RU consumption because replicating writes across all regions consumes more resources. - Read-heavy applications may experience a smaller increase in RU consumption because the resources required to read from a single region of a multi-region cluster are comparable with a single-region cluster. -- Cross-region reads are an anti-pattern and may significantly increase RU consumption. Features such as [global tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/global-tables.md), [regional by row tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/regional-tables.md), and [follower reads](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/follower-reads.md) make it possible to avoid most cross-region reads. +- Cross-region reads are an anti-pattern and may significantly increase RU consumption. Features such as [global tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/global-tables.md), [regional by row tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/regional-tables.md), and [follower reads](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/follower-reads.md) help avoid most cross-region reads. - Cross-region writes will also consume additional RUs, but should not significantly increase consumption. diff --git a/src/current/cockroachcloud/serverless-resource-usage.md b/src/current/cockroachcloud/serverless-resource-usage.md index a90f6a8953c..6a6c8c5f38f 100644 --- a/src/current/cockroachcloud/serverless-resource-usage.md +++ b/src/current/cockroachcloud/serverless-resource-usage.md @@ -114,7 +114,7 @@ The following recommendations can help reduce the RU cost of a query by reducing - Use range `UPDATE` and `DELETE` statements to affect many rows in a single statement, rather than sending a separate statement per row. - Avoid returning columns that your application does not need. - Don't disable automatic statistics, as they are needed to power the [optimizer](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/cost-based-optimizer). -- For multi-region clusters, avoid cross-region reads by using features such as [global tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/global-tables.md), [regional by row tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/regional-tables.md), and [follower reads](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/follower-reads.md) where possible. +- For [multi-region clusters]({% link cockroachcloud/plan-your-cluster-serverless.md %}#multi-region-clusters), avoid cross-region reads by using features such as [global tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/global-tables.md), [regional by row tables](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/regional-tables.md), and [follower reads](https://www.cockroachlabs.com/docs/{{ site.current_cloud_version }}/follower-reads.md) where possible. ### Example Request Unit calculation