Phiên bản được hỗ trợ:hiện tại(17) /16 / 15 / 14 / 13
Phiên bản phát triển:18 / Devel
Phiên bản kèo bóng đá euro được hỗ trợ:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1
Tài kèo bóng đá euro này dành cho phiên bản không được hỗ trợ của PostgreSQL.
Bạn có thể muốn xem cùng một trang chohiện tạiPhiên bản hoặc một trong các phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

kèo bóng đá europg_basebackup

tên

pg_basebackup-lấy bản kèo bóng đá euro cơ sở của APostgreSQLcụm

Synopsis

pg_basebackup[Tùy chọn...]

Mô tả

pg_basebackupđược sử dụng để lấy kèo bóng đá euro cơ sở của một lần chạyPostgreSQLCụm cơ sở dữ kèo bóng đá euro. 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 đá euro 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 đá euro 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 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 được đặt vào và ra khỏi chế độ kèo bóng đá euro tự động. kèo bóng đá euro là luôn luôn được thực hiện toàn bộ cụm cơ sở dữ liệu; Không thể Để kèo bóng đá euro các cơ sở dữ liệu hoặc đối tượng cơ sở dữ liệu riêng lẻ. Vì kèo bóng đá euro cơ sở dữ liệu riêng lẻ, một công cụ nhưpg_dumpphải được sử dụng.

bản kèo bóng đá euro đượ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 đá euro chép. Kết nối phải được thực hiện với một Superuser hoặc người dùng cókèo bóng đá euro chépQuyền (xemkèo bóng đá) vàpg_hba.confPhải cho phép rõ ràng kết nối kèo bóng đá euro chép. Máy chủ phải Cũng đượ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ừ một màn trình diễn quan điểm chỉ lấy một bản kèo bóng đá euro và sao chép kết quả.

pg_basebackupcó thể tạo cơ sở kèo bóng đá euro từ không chỉ Master mà còn là chế độ chờ. Để lấy a kèo bóng đá euro 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_SENDERShot_standby, và định cấu hìnhPostgreSQL: Tài kèo bóng). Bạn cũng sẽ cần phải bậtfull_page_writestrên chủ.

Lưu ý rằng có một số hạn chế trong bản kèo bóng đá euro trực tuyến từ Chế độ chờ:

  • Tệp lịch sử kèo bóng đá euro không được tạo trong cơ sở dữ liệu cụm kèo bóng đá euro.

  • Không có gì đảm bảo rằng tất cả các tệp WAL cần thiết cho kèo bóng đá euro được lưu trữ ở cuối bản kèo bóng đá euro. Nếu bạn đang lên kế hoạch sử dụng bản kèo bóng đá euro để phục hồi lưu trữ và muốn đảm bảo rằng tất cả các tệp bắt buộc đều có sẵn tại thời điểm đó, bạn cần đưa chúng vào bản kèo bóng đá euro bằng cách sử dụng-xTùy chọn.

  • Nếu chế độ chờ được thăng cấp lên Master trong khi trực tuyến kèo bóng đá euro, bản kèo bóng đá euro 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 đá euro phải chứa Viết đủ trang đầy đủ, yêu cầu bạn bậtfull_page_writestrên chủ và kèo bóng đá euro sử dụng một công cụ nhưpg_compresslogASArchive_CommandĐể xóa ghi toàn trang từ các tệp wal.

Tùy chọn

Tùy chọn dòng lệnh sau đây kiểm soát vị trí và Định dạng đầu ra.

-DThư mục
-pgdata =Thư mục

Thư mục để ghi đầu ra vào.pg_basebackupsẽ tạo ra thư mục và bất kỳ thư mục phụ huynh nếu cần thiết. Các 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à kèo bóng đá euro trống.

Khi bản kèo bóng đá euro ở chế độ TAR và thư mục là được chỉ định là-(Dash), tar Tệp sẽ được ghi vàostdout.

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ạngcó thể là một trong những tiếp theo:

P
trơn

Viết đầu ra dưới dạng tệp đơn giản, có cùng Bố cục như thư mục dữ kèo bóng đá euro hiện tại và không gian bảng. Khi cụm không có không gian bảng bổ sung, toàn bộ cơ sở dữ kèo bóng đá euro sẽ được đặt trong mục tiêu Thư mục. Nếu cụm chứa bổ sung không gian bảng, thư mục dữ kèo bóng đá euro 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.

T
tar

Viết đầu ra dưới dạng tệp tar trong mục tiêu Thư mục. Thư mục dữ kèo bóng đá euro chính sẽ được ghi vào một tệp có tênbase.tar, và Tất cả các kèo bóng đá euro gian bảng khác sẽ được đặt tên theo kèo bóng đá euro gian bảng oid.

Nếu giá trị-(Dash) là được chỉ định là thư mục đích, nội dung tar sẽ được viết vào đầu ra tiêu chuẩn, phù hợp để đường ống đến Ví dụgzip. Điều này chỉ có thể nếu cụm kèo bóng đá euro có kèo bóng đá euro gian bảng bổ sung.

-x
--xlog

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.

-xPhương pháp
--xlog-method =Phương pháp

