pg_receivexlog - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

pg_receivexlog - luồng nhật ký giao dịch từ máy chủ PostgreSQL

SYNOPSIS

pg_receivexlog [tùy chọn...]

MÔ TẢ

pg_receivexlog được sử dụng để truyền nhật ký giao dịch từ một cụm PostgreSQL đang chạy.
Nhật ký giao dịch được truyền trực tuyến bằng giao thức sao chép trực tuyến và được viết
vào một thư mục tệp cục bộ. Thư mục này có thể được sử dụng làm vị trí lưu trữ cho
thực hiện khôi phục bằng khôi phục tại chỗ (xem Phần 24.3, “Lưu trữ liên tục và
Khôi phục điểm trong thời gian (PITR) ”, trong tài liệu).

pg_receivexlog truyền nhật ký giao dịch trong thời gian thực khi nó được tạo trên
máy chủ và không đợi các phân đoạn hoàn thành như archive_command. Đối với điều này
lý do, không cần thiết đặt archive_timeout khi sử dụng pg_receivexlog.

Không giống như bộ thu WAL của máy chủ dự phòng PostgreSQL, pg_receivexlog theo mặc định sẽ tuôn ra
Dữ liệu WAL chỉ khi tệp WAL được đóng. Các tùy chọn - không đồng bộ phải được chỉ định
xóa dữ liệu WAL trong thời gian thực.

Nhật ký giao dịch được truyền trực tuyến qua kết nối PostgreSQL thông thường và sử dụng
giao thức nhân bản. Kết nối phải được thực hiện với siêu người dùng hoặc người dùng có
Quyền REPLICATION (xem Phần 20.2, “Thuộc tính vai trò”, trong tài liệu) và
pg_hba.conf phải cho phép kết nối sao chép. Máy chủ cũng phải được cấu hình
với max_wal_senders được đặt đủ cao để để lại ít nhất một phiên có sẵn cho
dòng.

Nếu kết nối bị mất hoặc nếu nó không thể được thiết lập ban đầu, với một
lỗi, pg_receivexlog sẽ thử lại kết nối vô thời hạn và thiết lập lại phát trực tuyến như
sớm nhất có thể. Để tránh hành vi này, hãy sử dụng tham số -n.

LỰA CHỌN

-D thư mục
--directory =thư mục
Thư mục để ghi đầu ra vào.

Tham số này là bắt buộc.

--nếu-không-tồn tại
Đừng để xảy ra lỗi khi --tạo-khe cắm được chỉ định và một vị trí với
Tên đã tồn tại.

-n
- không có vòng lặp
Đừng lặp lại lỗi kết nối. Thay vào đó, hãy thoát ngay khi có lỗi.

-s khoảng thời gian
--status-khoảng =khoảng thời gian
Chỉ định số giây giữa các gói trạng thái được gửi trở lại máy chủ. Cái này
cho phép giám sát tiến trình từ máy chủ dễ dàng hơn. Giá trị XNUMX vô hiệu hóa
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
do máy chủ yêu cầu, để tránh ngắt kết nối hết thời gian. Giá trị mặc định là 10 giây.

-S tên vị trí
--slot =tên vị trí
Yêu cầu pg_receivexlog sử dụng vị trí sao chép hiện có (xem Phần 25.2.6,
“Khe sao chép”, trong tài liệu). Khi tùy chọn này được sử dụng, pg_receivexlog
sẽ báo cáo một vị trí tuôn ra cho máy chủ, cho biết khi nào mỗi phân đoạn đã được
được đồng bộ hóa với đĩa để máy chủ có thể xóa phân đoạn đó nếu không phải là
cần thiết.

Khi máy khách nhân rộng của pg_receivexlog được định cấu hình trên máy chủ dưới dạng
chế độ chờ đồng bộ, sau đó sử dụng một khe sao chép sẽ báo cáo vị trí tuôn ra
máy chủ, nhưng chỉ khi tệp WAL bị đóng. Do đó, cấu hình đó sẽ
khiến các giao dịch trên chính phải chờ lâu và không hoạt động hiệu quả
một cách hài lòng. Tùy chọn - không đồng bộ (xem bên dưới) phải được chỉ định ngoài
làm cho điều này hoạt động chính xác.

- không đồng bộ
Chuyển dữ liệu WAL vào đĩa ngay sau khi nhận được. Cũng gửi một trạng thái
gói trở lại máy chủ ngay sau khi xả, bất kể - khoảng thời gian ngừng hoạt động.

