system.backup_log

ClickHouse Cloud でのクエリ実行

このシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに格納されています。そのため、すべてのデータを包括的に確認するには、clusterAllReplicas 関数を使用する必要があります。詳細についてはこちらを参照してください。

BACKUP および RESTORE 操作に関する情報を含むログエントリを保持します。

列:

hostname (LowCardinality(String)) — クエリを実行したサーバーのホスト名。
event_date (Date) — エントリの日付。
event_time (DateTime) — エントリの日付と時刻。
event_time_microseconds (DateTime64) — マイクロ秒精度でのエントリの時刻。
id (String) — バックアップまたはリストア操作の識別子。
name (String) — バックアップストレージの名前（FROM 句または TO 句の内容）。
status (Enum8) — 操作のステータス。取りうる値は次のとおりです:
- 'CREATING_BACKUP'
- 'BACKUP_CREATED'
- 'BACKUP_FAILED'
- 'RESTORING'
- 'RESTORED'
- 'RESTORE_FAILED'
error (String) — 失敗した操作のエラーメッセージ（成功した操作では空文字列）。
start_time (DateTime) — 操作の開始時刻。
end_time (DateTime) — 操作の終了時刻。
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) — リストア操作中に読み取られたファイルの合計サイズ。

Example

バックアップ 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

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

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

ディスク('backups_disk', '1.zip')から test_db.my_table テーブルを復元

┌─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

行 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

行 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') │ バックアップ作成 │       │ 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') │ 復元済み         │       │ 2023-08-19 11:09:19 │ 2023-08-19 11:09:29 │        57 │ 4290364870 │          46 │        4290362365 │      4290362365 │         57 │ 4290364870 │
└──────────────────────────────────────┴───────────────────────────────┴────────────────┴───────┴─────────────────────┴─────────────────────┴───────────┴────────────┴─────────────┴───────────────────┴─────────────────┴────────────┴────────────┘

関連項目

バックアップと復元