본문으로 바로가기
본문으로 바로가기

system.backup_log

ClickHouse Cloud에서 쿼리하기

이 시스템 테이블의 데이터는 ClickHouse Cloud의 각 노드에 로컬로 저장됩니다. 따라서 전체 데이터를 조회하려면 clusterAllReplicas 함수를 사용해야 합니다. 자세한 내용은 여기를 참고하십시오.

설명​

BACKUP 및 RESTORE 작업과 관련된 정보를 기록한 로그 항목을 포함합니다.

컬럼​

  • hostname (LowCardinality(String)) — 쿼리를 실행하는 서버의 호스트명입니다.
  • event_date (Date) — 항목의 날짜입니다.
  • event_time (DateTime) — 항목의 시간입니다.
  • event_time_microseconds (DateTime64(6)) — 마이크로초 정밀도의 항목 시간입니다.
  • id (String) — 백업 또는 복원 작업의 식별자입니다.
  • name (String) — 백업 저장소의 이름입니다(FROM 또는 TO 절의 내용).
  • base_backup_name (String) — 증분 백업인 경우 기준 백업의 이름입니다.
  • query_id (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)) — 작업 상태입니다.
  • error (String) — 실패한 작업의 오류 메시지입니다(성공한 작업의 경우 빈 문자열).
  • start_time (DateTime64(6)) — 작업 시작 시간입니다.
  • end_time (DateTime64(6)) — 작업 종료 시간입니다.
  • num_files (UInt64) — 백업에 저장된 파일 수입니다.
  • total_size (UInt64) — 백업에 저장된 파일의 총 크기입니다.
  • num_entries (UInt64) — 백업의 항목 수입니다. 즉, 백업이 폴더로 저장된 경우에는 폴더 내부의 파일 수이고, 백업이 아카이브로 저장된 경우에는 아카이브 내부의 파일 수입니다. 증분 백업이거나 빈 파일 또는 중복 파일이 포함된 경우에는 num_files와 같지 않을 수 있습니다. 다음 조건은 항상 성립합니다: num_entries ≤ num_files.
  • uncompressed_size (UInt64) — 백업의 비압축 크기입니다.
  • compressed_size (UInt64) — 백업의 압축 크기입니다. 백업이 아카이브로 저장되지 않은 경우 uncompressed_size와 같습니다.
  • files_read (UInt64) — 복원 작업 중 읽은 파일 수입니다.
  • bytes_read (UInt64) — 복원 작업 중 읽은 파일의 총 크기입니다.

예시​

BACKUP TABLE test_db.my_table TO Disk('backups_disk', '1.zip')

┌─id───────────────────────────────────┬─status─────────┐
│ e5b74ecb-f6f1-426a-80be-872f90043885 │ BACKUP_CREATED │
└──────────────────────────────────────┴────────────────┘

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

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

RESTORE TABLE test_db.my_table FROM Disk('backups_disk', '1.zip')

┌─id───────────────────────────────────┬─status───┐
│ cdf1f731-52ef-42da-bc65-2e1bfcd4ce90 │ RESTORED │
└──────────────────────────────────────┴──────────┘

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

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.backups에 기록된 정보와 동일합니다.

SELECT * FROM system.backups ORDER BY start_time

┌─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 │
└──────────────────────────────────────┴───────────────────────────────┴────────────────┴───────┴─────────────────────┴─────────────────────┴───────────┴────────────┴─────────────┴───────────────────┴─────────────────┴────────────┴────────────┘

함께 보기​