pg_basebackupđược sử dụng để lấy Sao kèo bóng đá c1 cơ sở của một lần chạyPostgreSQLCụm cơ sở dữ kèo bóng đá c1. Những thứ này được thực hiện mà không ảnh hưởng đến các máy khách khác vào cơ sở dữ kèo bóng đá c1 và có thể được sử dụng Cả để phục hồi điểm trong thời gian (xemPhần 24.3) và khi bắt đầu chỉ cho một máy chủ dự phòng kèo bóng đá c1 chép lại hoặc phát trực tuyến các máy chủ dự phòng (nhìn thấyPhần 25.2).
pg_basebackupLàm cho một nhị phân bản sao của các tệp cụm cơ sở dữ liệu, trong khi đảm bảo hệ thống là Đặt vào và ra khỏi chế độ sao kèo bóng đá c1 tự động. Sao kèo bóng đá c1 luôn luôn lấy toàn bộ cụm cơ sở dữ liệu; Không thể sao kèo bóng đá c1 cơ sở dữ liệu riêng lẻ hoặc các đối tượng cơ sở dữ liệu. Cho cơ sở dữ liệu cá nhân bản sao kèo bóng đá c1, một công cụ nhưpg_dumpPhải được sử dụng.
bản sao kèo bóng đá c1 được thực hiện trên một thông thườngPostgreSQLKết nối và 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 một siêu nhân hoặc người dùng cókèo bóng đá c1 chépQuyền (nhìn thấyPhần 20.2) vàpg_hba.confphải cho phép rõ ràng Kết nối nhân rộng. Máy chủ cũng phải được cấu hình vớiMAX_WAL_SENDERSĐặt đủ cao để để lại ít nhất một phiên có sẵn cho hỗ trợ.
Có thể có nhiềupg_basebackups Chạy cùng một lúc, nhưng nó tốt hơn từ điểm hiệu suất xem chỉ lấy một bản sao kèo bóng đá c1 và sao chép kết quả.
pg_basebackupcó thể tạo cơ sở Sao kèo bóng đá c1 từ không chỉ Master mà còn là chế độ chờ. Để lấy a sao kèo bóng đá c1 từ chế độ chờ, thiết lập dự phòng để nó có thể chấp nhận Kết nối sao chép (nghĩa là, đặtMAX_WAL_SENDERSvàhot_standby,, và định cấu hìnhdựa trên máy chủ Xác thực). Bạn cũng sẽ cần phải bậtfull_page_writestrên chủ.
kèo bóng đá c1 ý rằng có một số hạn chế trong bản sao kèo bóng đá c1 trực tuyến từ Chế độ chờ:
Tệp lịch sử sao kèo bóng đá c1 không được tạo trong cụm cơ sở dữ liệu sao kèo bóng đá c1.
Không có gì đảm bảo rằng tất cả các tệp WAL cần thiết cho bản sao kèo bóng đá c1 được kèo bóng đá c1 trữ ở cuối bản sao kèo bóng đá c1. Nếu bạn dự định sử dụng sao kèo bóng đá c1 để phục hồi kèo bóng đá c1 trữ và muốn đảm bảo rằng tất cả các yêu cầu Các tệp có sẵn tại thời điểm đó, bạn cần đưa chúng vào bản sao kèo bóng đá c1 bằng cách sử dụng-xTùy chọn.
Nếu dự phòng được thăng cấp lên Master trong quá trình sao kèo bóng đá c1 trực tuyến, bản sao 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 sao kèo bóng đá c1 phải chứa đủ ghi toàn trang, yêu cầu bạn bậtfull_page_writesTrên chủ và kèo bóng đá c1 sử dụng công cụ giốngpg_compresslogASArchive_CommandĐể xóa các chữ viết đầy đủ từ Wal Tệp.
Tùy chọn dòng lệnh sau đây kiểm soát vị trí và Định dạng đầu ra.
Thư mục để ghi đầu ra vào.pg_basebackupsẽ tạo thư mục và bất kỳ thư mục phụ huynh nếu cần thiết. Thư mục có thể đã tồn tại, nhưng đó là một lỗi nếu thư mục đã tồn tại và là kèo bóng đá c1 trống.
Khi bản sao kèo bóng đá c1 ở chế độ TAR và thư mục được chỉ định BẰNG-(Dash), tệp tar sẽ được viết ĐẾNstdout.
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:
Viết đầu ra dưới dạng các tệp đơn giản, có cùng bố cục với Thư mục dữ kèo bóng đá c1 hiện tại và không gian bảng. Khi cụm không có các không gian bảng bổ sung, toàn bộ cơ sở dữ kèo bóng đá c1 sẽ được đặt trong Thư mục mục tiêu. Nếu cụm chứa các không gian bảng bổ sung, thư mục dữ kèo bóng đá c1 chính sẽ được đặt trong thư mục đích, nhưng Tất cả các không gian bảng khác sẽ được đặt trong cùng một con đường tuyệt đối như họ có trên máy chủ.
Đây là định dạng mặc định.
Viết đầu ra dưới dạng tệp TAR trong thư mục đích. Các chính thư mục dữ kèo bóng đá c1 sẽ được ghi vào một tệp có tênbase.tarvà tất cả các kèo bóng đá c1 gian bảng khác sẽ được đặt tên sau kèo bóng đá c1 gian bảng oid.
Nếu giá trị-(Dash) được chỉ định là Thư mục mục tiêu, nội dung tar sẽ được ghi vào tiêu chuẩn đầu ra, phù hợp để đường ống vào ví dụgzip. Điều này chỉ có thể nếu cụm có kèo bóng đá c1 có kèo bóng đá c1 gian bảng bổ sung.
Viết tối thiểurecovery.confTrong thư mục đầu ra (hoặc vào tệp kèo bóng đá c1 trữ cơ sở khi sử dụng tar Định dạng) Để dễ dàng thiết lập máy chủ dự phòng.
Sử dụng tùy chọn này tương đương với việc sử dụng-xvới phương phápFetch.
Bao gồm các tệp nhật ký giao dịch cần thiết (Tệp WAL) trong hỗ trợ. Điều này sẽ bao gồm tất cả các nhật ký giao dịch được tạo trong hỗ trợ. Nếu tùy chọn này được chỉ định, có thể bắt đầu người quản lý bưu điện trực tiếp trong thư mục được trích xuất mà không cần Tham khảo kho kèo bóng đá c1 trữ nhật ký, do đó làm cho điều này hoàn toàn độc lập hỗ trợ.
Các phương pháp sau để thu thập nhật ký giao dịch là được hỗ trợ:
Các tệp nhật ký giao dịch được thu thập ở cuối hỗ trợ. Do đó, nó là cần thiết chowal_keep_segmentstham số được đặt đủ cao để nhật ký không được xóa trước khi Phần cuối của bản sao kèo bóng đá c1. Nếu nhật ký đã được xoay khi đến lúc Để chuyển nó, bản sao kèo bóng đá c1 sẽ thất bại và không thể sử dụng được.
Truyền nhật ký giao dịch trong khi bản sao kèo bóng đá c1 được tạo. Cái này sẽ mở kết nối thứ hai đến máy chủ và bắt đầu phát trực tuyến Đăng nhập giao dịch song song trong khi chạy bản sao kèo bóng đá c1. Do đó, nó sẽ sử dụng hết hai khe được định cấu hình bởiMAX_WAL_SENDERSTham số. Miễn là khách hàng có thể theo kịp nhật ký giao dịch nhận được, sử dụng chế độ này không yêu cầu nhật ký giao dịch bổ sung để được kèo bóng đá c1 trên chủ.
Cho phép nén GZIP của đầu ra tệp TAR, với mặc định Mức nén. Nén chỉ có sẵn khi sử dụng tar định dạng.
Cho phép nén GZIP đầu ra tệp TAR và chỉ định Mức nén (0 đến 9, 0 là kèo bóng đá c1 nén và 9 Nén tốt nhất). Nén chỉ có sẵn khi sử dụng tar định dạng.
Tùy chọn dòng lệnh sau đây kiểm soát việc tạo sao kèo bóng đá c1 và chạy chương trình.
Đặt chế độ điểm kiểm tra thành nhanh hoặc lan truyền (mặc định).
Đặt nhãn cho bản sao kèo bóng đá c1. Nếu không được chỉ định, mặc định Giá trị của"pg_basebackup Sao kèo bóng đá c1 cơ sở"sẽ được sử dụng.
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 sao kèo bóng đá c1. Kể từ cơ sở dữ liệu có thể thay đổi trong quá trình sao kèo bóng đá c1, đây chỉ là một xấp xỉ và có thể không kết thúc tại chính xác100%. Đặc biệt, Khi nhật ký Wal được bao gồm trong bản sao kèo bóng đá c1, tổng số lượng dữ liệu không thể ước tính trước, và trong trường hợp này là ước tính Kích thước mục tiêu sẽ tăng khi nó vượt qua tổng ước tính mà không cần Wal.
Khi điều này được bật, bản sao 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 thực tế nội dung. Điều này có thể làm cho bản sao kèo bóng đá c1 mất nhiều thời gian hơn một chút và trong Cụ thể sẽ mất nhiều thời gian hơn trước khi dữ liệu đầu tiên được gửi.
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 máy, cũng như hiển thị tên tệp chính xác đó là hiện đang được xử lý nếu báo cáo tiến độ cũng là Đã bật.
Tùy chọn dòng lệnh sau đây kiểm soát cơ sở dữ kèo bóng đá c1 tham số kết nối.
Chỉ định các tham số được sử dụng để kết nối với máy chủ, dưới dạng Chuỗi kết nối. Nhìn thấyPhần 31.1.1Để biết thêm thông tin.
Tùy chọn được gọi là--DBNAMEcho Tính nhất quán với các ứng dụng khách khác, nhưng vìpg_basebackupKhông kết nối với bất kỳ cơ sở dữ kèo bóng đá c1 cụ thể nào trong cụm, tên cơ sở dữ kèo bóng đá c1 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ủ là đ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ừPGHOSTBiến môi trường, nếu được đặt, khác a Kết nối ổ cắm miền Unix được thử.
Chỉ định cổng TCP hoặc tệp ổ cắm tên miền unix cục bộ Tiện ích mở rộng 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 đến máy chủ. Điều này cho phép theo dõi tiến trình dễ dàng hơn từ máy chủ. Giá trị bằng 0 vô hiệu hóa các cập nhật trạng thái định kỳ hoàn toàn, mặc dù bản cập nhật vẫn sẽ được gửi khi được yêu cầu bởi Máy chủ, để tránh mất thời gian ngắt kết nối. Giá trị mặc định là 10 giây.
Tên người dùng để kết nối AS.
kèo bóng đá c1 bao giờ đưa ra lời nhắc mật khẩu. Nếu máy chủ yêu cầu mật khẩu Xác thực và mật khẩu kèo bóng đá c1 có sẵn bằng các phương tiện khác như một.pgassTệp, cố gắng kết nối sẽ thất bại. 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 nơi kèo bóng đá c1 có người dùng nào có mặt để nhập mật khẩu.
Forcepg_basebackupđể nhắc Đối với mật khẩu trước khi kết nối với cơ sở dữ kèo bóng đá c1.
Tùy chọn này kèo bóng đá c1 bao giờ cần thiết, vìpg_basebackupsẽ tự động nhắc nhở cho một 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í a Kết nối cố gắng phát hiện ra rằng máy chủ muốn một mật khẩu. TRONG Một số trường hợp đáng để gõ-Wđể tránh cố gắng kết nối thêm.
Các tùy chọn khác cũng có sẵn:
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.
Tiện ích này, giống như hầu hết các khácPostgreSQLTiện ích, sử dụng môi trường các biến được hỗ trợ bởilibpq(xemPhần 31,14).
Sao 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ỳ Các tập tin được đặt trong thư mục của các bên thứ ba. Chỉ các tập tin thông thường và các thư mục được phép trong thư mục dữ liệu, không có biểu tượng liên kết hoặc tệp thiết bị đặc biệt.
The WayPostgreSQLQuản lý không gian bảng, đường dẫn cho tất cả các không gian bảng bổ sung phải giống hệt nhau bất cứ khi nào một bản sao kèo bóng đá c1 được khôi phục. Thư mục dữ liệu chính, Tuy nhiên, có thể chuyển vị đến bất kỳ vị trí nào.
pg_basebackupLàm việc với Các máy chủ giống nhau hoặc một 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 Stream) chỉ hoạt động với máy chủ Phiên bản 9.3.
Để tạo bản sao kèo bóng đá c1 cơ sở của máy chủ tạiMyDbservervà kèo bóng đá c1 trữ nó trong thư mục cục bộ/usr/local/pgsql/data:
$
Để tạo bản sao kèo bóng đá c1 máy chủ cục bộ với một chiếc TAR được nén Tệp cho mỗi không gian bảng và kèo bóng đá c1 trữ nó trong thư mụcSao kèo bóng đá c1, Hiển thị báo cáo tiến độ trong khi đang chạy:
$ pg_basebackup -d sao kèo bóng đá c1 -FT -Z -P
Để tạo bản sao kèo bóng đá c1 cơ sở dữ liệu cục bộ không gian đơn và nén cái này vớiBZIP2:
$ pg_basebackup -d --ft | BZIP2 Sao kèo bóng đá c1tar.bz2
(Lệnh này sẽ thất bại nếu có nhiều không gian bảng trong cơ sở dữ kèo bóng đá c1.)