diff --git a/docs/products/clickhouse/concepts/disaster-recovery.md b/docs/products/clickhouse/concepts/disaster-recovery.md index 8496cc15..950fbbca 100644 --- a/docs/products/clickhouse/concepts/disaster-recovery.md +++ b/docs/products/clickhouse/concepts/disaster-recovery.md @@ -28,7 +28,7 @@ Also see [cross-availability-zone data distribution](/docs/platform/concepts/ava ## Backup and restore -### Backups +### Service backup Backups of Aiven for ClickHouse services happen automatically on a daily basis. @@ -42,6 +42,9 @@ They cover the following: - Table content (`part files`) - Dictionaries +You can +[restore your service from a selected backup](/docs/products/clickhouse/howto/restore-backup). + :::note[Part files] With the ClickHouse's ReplicatedMergeTree table engine, each INSERT query results in creating a new file, so-called part, written only once @@ -52,16 +55,17 @@ only changed parts are backed up and files already available in the object storage are left out from the backup. ::: -### Recovery - -The restoration of a backup of an Aiven for ClickHouse service is -performed on a running ClickHouse server and proceeds as a regular -power-on of the service. The restoration happens only for powering up a -service after powering it down or forking a service. - For more information on backups in Aiven, see [Backups at Aiven](/docs/platform/concepts/service_backups). +### Service recovery + +Regardless of whether your Aiven for ClickHouse service is powered on or powered off, you +can create its copy and +[restore the data from a selected service backup](/docs/products/clickhouse/howto/restore-backup). +For this purpose, you create a fork from the original service. This spins up a new service +that hosts the data recovered from the selected backup. + ## Sharding Essentially, sharding is a technique of splitting database rows across diff --git a/docs/products/clickhouse/howto/restore-backup.md b/docs/products/clickhouse/howto/restore-backup.md new file mode 100644 index 00000000..78d78b04 --- /dev/null +++ b/docs/products/clickhouse/howto/restore-backup.md @@ -0,0 +1,24 @@ +--- +title: Fork and restore from Aiven for ClickHouse® backups +sidebar_label: Fork & restore from backups +--- + +import ConsoleLabel from "@site/src/components/ConsoleIcons"; + +Choose a service [backup](/docs/products/clickhouse/concepts/disaster-recovery#service-backup) to fork from and restore your Aiven for ClickHouse® service. + +1. Log in to the [Aiven Console](https://console.aiven.io) and go to your Aiven for + ClickHouse service. +1. Click in the sidebar. +1. Click **Fork & restore**. +1. In the **New database fork** window, select the following: + + - Backup to fork from + - Service name and a project + - Cloud provider and region + - Service plan and additional storage + +1. Click **Create fork**. + +Once the new fork service is running, you can set up your application's connection settings +to point to this new fork service. diff --git a/sidebars.ts b/sidebars.ts index 1da7b77b..ad99c32b 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -1227,6 +1227,7 @@ const sidebars: SidebarsConfig = { label: 'Manage service', items: [ 'products/clickhouse/howto/secure-service', + 'products/clickhouse/howto/restore-backup', 'products/clickhouse/howto/manage-users-roles', 'products/clickhouse/howto/manage-databases-tables', 'products/clickhouse/howto/query-databases',