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

> Документация по clickhouse_backupview {#clickhouse_backupview}

# clickhouse_backupview

Модуль Python для анализа резервных копий, созданных командой [BACKUP](/ru/concepts/features/backup-restore/overview).
Его основная задача — получать некоторую информацию из резервной копии без её фактического восстановления.

Этот модуль предоставляет функции для

* перечисления файлов, содержащихся в резервной копии
* чтения файлов из резервной копии
* получения полезной информации в удобочитаемом виде о базах данных, таблицах и частях, содержащихся в резервной копии
* проверки целостности резервной копии

<div id="example">
  ## Пример:
</div>

```python theme={null}
from clickhouse_backupview import open_backup, S3, FileInfo

# Открыть резервную копию. Также можно использовать локальный путь:
# backup = open_backup("/backups/my_backup_1/")
backup = open_backup(S3("uri", "access_key_id", "secret_access_key"))

# Получить список баз данных внутри резервной копии.
print(backup.get_databases()))

# Получить список таблиц внутри резервной копии,
# а для каждой таблицы — запрос на создание и список частей и партиций.
for db in backup.get_databases():
    for tbl in backup.get_tables(database=db):
        print(backup.get_create_query(database=db, table=tbl))
        print(backup.get_partitions(database=db, table=tbl))
        print(backup.get_parts(database=db, table=tbl))

# Извлечь всё из резервной копии.
backup.extract_all(table="mydb.mytable", out='/tmp/my_backup_1/all/')

# Извлечь данные конкретной таблицы.
backup.extract_table_data(table="mydb.mytable", out='/tmp/my_backup_1/mytable/')

# Извлечь одну партицию.
backup.extract_table_data(table="mydb.mytable", partition="202201", out='/tmp/my_backup_1/202201/')

# Извлечь одну часть.
backup.extract_table_data(table="mydb.mytable", part="202201_100_200_3", out='/tmp/my_backup_1/202201_100_200_3/')
```

Больше примеров см. в [test](https://github.com/ClickHouse/ClickHouse/blob/master/utils/backupview/test/test.py).