> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Table système contenant des entrées de journal relatives aux opérations `BACKUP` et `RESTORE`.

# system.backup_log

<Info>
  **Interroger dans ClickHouse Cloud**

  Les données de cette table système sont stockées localement sur chaque nœud de ClickHouse Cloud. Pour obtenir une vue complète de l’ensemble des données, il faut donc utiliser la fonction `clusterAllReplicas`. Consultez [cette page](/fr/reference/system-tables/overview#system-tables-in-clickhouse-cloud) pour plus de détails.
</Info>

<div id="description">
  ## Description
</div>

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

<div id="columns">
  ## Colonnes
</div>

* `hostname` ([LowCardinality(String)](/fr/reference/data-types/lowcardinality)) — Nom d’hôte du serveur qui exécute la requête.
* `event_date` ([Date](/fr/reference/data-types/date)) — Date de l’entrée.
* `event_time` ([DateTime](/fr/reference/data-types/datetime)) — Heure de l’entrée.
* `event_time_microseconds` ([DateTime64(6)](/fr/reference/data-types/datetime64)) — Heure de l’entrée avec une précision à la microseconde.
* `id` ([String](/fr/reference/data-types/string)) — Identifiant de l’opération de sauvegarde ou de restauration.
* `name` ([String](/fr/reference/data-types/string)) — Nom du stockage de sauvegarde (contenu de la clause FROM ou TO).
* `base_backup_name` ([String](/fr/reference/data-types/string)) — Nom de la sauvegarde de base dans le cas d’une sauvegarde incrémentale.
* `query_id` ([String](/fr/reference/data-types/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)](/fr/reference/data-types/enum)) — Statut de l’opération.
* `error` ([String](/fr/reference/data-types/string)) — Message d’erreur de l’opération en échec (chaîne vide pour les opérations réussies).
* `start_time` ([DateTime64(6)](/fr/reference/data-types/datetime64)) — Heure de début de l’opération.
* `end_time` ([DateTime64(6)](/fr/reference/data-types/datetime64)) — Heure de fin de l’opération.
* `num_files` ([UInt64](/fr/reference/data-types/int-uint)) — Nombre de fichiers stockés dans la sauvegarde.
* `total_size` ([UInt64](/fr/reference/data-types/int-uint)) — Taille totale des fichiers stockés dans la sauvegarde.
* `num_entries` ([UInt64](/fr/reference/data-types/int-uint)) — 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](/fr/reference/data-types/int-uint)) — Taille non compressée de la sauvegarde.
* `compressed_size` ([UInt64](/fr/reference/data-types/int-uint)) — 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](/fr/reference/data-types/int-uint)) — Nombre de fichiers lus pendant l’opération de restauration.
* `bytes_read` ([UInt64](/fr/reference/data-types/int-uint)) — Taille totale des fichiers lus pendant l’opération de restauration.

<div id="example">
  ## Exemple
</div>

```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
```

Il s’agit essentiellement des mêmes informations que celles qui figurent dans la table système `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 │
└──────────────────────────────────────┴───────────────────────────────┴────────────────┴───────┴─────────────────────┴─────────────────────┴───────────┴────────────┴─────────────┴───────────────────┴─────────────────┴────────────┴────────────┘
```

<div id="see-also">
  ## Voir aussi
</div>

* [Sauvegarde et restauration](/fr/concepts/features/backup-restore/overview)
