diff --git a/src/current/_data/cloud_releases.csv b/src/current/_data/cloud_releases.csv index 9fb2a3dd2da..e4ccebc0522 100644 --- a/src/current/_data/cloud_releases.csv +++ b/src/current/_data/cloud_releases.csv @@ -66,3 +66,4 @@ date,sha 2023-09-11,null 2023-09-22,null 2023-09-27,null +2023-09-29,null diff --git a/src/current/_includes/releases/cloud/2023-09-27.md b/src/current/_includes/releases/cloud/2023-09-27.md index 1ee059d0da9..a0579af6e24 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

-- The {{ site.data.products.cloud }} Console's [SQL Shell]({% link cockroachcloud/sql-shell.md %}) is now available in [preview](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/cockroachdb-feature-availability) to all CockroachDB {{ site.data.products.cloud }} users with the [Cluster Administrator role]({% link cockroachcloud/managing-access.md %}). \ No newline at end of file +- The {{ site.data.products.cloud }} Console's [SQL Shell]({% link cockroachcloud/sql-shell.md %}) is now available in [preview](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/cockroachdb-feature-availability) to all CockroachDB {{ site.data.products.cloud }} users with the [Cluster Administrator role]({% link cockroachcloud/managing-access.md %}). diff --git a/src/current/_includes/releases/cloud/2023-09-29.md b/src/current/_includes/releases/cloud/2023-09-29.md new file mode 100644 index 00000000000..138e02071c2 --- /dev/null +++ b/src/current/_includes/releases/cloud/2023-09-29.md @@ -0,0 +1,5 @@ +## September 29, 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](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/connect-to-a-serverless-cluster.md b/src/current/cockroachcloud/connect-to-a-serverless-cluster.md index d4cdc5060d4..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 multiregion 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). diff --git a/src/current/cockroachcloud/create-a-serverless-cluster.md b/src/current/cockroachcloud/create-a-serverless-cluster.md index 6c97d11cac6..64d470662e0 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 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. -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 e7b98e226da..6d9232f17c6 100644 --- a/src/current/cockroachcloud/plan-your-cluster-serverless.md +++ b/src/current/cockroachcloud/plan-your-cluster-serverless.md @@ -48,14 +48,10 @@ 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}} -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. @@ -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 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) help avoid most cross-region reads. +- 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. diff --git a/src/current/cockroachcloud/serverless-resource-usage.md b/src/current/cockroachcloud/serverless-resource-usage.md index d48812ad894..6a6c8c5f38f 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]({% 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