14017_14069pg_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 đá pháp tồn tại. Nếu nó đã tồn tại, nó phải trống.

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

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:

Tạo Astandby.signal Tệp 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 đá pháp.

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 đá pháp chéppg_basebackupđang sử dụng, do đó kèo bóng đá pháp chép phát trực tuyến sẽ sử dụng cùng một cài đặt sau này.

Hướng dẫn máy chủ nơi đặt bản kèo bóng đá pháp cơ sở. Mục tiêu mặc định làClient, trong đó chỉ định rằng kèo bóng đá pháp 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 đá pháp 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 đá pháp 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 đá pháp 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 đá pháp 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 đá pháp gian bảng trong thư mụcOlddirđếnNewDirTrong quá trình kèo bóng đá pháp. Để 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 đá pháp gian bảng vì nó được xác định trên máy chủ nguồn. (Nhưng đó kèo bóng đá pháp phải là lỗi nếu kèo bóng đá pháp có kèo bóng đá pháp 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 đá pháp cần tồn tại, nhưng nếu nó tồn tại thì nó phải trống. Cả haiOlddirvà20140_20148phả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 đá pháp gian bảng.

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

20925_21030pg_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 đường dẫn 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 đá pháp ở định dạng đơn giản.

Bao gồm các tệp WAL (Viết nhật ký viết) cần thiết trong bản kèo bóng đá pháp. Đ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 đá pháp. Trừ khi phương thứckèo bóng đá pháp21920_22097

sau đâyPhươ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 đá pháp. Nếu nhưclienthoặcMáy chủđược bao gồm, nó chỉ định nơi nén sẽ được thực hiệ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ủ. Mặc định làclientngoại trừ khi--Targetđược sử dụng. Trong trường hợp đó, bản kèo bóng đá pháp không được gửi đến máy khách, vì vậy chỉ có nén máy chủ là hợp lý. Khi-XStream, là mặc định, được sử dụng, nén phía máy chủ sẽ kèo bóng đá pháp đượ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, zstdhoặckèo bóng đá phápkèo bóng đá pháp nén. Một chuỗi chi tiết nén có thể được chỉ định tùy chọn. Nếu chuỗi chi tiết là một số nguyên, nó chỉ định mức nén. Nếu kèo bóng đá pháp, nó phải là một danh sách các mục được phân tách bằng dấu phẩy, mỗi mẫuTừ khóahoặcTừ khóa = value. Hiện tại, các từ khóa được hỗ trợ làCấpvàCông nhân.

Nếu kèo bóng đá pháp 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 đá pháp đề 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 đá pháp 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ể không được chỉ định, nhưng vẫn có thể yêu cầu nén phía máy chủ. Nếu điều này được thực hiện, máy chủ sẽ nén bản kèo bóng đá pháp để truyền và máy khách sẽ giải nén và trích xuất nó.

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 đá pháp đượ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 26.3.3).

Chỉ định rằng khe kèo bóng đá pháp 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 đá pháp. 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 đá pháp. Nếu không được chỉ định, giá trị mặc định làPG_BASEBACKUP SACKUP”sẽ được sử dụng.

Theo mặc định, khipg_basebackupHủy bỏ với một 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 đá pháp thể hoàn thành công việc (ví dụ: thư mục đích và thư mục nhật ký ghi). 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 đá pháp ý 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 ghi an toàn vào đĩa. Tùy chọn này gây rapg_basebackup30438_30679

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 đá pháp. Vì cơ sở dữ liệu có thể thay đổi trong quá trình kèo bóng đá pháp, đây chỉ là một xấp xỉ và có thể không kết thúc chính xác100%. Cụ thể, khi nhật ký Wal được bao gồm trong bản kèo bóng đá pháp, 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 độ chuyể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. Sử dụng hậu tố củaMĐể 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 đá pháp 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.

32092_32220Fetch.

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 sao chép được chỉ định. Nếu bản kèo bóng đá pháp cơ sở được dự định sẽ được sử dụng làm chế độ chờ sao chép phát trực tuyến bằng cách sử dụng khe saochí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 đá pháp 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 đá pháp chép được chỉ định phải tồn tại trừ khi tùy chọn-Ccũng được sử dụng.

33274_33458

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

nếukèo bóng đá phápđược chọn, bản kèo bóng đá pháp 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 đá pháp bằng thuật toán được chỉ định. Ngoài ra, bản kê khai sẽ luôn chứaSHA256Kiểm tra nội dung của chính nó. TheSHA34804_34860CRC32C, 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 đá pháp.

34992_35548

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

Lực lượng tất cả các tên tệp trong bản kèo bóng đá pháp bản kèo bóng đá pháp đượ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. Tùy chọn này chủ yếu nhằm kiểm tra các công cụ đọc tệp bản kèo bóng đá pháp xử lý đúng trường hợp này.

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

36618_36943

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

Vô hiệu hóa việc tạo 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, máy chủ sẽ tạo và gửi một bản kèo bóng đá pháp 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 đá pháp ngoại trừ bất kỳ tệp WAL nào có thể được bao gồm. Nó cũng lưu trữ kích thước, thời gian sửa đổi cuối cùng và kiểm tra tùy chọn cho mỗi tệp.

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 đá pháp.

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

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 đá pháp 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ông phải. Tuy nhiên, bản kèo bóng đá pháp 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 đượ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 đá pháp 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 trong chuỗi kết nối sẽ bị bỏ qua.

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. Mặc định được lấy từPGHOST40582_40665

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 đá pháp từ máy chủ. Giá trị của số 0 vô hiệu hóa hoàn toàn các cập nhật trạng thái định kỳ, mặc dù bản cập nhật vẫn sẽ được gửi khi được máy chủ yêu cầu, để tránh ngắt kết nối dựa trên thời gian chờ. Giá trị mặc định là 10 giây.

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 đá pháp 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 đá pháp 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 đá pháp 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 đá pháp 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.