> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Tabela do sistema que contém entradas de log com informações sobre operações `BACKUP` e `RESTORE`.

# system.backup_log

<Info>
  **Consultas no ClickHouse Cloud**

  Os dados nesta tabela de sistema são mantidos localmente em cada nó do ClickHouse Cloud. Portanto, para obter uma visão completa de todos os dados, é necessário usar a função `clusterAllReplicas`. Consulte [aqui](/pt-BR/reference/system-tables/overview#system-tables-in-clickhouse-cloud) para mais detalhes.
</Info>

<div id="description">
  ## Descrição
</div>

Contém entradas de log com informações sobre as operações `BACKUP` e `RESTORE`.

<div id="columns">
  ## Colunas
</div>

* `hostname` ([LowCardinality(String)](/pt-BR/reference/data-types/lowcardinality)) — Hostname do servidor que executa a consulta.
* `event_date` ([Date](/pt-BR/reference/data-types/date)) — Data do registro.
* `event_time` ([DateTime](/pt-BR/reference/data-types/datetime)) — Hora do registro.
* `event_time_microseconds` ([DateTime64(6)](/pt-BR/reference/data-types/datetime64)) — Hora do registro com precisão de microssegundos.
* `id` ([String](/pt-BR/reference/data-types/string)) — Identificador da operação de backup ou restauração.
* `name` ([String](/pt-BR/reference/data-types/string)) — Nome do armazenamento de backup (o conteúdo da cláusula FROM ou TO).
* `base_backup_name` ([String](/pt-BR/reference/data-types/string)) — Nome do backup base no caso de um backup incremental.
* `query_id` ([String](/pt-BR/reference/data-types/string)) — ID de uma consulta associada a uma operação de 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)](/pt-BR/reference/data-types/enum)) — Status da operação.
* `error` ([String](/pt-BR/reference/data-types/string)) — Mensagem de erro da operação com falha (string vazia para operações bem-sucedidas).
* `start_time` ([DateTime64(6)](/pt-BR/reference/data-types/datetime64)) — Hora de início da operação.
* `end_time` ([DateTime64(6)](/pt-BR/reference/data-types/datetime64)) — Hora de término da operação.
* `num_files` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Número de arquivos armazenados no backup.
* `total_size` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Tamanho total dos arquivos armazenados no backup.
* `num_entries` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Número de entradas no backup, isto é, o número de arquivos dentro da pasta, se o backup for armazenado como pasta, ou o número de arquivos dentro do arquivo, se o backup for armazenado como arquivo. Não é o mesmo que `num_files` se for um backup incremental ou se contiver arquivos vazios ou duplicados. O seguinte é sempre verdadeiro: `num_entries ≤ num_files`.
* `uncompressed_size` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Tamanho não compactado do backup.
* `compressed_size` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Tamanho compactado do backup. Se o backup não for armazenado como arquivo, ele será igual a uncompressed\_size.
* `files_read` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Número de arquivos lidos durante a operação de restauração.
* `bytes_read` ([UInt64](/pt-BR/reference/data-types/int-uint)) — Tamanho total dos arquivos lidos durante a operação de restauração.

<div id="example">
  ## Exemplo
</div>

```sql theme={null}
BACKUP TABLE test_db.my_table TO Disk('backups_disk', '1.zip')
```

```response theme={null}
┌─id───────────────────────────────────┬─status─────────┐
│ e5b74ecb-f6f1-426a-80be-872f90043885 │ BACKUP_CREATED │
└──────────────────────────────────────┴────────────────┘
```

```sql theme={null}
SELECT * FROM system.backup_log WHERE id = 'e5b74ecb-f6f1-426a-80be-872f90043885' ORDER BY event_date, event_time_microseconds \G
```

