Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.backup_log

View as MarkdownEdit this pageReport an issueSet up docs MCP

Description

Contient des entrées de journal avec des informations sur les opérations BACKUP et RESTORE.

Colonnes

  • hostname (LowCardinality(String)) — Nom d’hôte du serveur qui exécute la requête.
  • event_date (Date) — Date de l’entrée.
  • event_time (DateTime) — Heure de l’entrée.
  • event_time_microseconds (DateTime64(6)) — Heure de l’entrée avec une précision à la microseconde.
  • id (String) — Identifiant de l’opération de sauvegarde ou de restauration.
  • name (String) — Nom du stockage de sauvegarde (contenu de la clause FROM ou TO).
  • base_backup_name (String) — Nom de la sauvegarde de base dans le cas d’une sauvegarde incrémentale.
  • query_id (String) — ID d’une requête associée à une opération de sauvegarde.
  • status (Enum8('CREATING_BACKUP' = 0, 'BACKUP_CREATED' = 1, 'BACKUP_FAILED' = 2, 'RESTORING' = 3, 'RESTORED' = 4, 'RESTORE_FAILED' = 5, 'BACKUP_CANCELLED' = 6, 'RESTORE_CANCELLED' = 7)) — Statut de l’opération.
  • error (String) — Message d’erreur de l’opération en échec (chaîne vide pour les opérations réussies).
  • start_time (DateTime64(6)) — Heure de début de l’opération.
  • end_time (DateTime64(6)) — Heure de fin de l’opération.
  • num_files (UInt64) — Nombre de fichiers stockés dans la sauvegarde.
  • total_size (UInt64) — Taille totale des fichiers stockés dans la sauvegarde.
  • num_entries (UInt64) — Nombre d’entrées dans la sauvegarde, c.-à-d. le nombre de fichiers dans le dossier si la sauvegarde est stockée sous forme de dossier, ou le nombre de fichiers dans l’archive si la sauvegarde est stockée sous forme d’archive. Ce n’est pas la même chose que num_files s’il s’agit d’une sauvegarde incrémentale ou si elle contient des fichiers vides ou des doublons. L’assertion suivante est toujours vraie : num_entries ≤ num_files.
  • uncompressed_size (UInt64) — Taille non compressée de la sauvegarde.
  • compressed_size (UInt64) — Taille compressée de la sauvegarde. Si la sauvegarde n’est pas stockée sous forme d’archive, elle est égale à uncompressed_size.
  • files_read (UInt64) — Nombre de fichiers lus pendant l’opération de restauration.
  • bytes_read (UInt64) — Taille totale des fichiers lus pendant l’opération de restauration.
  • settings (Map(LowCardinality(String), String)) — Paramètres spécifiques à la sauvegarde/restauration effectivement utilisés pour cette opération (issus de la clause SETTINGS, y compris les valeurs par défaut). Les paramètres sensibles ne sont pas exposés.
  • engine_settings (Map(LowCardinality(String), String)) — Paramètres effectivement utilisés par le lecteur/rédacteur du moteur de sauvegarde (par ex. S3 allow_native_copy). Vide lorsque l’opération implique plus d’un moteur qu’une map plate ne peut représenter : sauvegardes incrémentales et restaurations, restaurations de snapshots lightweight et opérations ON CLUSTER non internes.

Exemple

BACKUP TABLE test_db.my_table TO Disk('backups_disk', '1.zip')
┌─id───────────────────────────────────┬─status─────────┐
│ e5b74ecb-f6f1-426a-80be-872f90043885 │ BACKUP_CREATED │
└──────────────────────────────────────┴────────────────┘
SELECT hostname, event_date, event_time_microseconds, id, name, status, error, start_time, end_time, num_files, total_size, num_entries, uncompressed_size, compressed_size, files_read, bytes_read 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 hostname, event_date, event_time_microseconds, id, name, status, error, start_time, end_time, num_files, total_size, num_entries, uncompressed_size, compressed_size, files_read, bytes_read 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

Il s’agit essentiellement des mêmes informations que celles qui figurent dans la table système system.backups :

SELECT id, name, status, error, start_time, end_time, num_files, total_size, num_entries, uncompressed_size, compressed_size, files_read, bytes_read 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 │
└──────────────────────────────────────┴───────────────────────────────┴────────────────┴───────┴─────────────────────┴─────────────────────┴───────────┴────────────┴─────────────┴───────────────────┴─────────────────┴────────────┴────────────┘

Voir aussi

Navigation