Merge pull request #3945 from ClickHouse/aashishkohli-patch-4

Update export-backups-to-own-cloud-account.md

Author: Blargian

docs/cloud/manage/backups/export-backups-to-own-cloud-account.md

@@ -61,18 +61,19 @@ You will need the following details to export/restore backups to your own CSP st
 2. Access HMAC key and HMAC secret.
 
 <hr/>
-# Backup / Restore
+
+# Backup / restore {#backup-restoer}
 
 :::note:::
 1. For restoring the backup from your own bucket into a new service, you will need to update the trust policy of your backups storage bucket to allow access from the new service.
 2. The Backup / Restore commands need to be run from the database command line. For restore to a new service, you will first need to create the service and then run the command.   
 :::
 
-## Backup / Restore to AWS S3 Bucket {#backup--restore-to-aws-s3-bucket}
+## Backup / restore to AWS S3 bucket {#backup--restore-to-aws-s3-bucket}
 
-### Take a DB Backup {#take-a-db-backup}
+### Take a DB backup {#take-a-db-backup}
 
-**Full Backup**
+**Full backup**
 
 ```sql
 BACKUP DATABASE test_backups 
@@ -86,11 +87,11 @@ You will need to use a different UUID for each new backup in this subdirectory,
 For example, if you are taking daily backups, you will need to use a new UUID each day.  
 :::
 
-**Incremental Backup**
+**Incremental backup**
 
 ```sql
 BACKUP DATABASE test_backups 
-TO S3('https://testchbackups.s3.amazonaws.com/backups/<uuid>', '<key id>', '<key secret>') 
+TO S3('https://testchbackups.s3.amazonaws.com/backups/<uuid>/my_incremental', '<key id>', '<key secret>') 
 SETTINGS base_backup = S3('https://testchbackups.s3.amazonaws.com/backups/<base-backup-uuid>', '<key id>', '<key secret>')
 ```
 
@@ -104,11 +105,11 @@ FROM S3('https://testchbackups.s3.amazonaws.com/backups/<uuid>', '<key id>', '<k
 
 See: [Configuring BACKUP/RESTORE to use an S3 Endpoint](/operations/backup#configuring-backuprestore-to-use-an-s3-endpoint) for more details.
 
-## Backup / Restore to Azure Blob Storage {#backup--restore-to-azure-blob-storage}
+## Backup / restore to Azure Blob Storage {#backup--restore-to-azure-blob-storage}
 
-### Take a DB Backup {#take-a-db-backup-1}
+### Take a DB backup {#take-a-db-backup-1}
 
-**Full Backup**
+**Full backup**
 
 ```sql
 BACKUP DATABASE test_backups 
@@ -117,7 +118,7 @@ TO AzureBlobStorage('<AzureBlobStorage endpoint connection string>', '<container
 
 Where `uuid` is a unique identifier, used to differentiate a set of backups.
 
-**Incremental Backup**
+**Incremental backup**
 
 ```sql
 BACKUP DATABASE test_backups 
@@ -135,19 +136,19 @@ FROM AzureBlobStorage('<AzureBlobStorage endpoint connection string>', '<contain
 
 See: [Configuring BACKUP/RESTORE to use an S3 Endpoint](/operations/backup#configuring-backuprestore-to-use-an-azureblobstorage-endpoint) for more details.
 
-## Backup / Restore to Google Cloud Storage (GCS) {#backup--restore-to-google-cloud-storage-gcs}
+## Backup / restore to Google Cloud Storage (GCS) {#backup--restore-to-google-cloud-storage-gcs}
 
-### Take a DB Backup {#take-a-db-backup-2}
+### Take a DB backup {#take-a-db-backup-2}
 
-**Full Backup**
+**Full backup**
 
 ```sql
 BACKUP DATABASE test_backups 
 TO S3('https://storage.googleapis.com/<bucket>/<uuid>', <hmac-key>', <hmac-secret>)
 ```
 Where `uuid` is a unique identifier, used to differentiate a set of backups.
 
-**Incremental Backup**
+**Incremental backup**
 
 ```sql
 BACKUP DATABASE test_backups 
@@ -162,3 +163,43 @@ RESTORE DATABASE test_backups
 AS test_backups_restored_gcs 
 FROM S3('https://storage.googleapis.com/test_gcs_backups/<uuid>', 'key', 'secret')
 ```
+
+# Granular backups {#granular-backups}
+
+The `BACKUP` command also works with granular backups of specific tables. Example AWS commands for backing up a specific table are listed below. GCP and Azure commands are similar to the ones explained above, except that they need to be customized to backup specific tables.
+
+### Take a granular backup {#take-a-granular-backup}
+
+**Full Backup**
+```sql
+BACKUP TABLE data TO S3('https://testchbackups.s3.amazonaws.com/backups/<uuid>', '<key id>', '<key
+secret>')
+```
+
+**Incremental backup**
+
+```sql
+BACKUP TABLE data TO S3('https://testchbackups.s3.amazonaws.com/backups/my_incremental/', '<key id>', '<key
+secret>') SETTINGS base_backup = S3('https://testchbackups.s3.amazonaws.com/backups/<base-backup-uuid>', '<key id>', '<key
+secret>')
+```
+
+### Restore from a granular backup {#restore-from-granular-backup}
+```sql
+RESTORE TABLE data AS data3 FROM
+S3('https://testchbackups.s3.amazonaws.com/backups/my_incremental', '<key id>', '<key secret>')
+```
+
+### Backup and restore all service data {#backup-and-restore-all-service-data}
+
+**Backup**
+
+```sql
+BACKUP TABLE system.settings_profiles, TABLE system.row_policies, TABLE system.quotas, TABLE system.functions, ALL EXCEPT DATABASES INFORMATION_SCHEMA,information_schema,system TO S3('https://testchbackups.s3.amazonaws.com/backups/', '<key id>', '<key secret>')
+```
+
+**Restore**
+
+```sql
+RESTORE ALL FROM S3('https://testchbackups.s3.amazonaws.com/backups/', '<key id>', '<key secret>')
+```

styles/ClickHouse/Headings.yml

@@ -63,6 +63,8 @@ exceptions:
   - Docker Compose
   - Kafka
   - Google Cloud Run
+  - Google Cloud Storage
+  - GCS
   - NPM
   - OTel
-  - SQL
+  - SQL