Содержит список всех операций BACKUP и RESTORE с их текущими состояниями и другими свойствами. Обратите внимание, что эта таблица не сохраняется и показывает только операции, выполненные после последнего перезапуска сервера.
id (String) — ID операции; может быть либо передан через SETTINGS id=…, либо случайным образом сгенерирован как UUID.name (String) — Имя операции, строка вида Disk('backups', 'my_backup')base_backup_name (String) — Имя операции базовой резервной копии, строка вида Disk('backups', 'my_base_backup')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) — Количество записей в резервной копии, то есть количество файлов в папке, если резервная копия хранится в виде папки.uncompressed_size (UInt64) — Размер резервной копии в несжатом виде.compressed_size (UInt64) — Размер резервной копии в сжатом виде.files_read (UInt64) — Количество файлов, прочитанных во время RESTORE из этой резервной копии.bytes_read (UInt64) — Общий размер файлов, прочитанных во время RESTORE из этой резервной копии.ProfileEvents (Map(LowCardinality(String), UInt64)) — Все события профиля, собранные во время этой операции.settings (Map(LowCardinality(String), String)) — Специфичные для резервного копирования/восстановления настройки, фактически использованные для этой операции (из предложения SETTINGS, включая значения по умолчанию). Конфиденциальные настройки не раскрываются.engine_settings (Map(LowCardinality(String), String)) — Настройки, фактически используемые модулем чтения/записи движка резервного копирования (например, S3 allow_native_copy). Пусто, если операция задействует более одного движка, что нельзя представить в виде плоской Map: инкрементные резервные копии и восстановления, восстановления легковесных снимков и невнутренние операции с предложением ON CLUSTER.
Атомарность восстановления
RESTORE не является транзакционной операцией и при сбое не выполняет откат. Для каждой таблицы все выбранные части копируются до того, как будет подключена хотя бы одна из них, но сам этап подключения не является транзакционным — части становятся видимыми по одной. Таблицы обрабатываются независимо.
Таблицы независимы. Таблица, восстановление которой завершилось, остается доступной, даже если другая таблица в той же команде позже завершится с ошибкой:
Если эта команда завершится ошибкой после того, как db.t0 будет полностью восстановлена, но до завершения восстановления db.t1, db.t0 останется восстановленной.
Предложение PARTITIONS не является границей коммита. Она лишь определяет, какие части таблицы будут восстановлены:
Сначала копируются все выбранные части таблицы, и только после того, как готовы все до одной, они подключаются. Поэтому, если эта команда завершится ошибкой на этапе копирования — например, после того как партиция 2026-06-01 уже полностью скопирована, а 2026-06-02 и 2026-06-03 ещё не завершены, — то 2026-06-01 не будет закоммичена, и в таблице не останется никаких данных, восстановленных этой командой. После завершения этапа копирования начинается этап подключения, и на нём части коммитятся по одной, поэтому сбой во время подключения может оставить таблицу частично восстановленной, без rollback.
Чтобы коммитить партиции независимо (так, чтобы успешно завершённая партиция сохранилась при последующем сбое и её можно было повторить отдельно), запускайте отдельный RESTORE для каждой партиции, используя SETTINGS allow_non_empty_tables = true после первой. Последнее изменение 23 июля 2026 г.
