O banco de dados Backup permite anexar instantaneamente uma tabela/um banco de dados a partir de backups no modo somente leitura.
O banco de dados Backup é compatível com backups incrementais e não incrementais.
CREATE DATABASE backup_database
ENGINE = Backup('database_name_inside_backup', 'backup_destination')
O destino do backup pode ser qualquer destino de backup válido, como Disk, S3, File.
Com o destino de backup Disk, a consulta para criar um banco de dados a partir do backup fica assim:
CREATE DATABASE backup_database
ENGINE = Backup('database_name_inside_backup', Disk('disk_name', 'backup_name'))
Parâmetros do engine
database_name_inside_backup — Nome do banco de dados no backup.
backup_destination — Destino do backup.
Vamos ver um exemplo com um destino de backup Disk. Primeiro, vamos configurar o disco de backups em storage.xml:
<storage_configuration>
<disks>
<backups>
<type>local</type>
<path>/home/ubuntu/ClickHouseWorkDir/backups/</path>
</backups>
</disks>
</storage_configuration>
<backups>
<allowed_disk>backups</allowed_disk>
<allowed_path>/home/ubuntu/ClickHouseWorkDir/backups/</allowed_path>
</backups>
Exemplo de uso. Vamos criar um banco de dados de teste, algumas tabelas, inserir alguns dados e, em seguida, criar um backup:
CREATE DATABASE test_database;
CREATE TABLE test_database.test_table_1 (id UInt64, value String) ENGINE=MergeTree ORDER BY id;
INSERT INTO test_database.test_table_1 VALUES (0, 'test_database.test_table_1');
CREATE TABLE test_database.test_table_2 (id UInt64, value String) ENGINE=MergeTree ORDER BY id;
INSERT INTO test_database.test_table_2 VALUES (0, 'test_database.test_table_2');
CREATE TABLE test_database.test_table_3 (id UInt64, value String) ENGINE=MergeTree ORDER BY id;
INSERT INTO test_database.test_table_3 VALUES (0, 'test_database.test_table_3');
BACKUP DATABASE test_database TO Disk('backups', 'test_database_backup');
Agora que temos o backup test_database_backup, vamos criar o banco de dados Backup:
CREATE DATABASE test_database_backup ENGINE = Backup('test_database', Disk('backups', 'test_database_backup'));
Agora podemos consultar qualquer tabela do banco de dados:
SELECT id, value FROM test_database_backup.test_table_1;
┌─id─┬─value──────────────────────┐
│ 0 │ test_database.test_table_1 │
└────┴────────────────────────────┘
SELECT id, value FROM test_database_backup.test_table_2;
┌─id─┬─value──────────────────────┐
│ 0 │ test_database.test_table_2 │
└────┴────────────────────────────┘
SELECT id, value FROM test_database_backup.test_table_3;
┌─id─┬─value──────────────────────┐
│ 0 │ test_database.test_table_3 │
└────┴────────────────────────────┘
Também é possível trabalhar com este banco de dados Backup como com qualquer banco de dados comum. Por exemplo, consultar as tabelas dele:
SELECT database, name FROM system.tables WHERE database = 'test_database_backup':
┌─database─────────────┬─name─────────┐
│ test_database_backup │ test_table_1 │
│ test_database_backup │ test_table_2 │
│ test_database_backup │ test_table_3 │
└──────────────────────┴──────────────┘
Última modificação em 10 de junho de 2026