Đặt thư mục đích để ghi đầu ra thành.pg_basebackupsẽ tạo thư mục này (và bất kỳ thư mục phụ huynh bị thiếu) nếu nó kèo bóng đá hom nay tồn tại. Nếu nó đã tồn tại, nó phải trống.

Khi bản kèo bóng đá hom nay ở định dạng TAR, thư mục đích có thể được chỉ định là-(Dash), khiến tệp tar được ghi thànhstdout.

tùy chọn này là bắt buộc.

Chọn định dạng cho đầu ra.Định dạngcó thể là một trong những điều sau:

thực hiệnkèo bóng đá hom nay gia tăng. Biện bản kèo bóng đá hom nay cho bản kèo bóng đá hom nay tham chiếu phải được cung cấp và sẽ được tải lên máy chủ, sẽ trả lời bằng cách gửi bản kèo bóng đá hom nay gia tăng được yêu cầu.

Tạo Astandby.signal FILE và nối các cài đặt kết nối vàopostgresql.auto.confTệp trong thư mục đích (hoặc trong tệp lưu trữ cơ sở khi sử dụng định dạng TAR). Điều này giúp thiết lập một máy chủ dự phòng bằng kết quả của bản kèo bóng đá hom nay.

ThePostgresql.auto.confTệp sẽ ghi lại các cài đặt kết nối và, nếu được chỉ định, khe kèo bóng đá hom nay chéppg_basebackupđang sử dụng, do đó kèo bóng đá hom nay chép phát trực tuyến vàĐồng bộ hóa khe kèo bóng đá hom nay chép logicsẽ sử dụng các cài đặt tương tự sau này. DBName sẽ chỉ được ghi nếu DBName được chỉ định rõ ràng trong chuỗi kết nối hoặcBiến môi trường.

Hướng dẫn máy chủ nơi đặt bản kèo bóng đá hom nay cơ sở. Mục tiêu mặc định làclient, chỉ định rằng kèo bóng đá hom nay sẽ được gửi đến máy nơipg_basebackupđang chạy. Nếu mục tiêu thay vào đó được đặt thànhMáy chủ:/một số/đường dẫn, bản kèo bóng đá hom nay sẽ được lưu trữ trên máy nơi máy chủ đang chạy trong/một số/đường dẫnThư mục. Lưu trữ kèo bóng đá hom nay trên máy chủ yêu cầu các đặc quyền siêu người dùng hoặc có các đặc quyền củapg_write_server_filesVai trò. Nếu mục tiêu được đặt thànhBlackhole, Nội dung bị loại bỏ và không được lưu trữ ở bất cứ đâu. Điều này chỉ nên được sử dụng cho mục đích thử nghiệm, vì bạn sẽ không kết thúc với một bản kèo bóng đá hom nay thực tế.

Kể từ khi phát trực tuyến Wal được triển khai bởipg_basebackupThay vì máy chủ, tùy chọn này kèo bóng đá hom nay thể được sử dụng cùng với-XStream. Vì đó là mặc định, khi tùy chọn này được chỉ định, bạn cũng phải chỉ định-xfetchhoặc-xnone.

di chuyển kèo bóng đá hom nay gian bảng trong thư mụcOlddirđếnNewDirTrong quá trình kèo bóng đá hom nay. Để có hiệu quả,Olddirphải khớp chính xác với đặc tả đường dẫn của kèo bóng đá hom nay gian bảng vì nó được xác định trên máy chủ nguồn. (Nhưng đó kèo bóng đá hom nay phải là lỗi nếu kèo bóng đá hom nay có kèo bóng đá hom nay gian bảng trongOlddirTrên máy chủ nguồn.) Trong khi đóNewDirlà một thư mục trong hệ thống tập tin của máy chủ nhận. Như với thư mục mục tiêu chính,NewDirkèo bóng đá hom nay cần tồn tại, nhưng nếu nó tồn tại thì nó phải trống. Cả haiOlddirvàNewDirphải là đường dẫn tuyệt đối. Nếu một trong hai đường dẫn cần chứa một dấu bằng (=), 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 kèo bóng đá hom nay gian bảng.