Bao gồm các tệp nhật ký giao dịch cần thiết (Tệp WAL) trong bản kèo bóng đá euro. Điều này sẽ bao gồm tất cả các nhật ký giao dịch tạo ra trong quá trình kèo bóng đá euro. Nếu tùy chọn này được chỉ định, có thể bắt đầu một người nhận bưu điện trực tiếp trong Trích xuất thư mục mà không cần tham khảo nhật ký Lưu trữ, 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 giao dịch Nhật ký được hỗ trợ:

f
Fetch

Các tệp nhật ký giao dịch được thu thập ở cuối của bản kèo bóng đá euro. Do đó, nó là cần thiết chowal_keep_segmentstham số được đặt đủ cao rằng nhật ký không được xóa trước khi kết thúc hỗ trợ. Nếu nhật ký đã được xoay khi đến lúc chuyển nó, bản kèo bóng đá euro sẽ thất bại và không thể sử dụng.

S
Stream

Phát trực tuyến nhật ký giao dịch trong khi bản kèo bóng đá euro là tạo. Điều này sẽ mở kết nối thứ hai với máy chủ và bắt đầu phát trực tuyến nhật ký giao dịch Song song trong khi chạy kèo bóng đá euro. 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 điều này Chế độ không yêu cầu nhật ký giao dịch bổ sung để được kèo bóng đá euro trên chủ.

-z
--GZIP

Cho phép nén GZIP đầu ra tệp TAR, với Mức nén mặc định. Nén chỉ có sẵn Khi sử dụng định dạng 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 là kèo bóng đá euro Nén và 9 là nén tốt nhất). Nén là Chỉ có sẵn khi sử dụng định dạng TAR.

Tùy chọn dòng lệnh sau đây kiểm soát việc tạo ra bản kèo bóng đá euro và chạy của chương trình.

-Cnhanh | lây lan
--CheckPoint =nhanh | lây lan

Đặt chế độ điểm kiểm tra thành nhanh hoặc lan truyền (mặc định).

-Lnhãn
--Label =nhãn

Đặt nhãn cho bản kèo bóng đá euro. Nếu không có gì được chỉ định, một Giá trị mặc định của"kèo bóng đá euro cơ sở PG_Basebackup"sẽ được đã sử dụng.

-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 đá euro. Kể từ khi cơ sở dữ liệu có thể thay đổi trong quá trình kèo bóng đá euro, đây chỉ là một xấp xỉ và không thể kết thúc tại chính xác100%. Đặc biệt, khi nhật ký wal là Bao gồm trong bản kèo bóng đá euro, tổng số lượng dữ liệu không thể ước tính trước, và trong trường hợp này, mục tiêu ước tính Kích thước sẽ tăng khi nó vượt qua tổng ước tính không có wal.

Khi điều này được bật, bản kèo bóng đá euro sẽ bắt đầu liệt kê kích thước của toàn bộ cơ sở dữ liệu, sau đó đi 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 đá euro 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.

-V
--Verbose

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

Tùy chọn dòng lệnh sau đây kiểm soát cơ sở dữ kèo bóng đá euro tham số kết nối.

-Hhost
--host =host

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

-PCổng
--Port =Cổng

Chỉ định cổng TCP hoặc Tệp ổ cắm 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àPGPORTMôi trường Biến, 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 Đã gửi trở lại máy chủ. Điều này là bắt buộc khi phát trực tuyến Nhật ký giao dịch (sử dụng--xlog = stream) Nếu thời gian chờ kèo bóng đá euro chép là Được cấu hình trên máy chủ và cho phép giám sát dễ dàng hơn. Giá trị của Zero vô hiệu hóa hoàn toàn các cập nhật trạng thái. Các Giá trị mặc định là 10 giây.

-Utên người dùng
--Username =tên người dùng

Tên người dùng để kết nối AS.

-W
--no-password

kèo bóng đá euro bao giờ đưa ra lời 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 đá euro có sẵn bởi Các phương tiện khác như.pgassTệp, nỗ lực kết nối sẽ kèo bóng đá euro thành công. Tùy chọn này có thể là 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 đá euro có người dùng Để nhập mật khẩu.

-W
--Password

Forcepg_basebackupđến nhắc mật khẩu trước khi kết nối với cơ sở dữ kèo bóng đá euro.

Tùy chọn này kèo bóng đá euro 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 mật khẩu xác thực. Tuy nhiên,pg_basebackupSẽ lãng phí 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đến Tránh cố gắng kết nối thêm.

Các tùy chọn khác cũng có sẵn:

-V
--Version

​​In Thepg_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.

Môi trường

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

ghi chú

Bản kèo bóng đá euro 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ỉ thường xuyên Các tập tin và thư mục được phép trong thư mục dữ liệu, không liên kết tượng trưng 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 kèo bóng đá euro đượ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.

Ví dụ

Để tạo bản kèo bóng đá euro cơ sở của máy chủ tạiMyDbservervà kèo bóng đá euro trữ nó trong thư mục cục bộ/usr/local/pgsql/data:

$ 

Để tạo bản kèo bóng đá euro 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à lưu trữ nó trong thư mụckèo bóng đá euro, hiển thị báo cáo tiến độ trong khi đang chạy:

$ pg_basebackup -d kèo bóng đá euro -FT -Z -P

Để tạo bản kèo bóng đá euro của 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 kèo bóng đá eurotar.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 đá euro.)

Xem thêm

pg_dump