Đặ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ó tỷ lệ kèo bóng đá tồn tại. Nếu nó đã tồn tại, nó phải trống.

Khi bản tỷ lệ kèo bóng đá ở đị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ệntỷ lệ kèo bóng đá gia tăng. Biện bản tỷ lệ kèo bóng đá cho bản tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá gia tăng được yêu cầu.

Tạo Astandby.signal Cài đặt kết nối tệp và 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 tỷ lệ kèo bóng đá.

ThePostgreSql.Auto.confTệp sẽ ghi lại các cài đặt kết nối và, nếu được chỉ định, khe tỷ lệ kèo bóng đá chéppg_basebackupđang sử dụng, do đó tỷ lệ kèo bóng đá chép phát trực tuyến vàĐồng bộ hóa khe tỷ lệ kèo bóng đá 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ặcPostgresql: Tài.

Hướng dẫn máy chủ nơi đặt bản tỷ lệ kèo bóng đá cơ sở. Mục tiêu mặc định làclient, trong đó chỉ định rằng tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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ữ tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá gian bảng trong thư mụcOlddirđếnNewDirTrong quá trình tỷ lệ kèo bóng đá. Để có hiệu quả,Olddirphải khớp chính xác với đặc tả đường dẫn của tỷ lệ kèo bóng đá gian bảng vì nó được xác định trên máy chủ nguồn. (Nhưng đó tỷ lệ kèo bóng đá phải là lỗi nếu tỷ lệ kèo bóng đá có tỷ lệ kèo bóng đá 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,NewDirtỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá gian bảng.

Nếu một tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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.

23104_23209pg_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 tỷ lệ kèo bóng đá ở định dạng đơn giản.

Bao gồm các tệp WAL (nhật ký ghi nhận) yêu cầu trong bản tỷ lệ kèo bóng đá. Đ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 tỷ lệ kèo bóng đá.tỷ lệ kèo bóng đá24099_24276

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 tỷ lệ kèo bóng đá. 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 tỷ lệ kèo bóng đá 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ẽ tỷ lệ kèo bóng đá đượ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, tỷ lệ kèo bóng đátỷ lệ kèo bóng đá có nén hoặc số nguyên (tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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à tỷ lệ kèo bóng đá đề 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ẽ tỷ lệ kèo bóng đá 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ể tỷ lệ kèo bóng đá đượ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ẽ tỷ lệ kèo bóng đá đượ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 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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá. Một lỗi được nêu ra nếu khe cắm đã tồn tại.

Đặt nhãn cho bản tỷ lệ kèo bóng đá. Nếu không được chỉ định, giá trị mặc định làHồitỷ lệ kèo bóng đá cơ sở PG_BasebackupHồisẽ được sử dụng.

Theo mặc định, khipg_basebackup32167_32422

tỷ lệ kèo bóng đá ý 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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá.100%. Cụ thể, khi nhật ký Wal được bao gồm trong bản tỷ lệ kèo bóng đá, 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à tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá cơ sở và bắt đầu sao chép phát trực tuyến trên chế độ chờ mới.

Khe tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá chép tạm thời (phiên bản 10 trở lên), thì một khe tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá. 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 tỷ lệ kèo bóng đá. 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à mỗi tỷ lệ kèo bó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ụngSyncfs.

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

nếutỷ lệ kèo bóng đáđược chọn, bản tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá.

Sử dụng hàm băm SHA cung cấp một bản 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 tỷ lệ kèo bóng đá chưa bị giả mạo, trong khi thuật toán CRC32C 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.

PostgreSQL: TàiCó thể được sử dụng để kiểm tra tính toàn vẹn của bản tỷ lệ kèo bóng đá so với bản tỷ lệ kèo bóng đá bản tỷ lệ kèo bóng đá.

Lực lượng tất cả các tên tệp trong bản tỷ lệ kèo bóng đá bản tỷ lệ kèo bóng đá đượ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 số lượng dữ liệu tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá được phép khi sử dụng-ProTrogress.

Vô hiệu hóa thế hệ của một bản tỷ lệ kèo bóng đá bản tỷ lệ kèo bóng đá. 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 tỷ lệ kèo bóng đá có thể được xác minh bằng cách sử dụngPostgreSQL: Tài. Bản kê khai là danh sách mọi tệp có trong bản tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá.

Theo mặc định, nếu phát trực tuyến nhật ký được chọn nhưng tỷ lệ kèo bóng đá có tên khe nào được đưa ra với-STùy chọn, sau đó một khe tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá.

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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá cơ sở sẽ không bị xóa trong trường hợp như vậy, như thể--KHÔNG 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_basebackuptỷ lệ kèo bóng đá 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 (tỷ lệ kèo bóng đá chép) cho mục đích tìm kiếm mật khẩu của kết nối tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá có sẵn bằng các phương tiện khác như.pgassTệp, nỗ lực kết nối sẽ tỷ lệ kèo bóng đá 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 đó tỷ lệ kèo bóng đá 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 tỷ lệ kèo bóng đá 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.

pg_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.