Nếu một kèo bóng đá hom nay gian bảng được di dời theo cách này, các liên kết tượng trưng bên trong thư mục dữ liệu chính được cập nhật để trỏ đến vị trí mới. Vì vậy, thư mục dữ liệu mới đã sẵn sàng để được sử dụng cho một phiên bản máy chủ mới với tất cả các kèo bóng đá hom nay gian bảng trong các vị trí được cập nhật.

Hiện tại, tùy chọn này chỉ hoạt động với định dạng đầu ra đơn giản; nó bị bỏ qua nếu định dạng tar được chọn.

Đặt thư mục để viết các tệp WAL (Viết nhật ký trước) thành. Theo mặc định, các tệp wal sẽ được đặt trongpg_walthư mục của thư mục đích, nhưng tùy chọn này có thể được sử dụng để đặt chúng ở nơi khác.Waldirphải là một con đường tuyệt đối. Như với thư mục mục tiêu chính,WaldirKhông cần tồn tại, nhưng nếu nó tồn tại thì nó phải trống. Tùy chọn này chỉ có thể được chỉ định khi kèo bóng đá hom nay ở định dạng đơn giản.

Bao gồm các tệp WAL (Viết nhật ký ghi) bắt buộc trong bản kèo bóng đá hom nay. Điều này sẽ bao gồm tất cả các nhật ký ghi lại được tạo trong quá trình kèo bóng đá hom nay.kèo bóng đá hom nay24423_24600

sauPhương phápS để thu thập các bản ghi ghi lại được hỗ trợ:

Cho phép nén GZIP của đầu ra tệp TAR, với mức nén mặc định. Nén chỉ khả dụng khi sử dụng định dạng TAR và hậu tố.gzsẽ tự động được thêm vào tất cả các tên tệp tar.

Yêu cầu nén bản kèo bóng đá hom nay. Nếu nhưClienthoặcMáy chủđược bao gồm, nó chỉ định nơi thực hiện nén. Nén trên máy chủ sẽ giảm băng thông chuyển nhưng sẽ tăng mức tiêu thụ CPU của máy chủ.clientngoại trừ khi--targetđược sử dụng. Trong trường hợp đó, bản kèo bóng đá hom nay không được gửi đến máy khách, vì vậy chỉ có nén máy chủ là hợp lý.-XStream, là mặc định, được sử dụng, nén phía máy chủ sẽ kèo bóng đá hom nay được áp dụng cho WAL. Để nén WAL, sử dụng nén phía máy khách hoặc chỉ định-xfetch.

Phương pháp nén có thể được đặt thànhgzip, LZ4, ZSTD, kèo bóng đá hom naykèo bóng đá hom nay có nén hoặc số nguyên (kèo bóng đá hom nay nén nếu 0,gzipNếu lớn hơn 0). Một chuỗi chi tiết nén có thể được chỉ định tùy chọn.Từ khóahoặcTừ khóa = value. Hiện tại, các từ khóa được hỗ trợ làCấp, LongvàCông nhân. Chuỗi chi tiết kèo bóng đá hom nay thể được sử dụng khi phương thức nén được chỉ định làm số nguyên đơn giản.

Nếu kèo bóng đá hom nay có mức độ nén được chỉ định, mức nén mặc định sẽ được sử dụng. Nếu chỉ có một cấp độ được chỉ định mà kèo bóng đá hom nay đề cập đến thuật toán,gzipNén sẽ được sử dụng nếu mức lớn hơn 0 và sẽ kèo bóng đá hom nay sử dụng nén nếu mức là 0.

Khi định dạng TAR được sử dụng vớigzip, LZ4hoặcZSTD, Hậu tố.gz, .lz4hoặc.zst, tương ứng, sẽ được tự động thêm vào tất cả các tên tệp tar. Khi định dạng đơn giản được sử dụng, nén phía máy khách có thể kèo bóng đá hom nay được chỉ định, nhưng vẫn có thể yêu cầu nén phía máy chủ.

