> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> `BACKUP` 및 `RESTORE` 작업 정보를 담은 로그 항목이 저장된 시스템 테이블.
# system.backup_log
**ClickHouse Cloud에서 쿼리하기**
이 시스템 테이블의 데이터는 ClickHouse Cloud의 각 노드에 로컬로 저장됩니다. 따라서 전체 데이터를 모두 확인하려면 `clusterAllReplicas` 함수를 사용해야 합니다. 자세한 내용은 [여기](/ko/reference/system-tables/overview#system-tables-in-clickhouse-cloud)를 참조하십시오.
## 설명
`BACKUP` 및 `RESTORE` 작업에 대한 정보가 담긴 로그 항목이 포함됩니다.
## 컬럼
* `hostname` ([LowCardinality(String)](/ko/reference/data-types/lowcardinality)) — 쿼리를 실행하는 서버의 호스트명입니다.
* `event_date` ([Date](/ko/reference/data-types/date)) — 기록 날짜입니다.
* `event_time` ([DateTime](/ko/reference/data-types/datetime)) — 기록 시각입니다.
* `event_time_microseconds` ([DateTime64(6)](/ko/reference/data-types/datetime64)) — 마이크로초 정밀도의 기록 시각입니다.
* `id` ([String](/ko/reference/data-types/string)) — 백업 또는 복원 작업의 식별자입니다.
* `name` ([String](/ko/reference/data-types/string)) — 백업 저장소의 이름입니다(`FROM` 또는 `TO` 절의 내용).
* `base_backup_name` ([String](/ko/reference/data-types/string)) — 증분 백업인 경우 기준 백업의 이름입니다.
* `query_id` ([String](/ko/reference/data-types/string)) — 백업 작업과 연관된 쿼리 ID입니다.
* `status` ([Enum8('CREATING\_BACKUP' = 0, 'BACKUP\_CREATED' = 1, 'BACKUP\_FAILED' = 2, 'RESTORING' = 3, 'RESTORED' = 4, 'RESTORE\_FAILED' = 5, 'BACKUP\_CANCELLED' = 6, 'RESTORE\_CANCELLED' = 7)](/ko/reference/data-types/enum)) — 작업 상태입니다.
* `error` ([String](/ko/reference/data-types/string)) — 실패한 작업의 오류 메시지입니다(성공한 작업의 경우 빈 문자열).
* `start_time` ([DateTime64(6)](/ko/reference/data-types/datetime64)) — 작업 시작 시각입니다.
* `end_time` ([DateTime64(6)](/ko/reference/data-types/datetime64)) — 작업 종료 시각입니다.
* `num_files` ([UInt64](/ko/reference/data-types/int-uint)) — 백업에 저장된 파일 수입니다.
* `total_size` ([UInt64](/ko/reference/data-types/int-uint)) — 백업에 저장된 파일의 총 크기입니다.
* `num_entries` ([UInt64](/ko/reference/data-types/int-uint)) — 백업의 엔트리 수입니다. 즉, 백업이 폴더로 저장된 경우 폴더 안의 파일 수이고, 아카이브로 저장된 경우 아카이브 안의 파일 수입니다. 증분 백업이거나 빈 파일 또는 중복 파일이 포함된 경우 `num_files`와 같지 않습니다. 다음 조건은 항상 참입니다: `num_entries ≤ num_files`.
* `uncompressed_size` ([UInt64](/ko/reference/data-types/int-uint)) — 백업의 압축되지 않은 크기입니다.
* `compressed_size` ([UInt64](/ko/reference/data-types/int-uint)) — 백업의 압축된 크기입니다. 백업이 아카이브로 저장되지 않은 경우 `uncompressed_size`와 같습니다.
* `files_read` ([UInt64](/ko/reference/data-types/int-uint)) — 복원 작업 중 읽은 파일 수입니다.
* `bytes_read` ([UInt64](/ko/reference/data-types/int-uint)) — 복원 작업 중 읽은 파일의 총 크기입니다.
## 예시
```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
```
이는 본질적으로 시스템 테이블(system table) `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 │
└──────────────────────────────────────┴───────────────────────────────┴────────────────┴───────┴─────────────────────┴─────────────────────┴───────────┴────────────┴─────────────┴───────────────────┴─────────────────┴────────────┴────────────┘
```
## 관련 항목
* [백업 및 복원](/ko/concepts/features/backup-restore/overview)