Descrição
Contém uma lista de todas as operaçõesBACKUP ou RESTORE, com seus estados atuais e outras propriedades. Observe que essa tabela não é persistente e mostra apenas as operações executadas após a última reinicialização do servidor.
Atomicidade da restauração
RESTORE não é transacional e não faz rollback em caso de falha. Para cada tabela, todas as partes selecionadas são copiadas antes que qualquer uma delas seja anexada, mas a própria fase de anexação não é transacional — as partes ficam visíveis uma de cada vez. As tabelas são processadas de forma independente.
As tabelas são independentes. Uma tabela cuja restauração for concluída permanece no lugar, mesmo que outra tabela no mesmo comando falhe depois:
db.t0 tiver sido totalmente restaurado, mas a restauração de db.t1 ainda não tiver terminado, db.t0 continuará restaurado.
A cláusula PARTITIONS não é um limite de commit. Ela apenas seleciona quais partes de uma tabela serão restauradas:
2026-06-01 tiver sido totalmente copiada, mas 2026-06-02 e 2026-06-03 ainda não tiverem terminado — então 2026-06-01 não será confirmada, e a tabela ficará sem nenhum dado restaurado por esse comando. Quando a fase de cópia termina e a etapa de anexação começa, as partes são confirmadas uma a uma, portanto uma falha durante a anexação pode deixar a tabela parcialmente restaurada, sem rollback.
Para confirmar as partições de forma independente (para que uma partição concluída sobreviva a uma falha posterior e possa ser repetida isoladamente), execute um RESTORE separado para cada partição, usando SETTINGS allow_non_empty_tables = true após a primeira.
Colunas
id(String) — ID da operação, que pode ser informado por meio de SETTINGS id=… ou ser um UUID gerado aleatoriamente.name(String) — Nome da operação, uma string comoDisk('backups', 'my_backup')base_backup_name(String) — Nome da operação de backup base, uma string comoDisk('backups', 'my_base_backup')query_id(String) — ID da consulta que iniciou o backup.status(Enum8(‘CREATING_BACKUP’ = 0, ‘BACKUP_CREATED’ = 1, ‘BACKUP_FAILED’ = 2, ‘RESTORING’ = 3, ‘RESTORED’ = 4, ‘RESTORE_FAILED’ = 5, ‘BACKUP_CANCELLED’ = 6, ‘RESTORE_CANCELLED’ = 7)) — Status da operação de backup ou restauração.error(String) — Mensagem de erro, se houver.start_time(DateTime64(6)) — Horário de início da operação.end_time(DateTime64(6)) — Horário de conclusão da operação.num_files(UInt64) — Número de arquivos armazenados no backup.total_size(UInt64) — Tamanho total dos arquivos armazenados no backup.num_entries(UInt64) — Número de entradas no backup, ou seja, o número de arquivos na pasta, caso o backup seja armazenado como uma pasta.uncompressed_size(UInt64) — Tamanho não comprimido do backup.compressed_size(UInt64) — Tamanho comprimido do backup.files_read(UInt64) — Retorna o número de arquivos lidos deste backup durante RESTORE.bytes_read(UInt64) — Retorna o tamanho total dos arquivos lidos deste backup durante RESTORE.ProfileEvents(Map(LowCardinality(String), UInt64)) — Todos os eventos de perfil capturados durante esta operação.settings(Map(LowCardinality(String), String)) — Configurações específicas de backup/restauração efetivamente usadas nesta operação (da cláusulaSETTINGS, incluindo os valores padrão). Configurações confidenciais não são expostas.engine_settings(Map(LowCardinality(String), String)) — Configurações efetivamente usadas pelo leitor/componente de gravação do engine de backup (por exemplo,allow_native_copydo S3). Vazio quando a operação envolve mais de um engine, o que não pode ser representado por um map simples: backups incrementais e restaurações, restaurações leves de snapshot e operaçõesON CLUSTERnão internas.