Khi tùy chọn này được sử dụng kết hợp với-XStream, pg_wal.tarsẽ được nén bằng cách sử dụnggzipNếu nén GZIP phía máy khách được chọn, nhưng sẽ kèo bóng đá hom nay được nén nếu bất kỳ thuật toán nén nào khác được chọn hoặc nếu được chọn nén phía máy chủ.

Đặt chế độ điểm kiểm tra thành nhanh (ngay lập tức) hoặc lan truyền (mặc định) (xemPhần 25.3.4).

Chỉ định rằng khe kèo bóng đá hom nay chép được đặt tên bởi--slotTùy chọn nên được tạo trước khi bắt đầu bản kèo bóng đá hom nay. Một lỗi được nêu ra nếu khe cắm đã tồn tại.

Đặt nhãn cho bản kèo bóng đá hom nay. Nếu không được chỉ định, giá trị mặc định làkèo bóng đá hom nay cơ sở PG_Basebackup”sẽ được sử dụng.

Theo mặc định, khipg_basebackupHủy bỏ với lỗi, nó loại bỏ bất kỳ thư mục nào mà nó có thể đã tạo trước khi phát hiện ra rằng nó kèo bóng đá hom nay thể hoàn thành công việc (ví dụ: thư mục đích và thư mục nhật ký viết). Tùy chọn này ức chế việc dọn dẹp và do đó hữu ích cho việc gỡ lỗi.

kèo bóng đá hom nay ý rằng các thư mục không gian bảng không được làm sạch cả hai cách.

Theo mặc định,pg_basebackupSẽ 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_basebackupĐể quay lại mà không chờ đợi, điều này nhanh hơn, nhưng có nghĩa là một sự cố hệ điều hành tiếp theo có thể khiến bản kèo bóng đá hom nay cơ sở 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.

Cho phép báo cáo tiến độ. Bật này sẽ cung cấp một báo cáo tiến độ gần đúng trong quá trình kèo bóng đá hom nay.100%. Cụ thể, khi nhật ký Wal được bao gồm trong bản kèo bóng đá hom nay, tổng lượng dữ liệu không thể được ước tính trước và trong trường hợp này, kích thước mục tiêu ước tính sẽ tăng lên khi nó vượt qua tổng ước tính mà không có wal.

Đặt tốc độ truyền tối đa mà tại đó dữ liệu được thu thập từ máy chủ nguồn. Điều này có thể hữu ích để hạn chế tác động củapg_basebackupTrên máy chủ. Giá trị là tính bằng kilobyte mỗi giây.MĐể chỉ ra megabyte mỗi giây. Một hậu tố củaKcũng được chấp nhận và kèo bóng đá hom nay có hiệu lực. Giá trị hợp lệ là từ 32 kilobyte mỗi giây và 1024 megabyte mỗi giây.

Tùy chọn này luôn ảnh hưởng đến việc chuyển thư mục dữ liệu. Chuyển các tệp Wal chỉ bị ảnh hưởng nếu phương thức thu thập làFetch.

Tùy chọn này chỉ có thể được sử dụng cùng với-x luồng. Nó làm cho phát trực tuyến WAL để sử dụng khe kèo bóng đá hom nay chép được chỉ định.chính_SLOT_NAME. Điều này đảm bảo rằng máy chủ chính không xóa bất kỳ dữ liệu WAL cần thiết nào trong thời gian giữa cuối bản kèo bóng đá hom nay cơ sở và bắt đầu sao chép phát trực tuyến trên chế độ chờ mới.

Khe kèo bóng đá hom nay chép được chỉ định phải tồn tại trừ khi tùy chọn-Ccũng được sử dụng.

Nếu tùy chọn này không được chỉ định và máy chủ hỗ trợ các khe kèo bóng đá hom nay chép tạm thời (phiên bản 10 trở lên), thì một khe kèo bóng đá hom nay chép tạm thời được sử dụng tự động để phát trực tuyến Wal.

Khi được đặt thànhfsync, là mặc định,pg_basebackupsẽ mở đệ quy và đồng bộ hóa tất cả các tệp trong thư mục kèo bóng đá hom nay. 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,SyncfsCó 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 chứa thư mục kèo bóng đá hom nay. Khi định dạng đơn giản được sử dụng,pg_basebackupcũng sẽ đồng bộ hóa các hệ thống tệp chứa các tệp WAL và từng kèo bóng đá hom nay 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ụngSyncfs.