```response theme={null}
Row 1:
──────
hostname:                clickhouse.eu-central1.internal
event_date:              2023-08-19
event_time_microseconds: 2023-08-19 11:05:21.998566
id:                      e5b74ecb-f6f1-426a-80be-872f90043885
name:                    Disk('backups_disk', '1.zip')
status:                  CREATING_BACKUP
error:                   
start_time:              2023-08-19 11:05:21
end_time:                1970-01-01 03:00:00
num_files:               0
total_size:              0
num_entries:             0
uncompressed_size:       0
compressed_size:         0
files_read:              0
bytes_read:              0

Row 2:
──────
hostname:                clickhouse.eu-central1.internal
event_date:              2023-08-19
event_time:              2023-08-19 11:08:56
event_time_microseconds: 2023-08-19 11:08:56.916192
id:                      e5b74ecb-f6f1-426a-80be-872f90043885
name:                    Disk('backups_disk', '1.zip')
status:                  BACKUP_CREATED
error:                   
start_time:              2023-08-19 11:05:21
end_time:                2023-08-19 11:08:56
num_files:               57
total_size:              4290364870
num_entries:             46
uncompressed_size:       4290362365
compressed_size:         3525068304
files_read:              0
bytes_read:              0
```

```sql theme={null}
RESTORE TABLE test_db.my_table FROM Disk('backups_disk', '1.zip')
```

```response theme={null}
┌─id───────────────────────────────────┬─status───┐
│ cdf1f731-52ef-42da-bc65-2e1bfcd4ce90 │ RESTORED │
└──────────────────────────────────────┴──────────┘
```

```sql theme={null}
SELECT * FROM system.backup_log WHERE id = 'cdf1f731-52ef-42da-bc65-2e1bfcd4ce90' ORDER BY event_date, event_time_microseconds \G
```

```response theme={null}
Row 1:
──────
hostname:                clickhouse.eu-central1.internal
event_date:              2023-08-19
event_time_microseconds: 2023-08-19 11:09:19.718077
id:                      cdf1f731-52ef-42da-bc65-2e1bfcd4ce90
name:                    Disk('backups_disk', '1.zip')
status:                  RESTORING
error:                   
start_time:              2023-08-19 11:09:19
end_time:                1970-01-01 03:00:00
num_files:               0
total_size:              0
num_entries:             0
uncompressed_size:       0
compressed_size:         0
files_read:              0
bytes_read:              0

Row 2:
──────
hostname:                clickhouse.eu-central1.internal
event_date:              2023-08-19
event_time_microseconds: 2023-08-19 11:09:29.334234
id:                      cdf1f731-52ef-42da-bc65-2e1bfcd4ce90
name:                    Disk('backups_disk', '1.zip')
status:                  RESTORED
error:                   
start_time:              2023-08-19 11:09:19
end_time:                2023-08-19 11:09:29
num_files:               57
total_size:              4290364870
num_entries:             46
uncompressed_size:       4290362365
compressed_size:         4290362365
files_read:              57
bytes_read:              4290364870
```

Essas são, essencialmente, as mesmas informações registradas na tabela do sistema `system.backups`:

```sql theme={null}
SELECT * FROM system.backups ORDER BY start_time
```

```response theme={null}
┌─id───────────────────────────────────┬─name──────────────────────────┬─status─────────┬─error─┬──────────start_time─┬────────────end_time─┬─num_files─┬─total_size─┬─num_entries─┬─uncompressed_size─┬─compressed_size─┬─files_read─┬─bytes_read─┐
│ e5b74ecb-f6f1-426a-80be-872f90043885 │ Disk('backups_disk', '1.zip') │ BACKUP_CREATED │       │ 2023-08-19 11:05:21 │ 2023-08-19 11:08:56 │        57 │ 4290364870 │          46 │        4290362365 │      3525068304 │          0 │          0 │
│ cdf1f731-52ef-42da-bc65-2e1bfcd4ce90 │ Disk('backups_disk', '1.zip') │ RESTORED       │       │ 2023-08-19 11:09:19 │ 2023-08-19 11:09:29 │        57 │ 4290364870 │          46 │        4290362365 │      4290362365 │         57 │ 4290364870 │
└──────────────────────────────────────┴───────────────────────────────┴────────────────┴───────┴─────────────────────┴─────────────────────┴───────────┴────────────┴─────────────┴───────────────────┴─────────────────┴────────────┴────────────┘
```

<div id="see-also">
  ## Veja também
</div>

* [Backup e restauração](/pt-BR/concepts/features/backup-restore/overview)
