Skip to content

Commit

Permalink
Add option --skip-projections to create, upload, restore comm…
Browse files Browse the repository at this point in the history
…ands, with table pattern to allow make backup without projection fix #861

Signed-off-by: Slach <[email protected]>
  • Loading branch information
Slach committed Jan 25, 2025
1 parent 3c6e437 commit 1eb6e93
Show file tree
Hide file tree
Showing 15 changed files with 380 additions and 72 deletions.
2 changes: 2 additions & 0 deletions ChangeLog.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

IMPROVEMENTS

- Add option `--skip-projections` to `create`, `upload`, `restore` commands, with table pattern to allow make backup
without projection fix [861](https://github.com/Altinity/clickhouse-backup/issues/861)
- remove `S3_PART_SIZE` and `AZBLOB_BUFFER_SIZE` parameter from configuration and significant decrease memory usage
during upload and download, fix [854](https://github.com/Altinity/clickhouse-backup/issues/854)
- add `--configs-only` and `--rbac-only` options to `upload` and `download` command,
Expand Down
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ MIT License

Copyright (c) 2018-2019 Alexander Akulov
Copyright (c) 2020-2099 Altinity Inc.
Mantained by Eugene Klimov <[email protected]>
Maintained by Eugene Klimov <[email protected]>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
6 changes: 6 additions & 0 deletions Manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@ Look at the system.parts partition and partition_id fields for details https://c
--rbac-only Backup RBAC related objects only, will skip backup data, will backup schema only if --schema added
--configs-only Backup 'clickhouse-server' configuration files only, will skip backup data, will backup schema only if --schema added
--skip-check-parts-columns Skip check system.parts_columns to allow backup inconsistent column types for data parts
--skip-projections Skip make hardlinks to *.proj/* files during backup creation
--resume use_embedded_backup_restore: true, --resumable use_embedded_backup_restore: true Will resume upload for object disk data, hard links on local disk still continue to recreate, not work when use_embedded_backup_restore: true
```
Expand Down Expand Up @@ -77,6 +78,7 @@ Look at the system.parts partition and partition_id fields for details https://c
--configs-only Backup 'clickhouse-server' configuration files only, will skip backup data, will backup schema only if --schema added
--resume, --resumable Save intermediate upload state and resume upload if backup exists on remote storage, ignore when 'remote_storage: custom' or 'use_embedded_backup_restore: true'
--skip-check-parts-columns Skip check system.parts_columns to allow backup inconsistent column types for data parts
--skip-projections Skip make and upload hardlinks to *.proj/* files during backup creation
--delete, --delete-source, --delete-local explicitly delete local backup during upload
```
Expand Down Expand Up @@ -104,6 +106,7 @@ Look at the system.parts partition and partition_id fields for details https://c
--schema, -s Upload schemas only
--rbac-only, --rbac Upload RBAC related objects only, will skip upload data, will backup schema only if --schema added
--configs-only, --configs Upload 'clickhouse-server' configuration files only, will skip upload data, will backup schema only if --schema added
--skip-projections Skip make and upload hardlinks to *.proj/* files during backup creation
--resume, --resumable Save intermediate upload state and resume upload if backup exists on remote storage, ignored with 'remote_storage: custom' or 'use_embedded_backup_restore: true'
--delete, --delete-source, --delete-local explicitly delete local backup during upload
Expand Down Expand Up @@ -175,6 +178,7 @@ Look at the system.parts partition and partition_id fields for details https://c
--configs, --restore-configs, --do-restore-configs Restore 'clickhouse-server' CONFIG related files
--rbac-only Restore RBAC related objects only, will skip backup data, will backup schema only if --schema added
--configs-only Restore 'clickhouse-server' configuration files only, will skip backup data, will backup schema only if --schema added
--skip-projections Skip make hardlinks to *.proj/* files during backup restoring
--resume, --resumable Will resume download for object disk data
```
Expand Down Expand Up @@ -207,6 +211,7 @@ Look at the system.parts partition and partition_id fields for details https://c
--configs, --restore-configs, --do-restore-configs Download and Restore 'clickhouse-server' CONFIG related files
--rbac-only Restore RBAC related objects only, will skip backup data, will backup schema only if --schema added
--configs-only Restore 'clickhouse-server' configuration files only, will skip backup data, will backup schema only if --schema added
--skip-projections Skip make hardlinks to *.proj/* files during backup restoring
--resume, --resumable Save intermediate download state and resume download if backup exists on remote storage, ignored with 'remote_storage: custom' or 'use_embedded_backup_restore: true'
```
Expand Down Expand Up @@ -304,6 +309,7 @@ Look at the system.parts partition and partition_id fields for details https://c
--rbac, --backup-rbac, --do-backup-rbac Backup RBAC related objects only
--configs, --backup-configs, --do-backup-configs Backup `clickhouse-server' configuration files only
--skip-check-parts-columns Skip check system.parts_columns to allow backup inconsistent column types for data parts
--skip-projections Skip make and upload hardlinks to *.proj/* files during backup creation
```
### CLI command - server
Expand Down
6 changes: 6 additions & 0 deletions ReadMe.md
Original file line number Diff line number Diff line change
Expand Up @@ -605,6 +605,7 @@ Look at the system.parts partition and partition_id fields for details https://c
--rbac-only Backup RBAC related objects only, will skip backup data, will backup schema only if --schema added
--configs-only Backup 'clickhouse-server' configuration files only, will skip backup data, will backup schema only if --schema added
--skip-check-parts-columns Skip check system.parts_columns to allow backup inconsistent column types for data parts
--skip-projections Skip make hardlinks to *.proj/* files during backup creation
--resume use_embedded_backup_restore: true, --resumable use_embedded_backup_restore: true Will resume upload for object disk data, hard links on local disk still continue to recreate, not work when use_embedded_backup_restore: true
```
Expand Down Expand Up @@ -639,6 +640,7 @@ Look at the system.parts partition and partition_id fields for details https://c
--configs-only Backup 'clickhouse-server' configuration files only, will skip backup data, will backup schema only if --schema added
--resume, --resumable Save intermediate upload state and resume upload if backup exists on remote storage, ignore when 'remote_storage: custom' or 'use_embedded_backup_restore: true'
--skip-check-parts-columns Skip check system.parts_columns to allow backup inconsistent column types for data parts
--skip-projections Skip make and upload hardlinks to *.proj/* files during backup creation
--delete, --delete-source, --delete-local explicitly delete local backup during upload
```
Expand Down Expand Up @@ -666,6 +668,7 @@ Look at the system.parts partition and partition_id fields for details https://c
--schema, -s Upload schemas only
--rbac-only, --rbac Upload RBAC related objects only, will skip upload data, will backup schema only if --schema added
--configs-only, --configs Upload 'clickhouse-server' configuration files only, will skip upload data, will backup schema only if --schema added
--skip-projections Skip make and upload hardlinks to *.proj/* files during backup creation
--resume, --resumable Save intermediate upload state and resume upload if backup exists on remote storage, ignored with 'remote_storage: custom' or 'use_embedded_backup_restore: true'
--delete, --delete-source, --delete-local explicitly delete local backup during upload
Expand Down Expand Up @@ -737,6 +740,7 @@ Look at the system.parts partition and partition_id fields for details https://c
--configs, --restore-configs, --do-restore-configs Restore 'clickhouse-server' CONFIG related files
--rbac-only Restore RBAC related objects only, will skip backup data, will backup schema only if --schema added
--configs-only Restore 'clickhouse-server' configuration files only, will skip backup data, will backup schema only if --schema added
--skip-projections Skip make hardlinks to *.proj/* files during backup restoring
--resume, --resumable Will resume download for object disk data
```
Expand Down Expand Up @@ -769,6 +773,7 @@ Look at the system.parts partition and partition_id fields for details https://c
--configs, --restore-configs, --do-restore-configs Download and Restore 'clickhouse-server' CONFIG related files
--rbac-only Restore RBAC related objects only, will skip backup data, will backup schema only if --schema added
--configs-only Restore 'clickhouse-server' configuration files only, will skip backup data, will backup schema only if --schema added
--skip-projections Skip make hardlinks to *.proj/* files during backup restoring
--resume, --resumable Save intermediate download state and resume download if backup exists on remote storage, ignored with 'remote_storage: custom' or 'use_embedded_backup_restore: true'
```
Expand Down Expand Up @@ -866,6 +871,7 @@ Look at the system.parts partition and partition_id fields for details https://c
--rbac, --backup-rbac, --do-backup-rbac Backup RBAC related objects only
--configs, --backup-configs, --do-backup-configs Backup `clickhouse-server' configuration files only
--skip-check-parts-columns Skip check system.parts_columns to allow backup inconsistent column types for data parts
--skip-projections Skip make and upload hardlinks to *.proj/* files during backup creation
```
### CLI command - server
Expand Down
Loading

0 comments on commit 1eb6e93

Please sign in to comment.