Tùy chọn này kèo bóng đá hom nay có hiệu lực khi--no-syncđược sử dụng.

Cho phép chế độ Verbose. Sẽ xuất một số bước bổ sung trong quá trình khởi động và tắt, cũng như hiển thị tên tệp chính xác hiện đang được xử lý nếu báo cáo tiến độ cũng được bật.

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 đá hom nay. Hiện tại, các thuật toán có sẵn làkèo bóng đá hom nay, CRC32C, SHA224, SHA256, SHA384vàSHA512. Mặc định làCRC32C.

nếukèo bóng đá hom nayđược chọn, bảng kê khai kèo bóng đá hom nay sẽ không chứa bất kỳ tổng kiểm tra nào. Mặt khác, nó sẽ chứa một tổng kiểm tra của mỗi tệp trong bản kèo bóng đá hom nay bằng thuật toán được chỉ định.SHA256Kiểm tra nội dung của chính nó. TheSHAThuật toán có độ sâu CPU hơn đáng kể so vớiCRC32C, vì vậy chọn một trong số chúng có thể tăng thời gian cần thiết để hoàn thành bản kèo bóng đá hom nay.

Sử dụng hàm băm SHA cung cấp tiêu hóa bảo mật bằng mã hóa của mỗi tệp cho người dùng muốn xác minh rằng bản kèo bóng đá hom nay chưa bị giả mạo, trong khi thuật toán CRC-32C cung cấp tổng kiểm tra nhanh hơn nhiều để tính toán; Nó là tốt trong việc bắt các lỗi do thay đổi tình cờ nhưng không chống lại các sửa đổi độc hại.

pg_verifybackupCó thể được sử dụng để kiểm tra tính toàn vẹn của bản kèo bóng đá hom nay so với bản kèo bóng đá hom nay bản kèo bóng đá hom nay.

buộc tất cả các tên tệp trong bản kèo bóng đá hom nay được mã hóa hex. Nếu tùy chọn này không được chỉ định, chỉ có tên tệp không phải UTF8 được mã hóa hex.

Ngăn chặn máy chủ ước tính tổng lượng dữ liệu kèo bóng đá hom nay sẽ được truyền phát, dẫn đếnBackup_TotalCột trongXem luôn luônnull.

Không có tùy chọn này, bản kèo bóng đá hom nay sẽ bắt đầu bằng cách liệt kê kích thước của toàn bộ cơ sở dữ liệu, sau đó quay lại và gửi nội dung thực tế. Điều này có thể làm cho bản kèo bóng đá hom nay mất nhiều thời gian hơn một chút và đặc biệt sẽ mất nhiều thời gian hơn trước khi dữ liệu đầu tiên được gửi.

Tùy chọn này kèo bóng đá hom nay được phép khi sử dụng-ProTrogress.

Vô số thế hệ của một bản kèo bóng đá hom nay bản kèo bóng đá hom nay. Nếu tùy chọn này không được chỉ định, máy chủ sẽ tạo và gửi một bản kèo bóng đá hom nay có thể được xác minh bằng cách sử dụngpg_verifybackup. Bản kê khai là danh sách mọi tệp có trong bản kèo bóng đá hom nay ngoại trừ bất kỳ tệp WAL nào có thể được bao gồm.

Ngăn chặn việc tạo ra một khe sao chép tạm thời cho bản kèo bóng đá hom nay.

Theo mặc định, nếu phát trực tuyến nhật ký được chọn nhưng kèo bóng đá hom nay có tên khe nào được đưa ra với-STùy chọn, sau đó là một khe kèo bóng đá hom nay chép tạm thời được tạo (nếu được hỗ trợ bởi máy chủ nguồn).

Mục đích chính của tùy chọn này là cho phép lấy bản kèo bóng đá hom nay cơ sở khi máy chủ không có khe cắm sao chép miễn phí. Sử dụng một khe sao chép hầu như luôn luôn được ưu tiên, bởi vì nó ngăn chặn cần thiết mà WAL cần bị loại bỏ trong quá trình kèo bóng đá hom nay.

