system.backup_log

جدول النظام يحتوي على إدخالات السجل تتضمن معلومات عن عمليتَي BACKUP وRESTORE.

الاستعلام في 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) — معرّف الاستعلام المرتبط بعملية نسخ احتياطي.
• 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 │
└──────────────────────────────────────┴───────────────────────────────┴────────────────┴───────┴─────────────────────┴─────────────────────┴───────────┴────────────┴─────────────┴───────────────────┴─────────────────┴────────────┴────────────┘

​

انظر أيضًا

• النسخ الاحتياطي والاستعادة