Tùy chọn này nên được chỉ định nếu máy khách nhân rộng của pg_receivexlog là
được định cấu hình trên máy chủ như một chế độ chờ đồng bộ, để đảm bảo rằng phản hồi kịp thời là
được gửi đến máy chủ.

-v
--dài dòng
Bật chế độ tiết.

Các tùy chọn dòng lệnh sau kiểm soát các tham số kết nối cơ sở dữ liệu.

-d kết luận
--dbname =kết luận
Chỉ định các tham số được sử dụng để kết nối với máy chủ, dưới dạng một chuỗi kết nối. Nhìn thấy
Phần 31.1.1, “Chuỗi kết nối”, trong tài liệu để biết thêm thông tin.

Tùy chọn được gọi là --dbname để nhất quán với các ứng dụng khách khác, nhưng
bởi vì pg_receivexlog không kết nối với bất kỳ cơ sở dữ liệu cụ thể nào trong cụm,
tên cơ sở dữ liệu trong chuỗi kết nối sẽ bị bỏ qua.

-h chủ nhà
--host =chủ nhà
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 dấu gạch chéo, nó được sử dụng làm thư mục cho ổ cắm miền Unix. Các
mặc định được lấy từ PGHOST biến môi trường, nếu được đặt, khác một miền Unix
kết nối ổ cắm đã được thử.

-p cổng
--port =cổng
Chỉ định cổng TCP hoặc phần mở rộng tệp ổ cắm miền Unix cục bộ trên đó máy chủ
đang lắng nghe các kết nối. Mặc định là PGPORT biến môi trường, nếu được đặt, hoặc
một mặc định được biên dịch.

-U tên truy nhập
- tên người dùng =tên truy nhập
Tên người dùng để kết nối với tư cách.

-w
--không mật khẩu
Không 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 không khả dụng bằng các phương tiện khác như tệp .pgpass, kết nối
cố gắng sẽ thất bại. Tùy chọn này có thể hữu ích trong các công việc hàng loạt và tập lệnh mà không có người dùng
có mặt để nhập mật khẩu.

-W
--mật khẩu mở khóa
Buộc pg_receivexlog nhắc nhập mật khẩu trước khi kết nối với cơ sở dữ liệu.

Tùy chọn này không bao giờ cần thiết, vì pg_receivexlog sẽ 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_receivexlog sẽ
lãng phí nỗ lực kết nối để tìm ra rằng máy chủ muốn có mật khẩu. Trong vài trường hợp
nó đáng để gõ -W để tránh cố gắng kết nối thêm.

pg_receivexlog có thể thực hiện một trong hai hành động sau để kiểm soát vật lý
khe sao chép:

--tạo-khe cắm
Tạo một vùng sao chép vật lý mới với tên được chỉ định trong --chỗ, sau đó thoát.

- khe cắm giọt nước
Thả vùng sao chép với tên được chỉ định trong --chỗ, sau đó thoát.

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

-V
--phiên bản
In phiên bản pg_receivexlog và thoát.

-?
--Cứu giúp
Hiển thị trợ giúp về các đối số dòng lệnh pg_receivexlog và thoát.

MÔI TRƯỜNG

Tiện ích này, giống như hầu hết các tiện ích PostgreSQL khác, sử dụng các biến môi trường
được hỗ trợ bởi libpq (xem Phần 31.14, “Biến môi trường”, trong tài liệu).

GHI CHÚ

Khi sử dụng pg_receivexlog thay vì archive_command làm phương pháp sao lưu WAL chính, nó là
rất khuyến khích sử dụng các khe sao chép. Nếu không, máy chủ có thể tự do tái chế hoặc
xóa các tệp nhật ký giao dịch trước khi chúng được sao lưu, vì nó không có bất kỳ
thông tin, từ archive_command hoặc các vị trí sao chép, về khoảng cách của WAL
luồng đã được lưu trữ. Tuy nhiên, lưu ý rằng một vị trí nhân bản sẽ lấp đầy máy chủ
dung lượng đĩa nếu người nhận không theo kịp với việc tìm nạp dữ liệu WAL.

VÍ DỤ

Để phát trực tuyến nhật ký giao dịch từ máy chủ tại mydbserver và lưu trữ nó trong địa phương
thư mục / usr / local / pgsql / archive:

$ pg_receivexlog -h máy chủ mydb -D / usr / local / pgsql / archive

Sử dụng pg_receivexlog trực tuyến bằng các dịch vụ onworks.net