Vô hiệu hóa xác minh tổng kiểm tra, nếu chúng được bật trên máy chủ, bản kèo bóng đá hom nay cơ sở được lấy từ.

Theo mặc định, tổng kiểm tra được xác minh và các lỗi kiểm tra sẽ dẫn đến trạng thái thoát khác không. Tuy nhiên, bản kèo bóng đá hom nay cơ sở sẽ không bị xóa trong trường hợp như vậy, như thể--no-CleanTùy chọn đã được sử dụng. Lỗi xác minh tổng kiểm tra cũng sẽ được báo cáo trongpg_stat_databaseXem.

Chỉ định các tham số được sử dụng để kết nối với máy chủ, dưới dạngchuỗi kết nối; Chúng sẽ ghi đè bất kỳ tùy chọn dòng lệnh xung đột nào.

Tùy chọn này được gọi là--DBNAMEĐể thống nhất với các ứng dụng khách khác, nhưng vìpg_basebackupkèo bóng đá hom nay kết nối với bất kỳ cơ sở dữ liệu cụ thể nào trong cụm, bất kỳ tên cơ sở dữ liệu nào có trong chuỗi kết nối sẽ bị máy chủ bỏ qua. Tuy nhiên, tên cơ sở dữ liệu được cung cấp theo cách đó ghi đè tên cơ sở dữ liệu mặc định (kèo bóng đá hom nay chép) cho mục đích tìm kiếm mật khẩu của kết nối kèo bóng đá hom nay chép trong~/.pgass. Tương tự, phần mềm trung gian hoặc proxy được sử dụng trong kết nối vớiPostgreSQLCó thể sử dụng tên cho các mục đích như định tuyến kết nối. Tên cơ sở dữ liệu cũng có thể được sử dụng bởiĐồng bộ hóa khe kèo bóng đá hom nay chép logic.

Chỉ định tên máy chủ của máy mà máy chủ đang chạy. Nếu giá trị bắt đầu bằng một dấu gạch chéo, nó được sử dụng làm thư mục cho ổ cắm miền UNIX.PGHOSTBiến môi trường, nếu được đặt, khác là một kết nối ổ cắm miền Unix được thử.

Chỉ định cổng TCP hoặc phần mở rộng tệp ổ cắm tên miền UNIX cục bộ mà máy chủ đang nghe cho các kết nối. Mặc định làPGPORTBiến môi trường, nếu được đặt hoặc mặc định được biên dịch.

Chỉ định số giây giữa các gói trạng thái được gửi lại cho máy chủ nguồn. Các giá trị nhỏ hơn cho phép giám sát chính xác hơn về tiến trình kèo bóng đá hom nay từ máy chủ.

Chỉ định tên người dùng để kết nối như.

Ngăn chặn việc phát hành một dấu nhắc mật khẩu. Nếu máy chủ yêu cầu xác thực mật khẩu và mật khẩu kèo bóng đá hom nay có sẵn bằng các phương tiện khác như.pgassTệp, nỗ lực kết nối sẽ kèo bóng đá hom nay thành công. Tùy chọn này có thể hữu ích trong các công việc và tập lệnh hàng loạt trong đó kèo bóng đá hom nay có người dùng nào để nhập mật khẩu.

Lực lượngpg_basebackupĐể nhắc mật khẩu trước khi kết nối với máy chủ nguồn.

Tùy chọn này kèo bóng đá hom nay bao giờ cần thiết, vìpg_basebackupSẽ tự động nhắc mật khẩu nếu máy chủ yêu cầu xác thực mật khẩu. Tuy nhiên,pg_basebackupSẽ lãng phí một nỗ lực kết nối để tìm ra rằng máy chủ muốn có mật khẩu. Trong một số trường hợp, nó đáng để gõ-WĐể tránh nỗ lực kết nối thêm.

inpg_basebackupPhiên bản và thoát.

Hiển thị trợ giúp vềpg_basebackupĐối số dòng lệnh và thoát.