diff --git a/src/current/_includes/v22.2/backups/locality-aware-access.md b/src/current/_includes/v22.2/backups/locality-aware-access.md new file mode 100644 index 00000000000..3d3885de4ac --- /dev/null +++ b/src/current/_includes/v22.2/backups/locality-aware-access.md @@ -0,0 +1 @@ +A successful locality-aware backup job requires that each node in the cluster has access to each storage location. This is because any node in the cluster can claim the job and become the [_coordinator_ ](backup-architecture.html#job-creation-phase) node. \ No newline at end of file diff --git a/src/current/_includes/v22.2/backups/serverless-locality-aware.md b/src/current/_includes/v22.2/backups/serverless-locality-aware.md new file mode 100644 index 00000000000..a5661dc1806 --- /dev/null +++ b/src/current/_includes/v22.2/backups/serverless-locality-aware.md @@ -0,0 +1 @@ +CockroachDB {{ site.data.products.serverless }} clusters operate with a [different architecture](https://www.cockroachlabs.com/docs/cockroachcloud/architecture#cockroachdb-serverless) compared to CockroachDB {{ site.data.products.core }} and CockroachDB {{ site.data.products.dedicated }} clusters. These architectural differences have implications for how locality-aware backups can run. Serverless clusters will scale resources depending on whether they are actively in use, which means that it is less likely to have a SQL pod available in every locality. As a result, Serverless clusters are more likely to have ranges that do not match with any of the cluster's localities, which can lead to more ranges backed up to a storage bucket in a different locality. You should consider this as you plan a backup strategy that must comply with [data domiciling](data-domiciling.html) requirements. \ No newline at end of file diff --git a/src/current/_includes/v23.1/backups/serverless-locality-aware.md b/src/current/_includes/v23.1/backups/serverless-locality-aware.md new file mode 100644 index 00000000000..25b22f1f00c --- /dev/null +++ b/src/current/_includes/v23.1/backups/serverless-locality-aware.md @@ -0,0 +1 @@ +CockroachDB {{ site.data.products.serverless }} clusters operate with a [different architecture]({% link cockroachcloud/architecture.md %}#cockroachdb-serverless) compared to CockroachDB {{ site.data.products.core }} and CockroachDB {{ site.data.products.dedicated }} clusters. These architectural differences have implications for how locality-aware backups can run. Serverless clusters will scale resources depending on whether they are actively in use, which means that it is less likely to have a SQL pod available in every locality. As a result, Serverless clusters are more likely to have ranges that do not match with any of the cluster's localities, which can lead to more ranges backed up to a storage bucket in a different locality. You should consider this as you plan a backup strategy that must comply with [data domiciling]({% link v23.1/data-domiciling.md %}) requirements. \ No newline at end of file diff --git a/src/current/_includes/v23.2/backups/serverless-locality-aware.md b/src/current/_includes/v23.2/backups/serverless-locality-aware.md new file mode 100644 index 00000000000..e5da195923a --- /dev/null +++ b/src/current/_includes/v23.2/backups/serverless-locality-aware.md @@ -0,0 +1 @@ +CockroachDB {{ site.data.products.serverless }} clusters operate with a [different architecture]({% link cockroachcloud/architecture.md %}#cockroachdb-serverless) compared to CockroachDB {{ site.data.products.core }} and CockroachDB {{ site.data.products.dedicated }} clusters. These architectural differences have implications for how locality-aware backups can run. Serverless clusters will scale resources depending on whether they are actively in use, which means that it is less likely to have a SQL pod available in every locality. As a result, Serverless clusters are more likely to have ranges that do not match with any of the cluster's localities, which can lead to more ranges backed up to a storage bucket in a different locality. You should consider this as you plan a backup strategy that must comply with [data domiciling]({% link v23.2/data-domiciling.md %}) requirements. \ No newline at end of file diff --git a/src/current/cockroachcloud/serverless-unsupported-features.md b/src/current/cockroachcloud/serverless-unsupported-features.md index 80f53df4d35..7d0e3e8f4f1 100644 --- a/src/current/cockroachcloud/serverless-unsupported-features.md +++ b/src/current/cockroachcloud/serverless-unsupported-features.md @@ -15,11 +15,15 @@ You can't configure [alerts on changefeeds](https://www.cockroachlabs.com/docs/{ ## Backups -CockroachDB {{ site.data.products.serverless }} only support automated full backups. Automated [incremental](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/take-full-and-incremental-backups) and [revision history](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/take-backups-with-revision-history-and-restore-from-a-point-in-time) backups are not supported. However, [user managed incremental and revision history backups]({% link cockroachcloud/take-and-restore-customer-owned-backups.md %}#back-up-data) using user provided storage locations are supported. +CockroachDB {{ site.data.products.serverless }} clusters only support automated full backups. Automated [incremental](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/take-full-and-incremental-backups) and [revision history](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/take-backups-with-revision-history-and-restore-from-a-point-in-time) backups are not supported. However, you can take manual [incremental and revision history backups]({% link cockroachcloud/take-and-restore-customer-owned-backups.md %}#back-up-data) to your own [cloud storage location](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/use-cloud-storage). -Automated database and table level backups are not supported in CockroachDB {{ site.data.products.serverless }}. However, [user managed database and table level backups]({% link cockroachcloud/take-and-restore-customer-owned-backups.md %}#back-up-data) using user provided storage locations are supported. +Automated database and table level backups are not supported in CockroachDB {{ site.data.products.serverless }}. However, you can take manual [database and table level backups]({% link cockroachcloud/take-and-restore-customer-owned-backups.md %}#back-up-data) to your own [cloud storage location](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/use-cloud-storage). -Both CockroachDB {{ site.data.products.serverless }} and CockroachDB {{ site.data.products.dedicated }} clusters do not support automated [locality-aware backups](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/take-and-restore-locality-aware-backups). However, user managed locality-aware backups using user provided storage locations are supported in CockroachDB {{ site.data.products.serverless }}, CockroachDB {{ site.data.products.dedicated }}, and CockroachDB {{ site.data.products.core }} clusters. That is, you need to configure and manage your own locality-aware backups. +Both CockroachDB {{ site.data.products.serverless }} and CockroachDB {{ site.data.products.dedicated }} clusters do not support automated [locality-aware backups](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/take-and-restore-locality-aware-backups). However, you can take manual locality-aware backups to your own [cloud storage location](https://www.cockroachlabs.com/docs/{{site.current_cloud_version}}/use-cloud-storage). + +{{site.data.alerts.callout_info}} +{% include v23.2/backups/serverless-locality-aware.md %} +{{site.data.alerts.end}} ## Adding and removing regions diff --git a/src/current/cockroachcloud/use-managed-service-backups.md b/src/current/cockroachcloud/use-managed-service-backups.md index 4509a354d74..aa4fd316825 100644 --- a/src/current/cockroachcloud/use-managed-service-backups.md +++ b/src/current/cockroachcloud/use-managed-service-backups.md @@ -22,6 +22,7 @@ Cockroach Labs runs [full cluster backups](https://www.cockroachlabs.com/docs/{{ - By default, full backups are retained for 30 days. However, if you delete the backup schedule manually you will not be able to restore from these backups. - Once a cluster is deleted, Cockroach Labs retains the full backups for 30 days and incremental backups for 7 days. +- Backups are stored in the same region that a [single-region cluster]({% link cockroachcloud/plan-your-cluster.md %}#cluster-configuration) is running in, or the primary region of a [multi-region cluster](plan-your-cluster.html#multi-region-clusters). Every backup will be stored entirely in a single region, which is chosen at random from the list of cluster regions at the time of cluster creation. This region will be used indefinitely. @@ -30,7 +31,7 @@ Cockroach Labs runs [full cluster backups](https://www.cockroachlabs.com/docs/{{ - By default, full backups are retained for 30 days, while incremental backups are retained for 7 days. However, if you delete the backup schedule manually or enable [CMEK]({% link cockroachcloud/cmek.md %}) on the cluster, this will affect the availability of managed backups. Refer to the [CockroachDB Cloud FAQs]({% link cockroachcloud/frequently-asked-questions.md %}#who-is-responsible-for-backup) for more detail. - Once a cluster is deleted, Cockroach Labs retains the full backups for 30 days and incremental backups for 7 days. -- Backups are stored in the same region that a [single-region cluster]({% link cockroachcloud/plan-your-cluster.md %}#cluster-configuration) is running in or the primary region of a [multi-region cluster](plan-your-cluster.html#multi-region-clusters). +- Backups are stored in the same region that a [single-region cluster]({% link cockroachcloud/plan-your-cluster.md %}#cluster-configuration) is running in, or the primary region of a [multi-region cluster](plan-your-cluster.html#multi-region-clusters). Every backup will be stored entirely in a single region, which is chosen at random from the list of cluster regions at the time of cluster creation. This region will be used indefinitely. {{site.data.alerts.callout_info}} You cannot restore a backup of a multi-region database into a single-region database. diff --git a/src/current/v22.2/backup-and-restore-overview.md b/src/current/v22.2/backup-and-restore-overview.md index 7fae953edc9..773764b6688 100644 --- a/src/current/v22.2/backup-and-restore-overview.md +++ b/src/current/v22.2/backup-and-restore-overview.md @@ -18,13 +18,13 @@ For an explanation of how a backup works, see [Backup Architecture](backup-archi ## CockroachDB backup types -{% include cockroachcloud/backup-types.md %} +{% include cockroachcloud/backup-types.md %} ## Backup and restore product support This table outlines the level of product support for backup and restore features in CockroachDB. See each of the pages linked in the table for usage examples: -Backup / Restore | Description | Product Support +Backup / Restore | Description | Product Support ------------------+--------------+----------------- [Full backup](take-full-and-incremental-backups.html) | An un-replicated copy of your cluster, database, or table's data. A full backup is the base for any further backups. |