PG_COMBINEBACKUP
[Tùy chọn
...] [Backup_Directory
...]
PG_COMBINEBACKUPđược sử dụng để xây dựng lại bản kèo bóng đá pháp đầy đủ tổng hợp từkèo bóng đá pháp gia tăngvà các bản kèo bóng đá pháp trước đó mà nó phụ thuộc.
Chỉ định tất cả các bản kèo bóng đá pháp cần thiết trên dòng lệnh từ cũ đến mới nhất. Đó là, thư mục kèo bóng đá pháp đầu tiên phải là đường dẫn đến bản kèo bóng đá pháp đầy đủ và cuối cùng nên là đường dẫn đến bản kèo bóng đá pháp gia tăng cuối cùng mà bạn muốn khôi phục.-O
Tùy chọn.
PG_COMBINEBACKUPsẽ cố gắng xác minh rằng các bản kèo bóng đá pháp bạn chỉ định tạo thành một chuỗi kèo bóng đá pháp hợp pháp mà có thể được xây dựng lại chính xác. Tuy nhiên, nó không được thiết kế để giúp bạn theo dõi các bản kèo bóng đá pháp nào phụ thuộc vào các bản kèo bóng đá pháp khác.PG_COMBINEBACKUPChỉ cố gắng xác minh rằng các bản kèo bóng đá pháp có mối quan hệ chính xác với nhau, không phải mỗi bản kèo bóng đá pháp riêng lẻ còn nguyên vẹn; Vì điều đó, sử dụngpg_verifybackup.
Kể từ đầu ra củapg_combinebackuplà bản kèo bóng đá pháp đầy đủ tổng hợp, nó có thể được sử dụng làm đầu vào cho một lời cầu khẩn trong tương lai củapg_combinebackup. Bản kèo bóng đá pháp đầy đủ tổng hợp sẽ được chỉ định trên dòng lệnh thay cho chuỗi các bản kèo bóng đá pháp mà nó được xây dựng lại.
-D
-Debug
in nhiều đầu ra ghi nhật ký gỡ lỗi trênstderr
.
-N
--Dry-Run
The-N
/--Dry-Run
Tùy chọn hướng dẫnPG_COMBINEBACKUP
Để tìm ra những gì sẽ được thực hiện mà không thực sự tạo thư mục đích hoặc bất kỳ tệp đầu ra nào. Nó đặc biệt hữu ích khi kết hợp với-Debug
.
-N
--no-sync
Theo mặc định,pg_combinebackup
Sẽ chờ tất cả các tệp được viết an toàn vào đĩa. Tùy chọn này gây raPG_COMBINEBACKUP
Để quay lại mà không chờ đợi, điều này nhanh hơn, nhưng có nghĩa là sự cố hệ điều hành tiếp theo có thể khiến bản kèo bóng đá pháp đầu ra bị hỏng. Nói chung, tùy chọn này rất hữu ích cho thử nghiệm nhưng không nên được sử dụng khi tạo cài đặt sản xuất.
-OOutputDir
-output =OutputDir
Chỉ định thư mục đầu ra mà bản kèo bóng đá pháp tổng hợp phải được viết. Hiện tại, đối số này là bắt buộc.
-TOlddir
=NewDir
--TableSpace-mapping =Olddir
=NewDir
di chuyển không gian bảng trong thư mụcOlddir
đếnNewDir
Trong quá trình kèo bóng đá pháp.Olddir
là đường dẫn tuyệt đối của không gian bảng vì nó tồn tại trong bản kèo bóng đá pháp cuối cùng được chỉ định trên dòng lệnh vàNewDir
là đường dẫn tuyệt đối để sử dụng cho không gian bảng trong bản kèo bóng đá pháp được xây dựng lại. Nếu một trong hai đường dẫn cần chứa một dấu bằng (=
), đi trước đó với một dấu gạch chéo ngược. Tùy chọn này có thể được chỉ định nhiều lần cho nhiều không gian bảng.
--clone
Sử dụng nhân kèo bóng đá pháp tệp hiệu quả (còn được gọi làHồiReflinksHồi11610_11747
11763_11970
Nhân kèo bóng đá pháp tệp chỉ được hỗ trợ trên một số hệ điều hành và hệ thống tệp. Nếu nó được chọn nhưng không được hỗ trợ,PG_COMBINEBACKUPChạy sẽ lỗi. Hiện tại, nó được hỗ trợ trên Linux (Kernel 4.5 trở lên) với BTRFS và XFS (trên các hệ thống tệp được tạo với hỗ trợ DELFINK) và trên các macOS với APFS.
--copy
Thực hiện bản kèo bóng đá pháp tệp thông thường. Đây là mặc định.--copy-file-Range
và--clone
.)
--copy-file-Range
Sử dụngcopy_file_range
Cuộc gọi hệ thống để kèo bóng đá pháp chép hiệu quả. Trên một số hệ thống tệp, điều này mang lại kết quả tương tự như--clone
, chia sẻ các khối đĩa vật lý, trong khi trên các khối khác, nó vẫn có thể kèo bóng đá pháp chép các khối, nhưng làm như vậy thông qua một đường dẫn được tối ưu hóa. Hiện tại, nó được hỗ trợ trên Linux và FreeBSD.
Nếu không khả dụng bản kèo bóng đá pháp hoặc không chứa tổng kiểm tra của loại đúng,copy_file_range
sẽ được sử dụng để kèo bóng đá pháp chép tệp, nhưng tệp cũng sẽ được đọc theo từng khối để tính toán tổng kiểm tra.
--Manifest-Checksums =Thuật toán
nhưpg_basebackup, PG_COMBINEBACKUPViết một bản kèo bóng đá pháp bản kèo bóng đá pháp trong thư mục đầu ra. Tùy chọn này chỉ định thuật toán tổng kiểm tra nên được áp dụng cho mỗi tệp được bao gồm trong bản kèo bóng đá pháp.Không
, CRC32C
, SHA224
, SHA256
, SHA384
vàSHA512
. Mặc định làCRC32C
.
--no-Manifest
Vô hiệu hóa việc tạo một bản kèo bóng đá pháp bản kèo bóng đá pháp. Nếu tùy chọn này không được chỉ định, bản kèo bóng đá pháp bản kèo bóng đá pháp cho bản kèo bóng đá pháp được xây dựng lại sẽ được ghi vào thư mục đầu ra.
--sync-method =Phương pháp
Khi được đặt thànhfsync
, là mặc định,PG_COMBINEBACKUP
sẽ mở đệ quy và đồng bộ hóa tất cả các tệp trong thư mục kèo bóng đá pháp. Khi định dạng đơn giản được sử dụng, tìm kiếm các tệp sẽ theo các liên kết tượng trưng cho thư mục WAL và mỗi không gian bảng được cấu hình.
Trên Linux,Syncfs
Có thể được sử dụng thay vào đó để yêu cầu hệ điều hành đồng bộ hóa toàn bộ hệ thống tệp có chứa thư mục kèo bóng đá pháp. Khi định dạng đơn giản được sử dụng,pg_combinebackup
cũng sẽ đồng bộ hóa các hệ thống tệp chứa các tệp WAL và mỗi không gian bảng. Nhìn thấyrecovery_init_sync_methodĐể biết thông tin về các cảnh báo để biết khi sử dụng15528_15536
.
Tùy chọn này không có hiệu lực khi--no-sync
được sử dụng.
-V
--Version
inPG_COMBINEBACKUPPhiên kèo bóng đá pháp và thoát.
-?
--Help
Hiển thị trợ giúp vềPG_COMBINEBACKUPĐối số dòng lệnh và thoát.
PG_COMBINEBACKUP
Không tính toán kiểm tra trang khi viết thư mục đầu ra. Do đó, nếu bất kỳ bản kèo bóng đá pháp nào được sử dụng để xây dựng lại được thực hiện với tổng kiểm tra, nhưng bản kèo bóng đá pháp cuối cùng được thực hiện với tổng kiểm tra, thư mục kết quả có thể chứa các trang có tổng kiểm tra không hợp lệ.
Để tránh vấn đề này, hãy kèo bóng đá pháp đầy đủ mới sau khi thay đổi trạng thái tổng kiểm tra của cụm bằng cách sử dụngpg_checksumsđược khuyến nghị. Nếu không, bạn có thể vô hiệu hóa và sau đó tùy chọn kiểm tra có thể tái hiện trên thư mục được tạo bởiPG_COMBINEBACKUP
Để khắc phục sự cố.
Tiện ích này, giống như hầu hết các khácPostgreSQLTiện ích, sử dụng các biến môi trường được hỗ trợ bởilibpq(xemPhần 32.15).
Biến môi trườngpg_color
Chỉ định có nên sử dụng màu trong các thông báo chẩn đoán hay không. Các giá trị có thể làluôn luôn
, Auto
vàkhông bao giờ
.
Nếu bạn thấy bất cứ điều gì trong tài liệu không chính xác, không phù hợpMẫu nàyĐể báo cáo vấn đề tài liệu.