ApsaraDB for ClickHouse:Utiliser les commandes BACKUP et RESTORE

-- Commands
BACKUP | RESTORE [ASYNC]

-- What to back up or restore
  TABLE [db.]table_name [AS [db.]table_name_in_backup]
    [PARTITION[S] partition_expr [,...]] |
  DICTIONARY [db.]dictionary_name [AS [db.]name_in_backup] |
  DATABASE database_name [AS database_name_in_backup]
    [EXCEPT TABLES ...] |
  TEMPORARY TABLE table_name [AS table_name_in_backup] |
  VIEW view_name [AS view_name_in_backup] |
  ALL [EXCEPT {TABLES|DATABASES}...] [,...]

-- Cluster scope (optional)
  [ON CLUSTER 'cluster_name']

-- Destination (BACKUP) or source (RESTORE)
  TO|FROM
    File('<path>/<filename>') |
    Disk('<disk_name>', '<path>/') |
    S3('<S3 endpoint>/<path>', '<Access Key ID>', '<Access Key Secret>')

-- Incremental backup base (optional)
  [SETTINGS base_backup =
    File('<path>/<filename>') |
    Disk(...) |
    S3('<S3 endpoint>/<path>', '<Access Key ID>', '<Access Key Secret>')]

Paramètres

Édition compatible avec la communauté

BACKUP TABLE default.data ON CLUSTER default
TO S3('https://<yourBucketName>.<yourEndpoint>/data/', '<yourAccessKeyID>', '<yourAccessKeySecret>')

Édition Enterprise

BACKUP TABLE default.data
TO S3('https://<yourBucketName>.<yourEndpoint>/data/data_1.zip', '<yourAccessKeyID>', '<yourAccessKeySecret>')

Édition compatible avec la communauté

-- Restore to a single node from a ZIP file
RESTORE TABLE default.data
FROM S3('https://<yourBucketName>.<yourEndpoint>/data/data_1.zip', '<yourAccessKeyID>', '<yourAccessKeySecret>')

-- Restore to all nodes from a directory
RESTORE TABLE default.data ON CLUSTER default
FROM S3('https://<yourBucketName>.<yourEndpoint>/data/', '<yourAccessKeyID>', '<yourAccessKeySecret>')

Édition Enterprise

RESTORE TABLE default.data
FROM S3('https://<yourBucketName>.<yourEndpoint>/data/data_1.zip', '<yourAccessKeyID>', '<yourAccessKeySecret>')

-- Step 1: Create a base (full) backup
BACKUP TABLE default.data ON CLUSTER default
TO S3('https://<yourBucketName>.<yourEndpoint>/base_backup/', '<yourAccessKeyID>', '<yourAccessKeySecret>')

-- Step 2: Create an incremental backup against the base
BACKUP TABLE default.data ON CLUSTER default
TO S3('https://<yourBucketName>.<yourEndpoint>/incremental_backup/', '<yourAccessKeyID>', '<yourAccessKeySecret>')
SETTINGS base_backup = S3('https://<yourBucketName>.<yourEndpoint>/base_backup/', '<yourAccessKeyID>', '<yourAccessKeySecret>')

-- Step 3: Restore from the incremental backup
RESTORE TABLE default.data ON CLUSTER default
FROM S3('https://<yourBucketName>.<yourEndpoint>/incremental_backup/', '<yourAccessKeyID>', '<yourAccessKeySecret>')

Exécuter les opérations de manière asynchrone

Ajoutez ASYNC pour éviter de maintenir une connexion ouverte pendant les opérations de longue durée. La commande retourne immédiatement et l'opération se poursuit en arrière-plan.

BACKUP TABLE default.data ON CLUSTER default
TO S3('https://<yourBucketName>.<yourEndpoint>/data/', '<yourAccessKeyID>', '<yourAccessKeySecret>')
ASYNC;

Vérifier la progression

Interrogez system.backups pour vérifier l'état :

SELECT * FROM system.backups;

Afficher les paramètres de performance

-- User-level parameters
SELECT * FROM system.settings WHERE name LIKE '%backup%' OR name LIKE '%restore%';

-- Server-level parameters
SELECT * FROM system.server_settings WHERE name LIKE '%backup%' OR name LIKE '%restore%';

Paramètres de sauvegarde

Paramètres de restauration

J'obtiens l'erreur « Not found backup engine S3 » — que faire ?

L'instance exécute une version qui ne prend pas en charge les sauvegardes S3. Effectuez une mise à niveau vers la version 23.8 ou ultérieure. Si vous utilisez un cluster autogéré, sauvegardez d'abord sur un disque local, puis téléchargez vers OSS.

J'obtiens l'erreur « Using archives with backups on clusters is disabled » — que faire ?

Les sauvegardes de clusters multi-nœuds ne prennent pas en charge les archives ZIP. Utilisez plutôt un chemin de dossier :

BACKUP TABLE default.data ON CLUSTER default
TO S3('https://<yourBucketName>.<yourEndpoint>/data/', '<yourAccessKeyID>', '<yourAccessKeySecret>')

La connexion a été interrompue après l'exécution de BACKUP — ma sauvegarde a-t-elle échoué ?

Non. La sauvegarde s'exécute en arrière-plan, indépendamment de l'état de la connexion. Vérifiez la progression avec :

SELECT * FROM system.backups;

Pour éviter complètement ce problème, ajoutez ASYNC à la commande :

BACKUP TABLE default.data ON CLUSTER default
TO S3('https://<yourBucketName>.<yourEndpoint>/data/', '<yourAccessKeyID>', '<yourAccessKeySecret>')
ASYNC;

Quelle est la vitesse des commandes BACKUP et RESTORE ?

La vitesse dépend de la ressource qui constitue le goulot d'étranglement : le processeur, le débit du disque, le débit du réseau ou la bande passante OSS.

• Pour ApsaraDB for ClickHouse, augmentez les spécifications du cluster afin d'améliorer le processeur, le débit du disque et le débit du réseau.

• Pour connaître les limites de bande passante OSS, consultez Limites et métriques de performance.

Comment sauvegarder ou restaurer les nœuds un par un ?

1. Interrogez les adresses IP des nœuds.

   SELECT * FROM system.clusters;

2. Connectez-vous directement au nœud cible à l'aide de clickhouse-client et désactivez le paramètre DDL de cluster obligatoire.

   Remarque

   Ce paramètre s'applique uniquement à ApsaraDB for ClickHouse. Ne l'utilisez pas sur des clusters ClickHouse autogérés.

   SET enforce_on_cluster_default_for_ddl = 0;

3. Exécutez la commande BACKUP.

   BACKUP TABLE default.data
   TO S3('https://<yourBucketName>.<yourEndpoint>/data/data_1.zip', '<yourAccessKeyID>', '<yourAccessKeySecret>')

4. Exécutez la commande RESTORE.

   RESTORE TABLE default.data
   FROM S3('https://<yourBucketName>.<yourEndpoint>/data/data_1.zip', '<yourAccessKeyID>', '<yourAccessKeySecret>')