pg_basebackup - Lấy bản kèo bóng đá c1 cơ sở của APOSTGRESQLcụm
pg_basebackup
[Tùy chọn
...]
pg_basebackupđược sử dụng để lấy bản kèo bóng đá c1 cơ sở của việc chạyPostgreSQLCụm cơ sở dữ liệu. Bản kèo bóng đá c1 được thực hiện mà không ảnh hưởng đến các máy khách khác của cơ sở dữ liệu và có thể được sử dụng cả để phục hồi thời gian (xemPhần 25.3) và là điểm bắt đầu cho máy chủ dự phòng vận chuyển hoặc phát trực tuyến (xemPhần 26.2).
pg_basebackupTạo một bản sao chính xác của các tệp của cụm cơ sở dữ liệu, đồng thời đảm bảo tự động được đặt máy chủ vào chế độ kèo bóng đá c1. kèo bóng đá c1 luôn được thực hiện của toàn bộ cụm cơ sở dữ liệu; Không thể kèo bóng đá c1 các cơ sở dữ liệu hoặc đối tượng cơ sở dữ liệu riêng lẻ. Đối với các bản kèo bóng đá c1 chọn lọc, một công cụ khác nhưpg_dumpphải được sử dụng.
bản kèo bóng đá c1 được thực hiện trên một thông thườngPostgreSQLKết nối sử dụng giao thức kèo bóng đá c1 chép. Kết nối phải được thực hiện với ID người dùng cókèo bóng đá c1 chép
quyền (xemPhần 21.2) Hoặc là một siêu người dùng vàpg_hba.conf
Phải cho phép kết nối kèo bóng đá c1 chép. Máy chủ cũng phải được cấu hình vớiMAX_WAL_SENDERSĐặt đủ cao để cung cấp ít nhất một Walsender cho bản kèo bóng đá c1 cộng với một phát trực tuyến (nếu được sử dụng).
Có thể có nhiềupg_basebackup
11163_11296
pg_basebackupcó thể tạo bản kèo bóng đá c1 cơ sở từ không chỉ một máy chủ chính mà còn là chế độ chờ. Để có một bản kèo bóng đá c1 từ chế độ chờ, hãy thiết lập chế độ chờ để có thể chấp nhận kết nối sao chép (nghĩa là đặtMAX_WAL_SENDERS
vàhot_standby, và định cấu hình của nópg_hba.conf
một cách thích hợp). Bạn cũng sẽ cần phải bậtfull_page_writestrên chính.
Lưu ý rằng có một số hạn chế trong việc kèo bóng đá c1 từ chế độ chờ:
Tệp lịch sử kèo bóng đá c1 không được tạo trong cụm cơ sở dữ liệu được kèo bóng đá c1.
pg_basebackupKhông thể buộc dự phòng chuyển sang tệp WAL mới ở cuối bản kèo bóng đá c1. Khi bạn đang sử dụng-x none
, Nếu ghi hoạt động trên chính là thấp,pg_basebackupCó thể cần phải đợi một thời gian dài cho tệp WAL cuối cùng cần thiết để bản kèo bóng đá c1 được chuyển đổi và lưu trữ. Trong trường hợp này, có thể hữu ích khi chạypg_switch_wal
Trên chính để kích hoạt công tắc tệp WAL ngay lập tức.
Nếu dự phòng được quảng bá là chính trong quá trình kèo bóng đá c1, bản kèo bóng đá c1 không thành công.
Tất cả các bản ghi WAL cần thiết cho bản kèo bóng đá c1 phải chứa đầy đủ các ghi toàn trang, yêu cầu bạn bậtfull_page_writes
Trên chính và kèo bóng đá c1 sử dụng một công cụ nhưpg_compresslogASArchive_Command
Để xóa ghi toàn trang khỏi các tệp wal.
Bất cứ khi nàopg_basebackupĐang lấy bản kèo bóng đá c1 cơ sở, máy chủXem sẽ báo cáo tiến trình của bản kèo bóng đá c1. Nhìn thấyPhần 27.4.5Để biết chi tiết.
Tùy chọn dòng lệnh sau đây kiểm soát vị trí và định dạng của đầu ra:
-DThư mục
-pgdata =Thư mục
Đặ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 đá c1 tồn tại. Nếu nó đã tồn tại, nó phải trống.
Khi bản kèo bóng đá c1 ở đị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.
-fĐịnh dạng
-format =Định dạng
Chọn định dạng cho đầu ra.Định dạng
có thể là một trong những điều sau:
P
trơn
Viết đầu ra dưới dạng các tệp đơn giản, với bố cục tương tự như thư mục và kèo bóng đá c1 gian bảng dữ liệu của máy chủ nguồn. Khi cụm kèo bóng đá c1 có kèo bóng đá c1 gian bảng bổ sung, toàn bộ cơ sở dữ liệu sẽ được đặt trong thư mục đích. Nếu cụm chứa các kèo bóng đá c1 gian bảng bổ sung, thư mục dữ liệu chính sẽ được đặt trong thư mục đích, nhưng tất cả các kèo bóng đá c1 gian bảng khác sẽ được đặt trong cùng một đường dẫn tuyệt đối như chúng có trên máy chủ nguồn. (Nhìn thấy--TableSpace-mapping
Để thay đổi điều đó.)
Đây là định dạng mặc định.
T
tar
Viết đầu ra dưới dạng tệp tar trong thư mục đích. Nội dung của thư mục dữ liệu chính sẽ được ghi vào một tệp có tênbase.tar
16268_16371
Nếu thư mục đích được chỉ định là-
(Dash), Nội dung tar sẽ được ghi vào đầu ra tiêu chuẩn, phù hợp để đường ống đến (ví dụ)gzip. Điều này chỉ được phép nếu cụm kèo bóng đá c1 có kèo bóng đá c1 gian bảng bổ sung và kèo bóng đá c1 sử dụng phát trực tuyến Wal.
-R
--write-recovery-conf
Tạo Astandby.signal
Cài đặt kết nối tệp và nối vàoPostgresql.auto.conf
Tệ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 đá c1.
ThePostgreSql.Auto.conf
Tệ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 đá c1 chéppg_basebackupđang sử dụng, do đó kèo bóng đá c1 chép phát trực tuyến sẽ sử dụng cùng một cài đặt sau này.
-TOlddir
=NewDir
--TableSpace-mapping =Olddir
=NewDir
di chuyển kèo bóng đá c1 gian bảng trong thư mụcOlddir
đếnNewDir
Trong quá trình kèo bóng đá c1. Để có hiệu quả,Olddir
phải khớp chính xác với đặc tả đường dẫn của kèo bóng đá c1 gian bảng vì nó được xác định trên máy chủ nguồn. (Nhưng đó kèo bóng đá c1 phải là lỗi nếu kèo bóng đá c1 có kèo bóng đá c1 gian bảng trongOlddir
Trên máy chủ nguồn.) Trong khi đóNewDir
là 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,NewDir
kèo bóng đá c1 cần tồn tại, nhưng nếu nó tồn tại thì nó phải trống. Cả haiOlddir
vàNewDir
phả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 đá c1 gian bảng.
Nếu một kèo bóng đá c1 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 đá c1 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.
--waldir =Waldir
Đặ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_wal
thư 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.Waldir
phải là một con đường tuyệt đối. Như với thư mục mục tiêu chính,Waldir
Khô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 đá c1 ở định dạng đơn giản.
-xPhương pháp
--wal-method =Phương pháp
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 đá c1. Đ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 đá c1. Trừ khi phương thứckèo bóng đá c1
20662_20839
sau đâyPhương pháp
S để thu thập các bản ghi ghi lại được hỗ trợ:
n
kèo bóng đá c1
Không bao gồm nhật ký ghi trong bản kèo bóng đá c1.
f
Fetch
Các tệp nhật ký ghi lại được thu thập ở cuối bản kèo bóng đá c1. Do đó, nó là cần thiết cho máy chủ nguồnwal_keep_sizeTham số được đặt đủ cao để dữ liệu nhật ký cần thiết không được xóa trước khi kết thúc bản kèo bóng đá c1. Nếu dữ liệu nhật ký cần thiết đã được tái chế trước khi đến lúc chuyển nó, bản kèo bóng đá c1 sẽ thất bại và không thể sử dụng được.
Khi định dạng TAR được sử dụng, các tệp nhật ký ghi lại sẽ được bao gồm trongbase.tar
Tệp.
S
Stream
Dữ liệu ghi ghi ghi âm trong khi bản kèo bóng đá c1 đang được thực hiện. Phương thức này sẽ mở kết nối thứ hai đến máy chủ và bắt đầu phát trực tuyến nhật ký ghi lại song song trong khi chạy bản kèo bóng đá c1. Do đó, nó sẽ yêu cầu hai kết nối sao chép không chỉ một. Miễn là máy khách có thể theo kịp dữ liệu nhật ký ghi lại, sử dụng phương thức này không yêu cầu nhật ký ghi lại thêm để được lưu trên máy chủ nguồn.
Khi định dạng TAR được sử dụng, các tệp nhật ký ghi lại sẽ được ghi vào một tệp riêng biệt có tênpg_wal.tar
(Nếu máy chủ là phiên bản sớm hơn 10, tệp sẽ được đặt tênpg_xlog.tar
).
Giá trị này là mặc định.
-z
--gzip
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ố.gz
Sẽ tự động được thêm vào tất cả các tên tệp tar.
-zCấp
--compress =Cấp
Cho phép nén GZIP của đầu ra tệp TAR và chỉ định mức nén (0 đến 9, 0 kèo bóng đá c1 nén và 9 là nén tốt nhất). Nén chỉ khả dụng khi sử dụng định dạng TAR và hậu tố.gz
sẽ tự động được thêm vào tất cả các tên tệp tar.
Tùy chọn dòng lệnh sau đây kiểm soát việc tạo bản kèo bóng đá c1 và gọi chương trình:
-Cnhanh | lan truyền
--CheckPoint =Fast | Trải
Đặ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.3).
-C
--Create-slot
Chỉ định rằng khe kèo bóng đá c1 chép được đặt tên bởi--slot
Tùy chọn nên được tạo trước khi bắt đầu bản kèo bóng đá c1. Một lỗi được nêu ra nếu khe cắm đã tồn tại.
-Lnhãn
--Label =nhãn
Đặt nhãn cho bản kèo bóng đá c1. Nếu không được chỉ định, giá trị mặc định làkèo bóng đá c1 cơ sở PG_Basebackup
Hồisẽ được sử dụng.
-N
--no-Clean
Theo mặc định, khipg_basebackup
Hủ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 đá c1 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 đá c1 ý rằng các thư mục không gian bảng không được làm sạch bằng cách nào.
-N
--no-sync
Theo mặc định,pg_basebackup
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_basebackup
Để 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 đá c1 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.
-P
-ProTrogress
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 đá c1. Vì cơ sở dữ liệu có thể thay đổi trong quá trình kèo bóng đá c1, đâ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 đá c1, 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.
-RRATE
--Max-Rate =Rate
Đặ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. Sử dụng hậu tố củaM
Để chỉ ra megabyte mỗi giây. Một hậu tố củaK
cũng được chấp nhận và kèo bóng đá c1 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
.
-Sslotname
-slot =slotname
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 đá c1 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 đá c1 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 đá c1 chép được chỉ định phải tồn tại trừ khi tùy chọn-C
cũ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 đá c1 chép tạm thời (phiên bản 10 trở lên), thì một khe kèo bóng đá c1 chép tạm thời được sử dụng tự động để phát trực tuyến Wal.
-V
--Verbose
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.
--Manifest-Checksums =Thuật toán
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 đá c1 bản kèo bóng đá c1. Hiện tại, các thuật toán có sẵn làkèo bóng đá c1
, CRC32C
, SHA224
, SHA256
, SHA384
vàSHA512
. Mặc định làCRC32C
.
nếukèo bóng đá c1
được chọn, bản kèo bóng đá c1 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 đá c1 bằng thuật toán được chỉ định. Ngoài ra, bản kê khai sẽ luôn chứaSHA256
Kiểm tra nội dung của chính nó. TheSHA
Thuật toán có tính chuyên 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 đá c1.
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 đá c1 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. Lưu ý rằng, để có ích đối với một kẻ thù có quyền truy cập vào bản kèo bóng đá c1, bản kèo bóng đá c1 sẽ cần được lưu trữ an toàn ở nơi khác hoặc được xác minh không được sửa đổi kể từ khi kèo bóng đá c1 được thực hiện.
pg_verifybackupcó thể được sử dụng để kiểm tra tính toàn vẹn của bản kèo bóng đá c1 so với bản kèo bóng đá c1 bản kèo bóng đá c1.
buộc tất cả các tên tệp trong bản kèo bóng đá c1 đượ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 đá c1 xử lý đúng trường hợp này.
--no-estimate-size
Ngăn chặn máy chủ ước tính tổng lượng dữ liệu kèo bóng đá c1 sẽ được truyền phát, dẫn đếnBackup_Total
Cột trongPG_STAT_PROTERS_BASEBACKUP
Xem luôn luôn lànull
.
Không có tùy chọn này, bản kèo bóng đá c1 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 đá c1 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 rất hữu ích để tránh thời gian ước tính như vậy nếu quá dài.
Tùy chọn này kèo bóng đá c1 được phép khi sử dụng-ProTrogress
.
--no-Manifest
Vô hiệu hóa việc tạo một bản kèo bóng đá c1 bản kèo bóng đá c1. 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 đá c1 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 đá c1 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.
--no-slot
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 đá c1.
Theo mặc định, nếu phát trực tuyến nhật ký được chọn nhưng kèo bóng đá c1 có tên khe nào được đưa ra với-S
Tùy chọn, sau đó là một khe kèo bóng đá c1 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 đá c1 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 đá c1.
--kèo bóng đá c1-Verify-Checksums
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 đá c1 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 đá c1 cơ sở sẽ không bị xóa trong trường hợp như vậy, như thể--KHÔNG CLEAN
Tù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_DATABASE
Xem.
Tùy chọn dòng lệnh sau đây kiểm soát kết nối với máy chủ nguồn:
-DConnstr
--dbname =Connstr
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 đá c1 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.
-Hhost
--host =host
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ừPGHOST
Biế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ử.
-PCổng
--Port =Cổng
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àPGPORT
Biến môi trường, nếu được đặt hoặc mặc định được biên dịch.
-SKhoảng
--status-interval =Khoảng
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 đá c1 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.
-Utên người dùng
--Username =tên người dùng
Chỉ định tên người dùng để kết nối như.
-W
--no-password
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 đá c1 có sẵn bằng các phương tiện khác như.pgass
Tệp, nỗ lực kết nối sẽ kèo bóng đá c1 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 đá c1 có người dùng nào để nhập mật khẩu.
-W
--password
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 đá c1 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.
Các tùy chọn khác cũng có sẵn:
-V
--Version
inpg_basebackupPhiên bản và thoát.
-?
--Help
Hiển thị trợ giúp vềpg_basebackupĐối số dòng lệnh và thoát.
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 33,14).
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 kèo bóng đá c1. Các giá trị có thể làluôn luôn
, Auto
vàkèo bóng đá c1 bao giờ
.
Khi bắt đầu kèo bóng đá c1, điểm kiểm tra cần được thực hiện trên máy chủ nguồn. Điều này có thể mất một thời gian (đặc biệt là nếu tùy chọn--CheckPoint = Fast
kèo bóng đá c1 được sử dụng), trong đópg_basebackupsẽ xuất hiện kèo bóng đá c1 hoạt động.
Bản kèo bóng đá c1 sẽ bao gồm tất cả các tệp trong thư mục dữ liệu và không gian bảng, bao gồm các tệp cấu hình và bất kỳ tệp bổ sung nào được đặt trong thư mục của các bên thứ ba, ngoại trừ một số tệp tạm thời được quản lý bởi PostgreSQL. Nhưng chỉ các tệp và thư mục thông thường được sao chép, ngoại trừ các liên kết tượng trưng được sử dụng cho các không gian bảng được bảo tồn. Các liên kết tượng trưng chỉ ra một số thư mục nhất định được biết đến với PostgreSQL được sao chép dưới dạng thư mục trống. Các liên kết tượng trưng khác và các tập tin thiết bị đặc biệt được bỏ qua. Nhìn thấyPhần 52.4Để biết chi tiết chính xác.
Ở định dạng đơn giản, các không gian bảng sẽ được kèo bóng đá c1 theo cùng một đường dẫn họ có trên máy chủ nguồn, trừ khi tùy chọn--TableSpace-mapping
được sử dụng. Nếu không có tùy chọn này, chạy một bản kèo bóng đá c1 cơ sở định dạng đơn giản trên cùng một máy chủ với máy chủ sẽ không hoạt động nếu các không gian bảng được sử dụng, bởi vì bản kèo bóng đá c1 sẽ phải được ghi vào cùng một vị trí thư mục với các không gian bảng gốc.
Khi định dạng TAR được sử dụng, trách nhiệm của người dùng là giải nén từng tệp TAR trước khi khởi động máy chủ PostgreSQL sử dụng dữ liệu. Nếu có các kèo bóng đá c1 gian bảng bổ sung, các tệp TAR cho chúng cần được giải nén ở các vị trí chính xác. Trong trường hợp này, các liên kết tượng trưng cho các kèo bóng đá c1 gian bảng đó sẽ được tạo bởi máy chủ theo nội dung củaTablespace_Map
Tệp được bao gồm trongbase.tar
Tệp.
pg_basebackupHoạt động với các máy chủ giống nhau hoặc phiên bản chính cũ hơn, xuống 9.1. Tuy nhiên, chế độ phát trực tuyến Wal (-x luồng
) Chỉ hoạt động với phiên bản máy chủ 9.3 trở lên và định dạng TAR (-format = tar
) Chỉ hoạt động với phiên bản máy chủ 9.5 trở lên.
pg_basebackupSẽ bảo tồn quyền của nhóm cho các tệp dữ liệu nếu quyền của nhóm được bật trên cụm nguồn.
Để tạo bản kèo bóng đá c1 cơ sở của máy chủ tạiMyDbserver
và kèo bóng đá c1 trữ nó trong thư mục cục bộ/usr/local/pgsql/data
:
$
Để tạo bản kèo bóng đá c1 của máy chủ cục bộ với một tệp TAR được nén cho mỗi không gian bảng và lưu trữ nó trong thư mụckèo bóng đá c1
, Hiển thị báo cáo tiến độ trong khi đang chạy:
$
pg_basebackup -d kèo bóng đá c1 -FT -Z -P
Để tạo bản kèo bóng đá c1 của cơ sở dữ liệu cục bộ không gian đơn và nén điều này vớiBZIP2:
$
pg_basebackup -d --ft -x tìm nạp | BZIP2 kèo bóng đá c1tar.bz2
(Lệnh này sẽ thất bại nếu có nhiều kèo bóng đá c1 gian trong cơ sở dữ liệu.)
Để tạo bản kèo bóng đá c1 cơ sở dữ liệu cục bộ trong đó không gian bảng trong/opt/ts
được chuyển thành./backup/ts
:
$
Nếu bạn thấy bất cứ điều gì trong tài liệu kèo bóng đá c1 chính xác, kèo bóng đá c1 phù hợp Kinh nghiệm của bạn với tính năng cụ thể hoặc yêu cầu làm rõ thêm, Vui lòng sử dụngMẫu nàyĐể báo cáo vấn đề tài liệu.