POSTGRESQLsoi kèo bóng đá truoctran chủ
PG_ReceiveWal
[Tùy chọn
...]
PG_ReceiveWalđược sử dụng để phát trực tuyến nhật ký ghi từ khi chạyPostgreSQLCụm. Nhật ký viết ghi được phát trực tuyến bằng giao thức sao chép phát trực tuyến và được ghi vào thư mục các tệp cục bộ.Phần 26.3).
PG_ReceiveWalphát trực tuyến nhật ký ghi trong thời gian thực khi nó được tạo trên máy chủ và soi kèo bóng đá truoctran chờ các phân đoạn hoàn thành nhưArchive_CommandandArchive_L Librarylàm. Vì lý do này, soi kèo bóng đá truoctran cần thiết phải đặtarchive_timeoutKhi sử dụngPG_ReceiveWal.
soi kèo bóng đá truoctran giống như máy thu wAL của máy chủ dự phòng PostgreSQL,PG_ReceiveWalTheo mặc định, chỉ có dữ soi kèo bóng đá truoctran WAL khi tệp WAL được đóng. Tùy chọn-Synchronous
phải được chỉ định để xóa dữ soi kèo bóng đá truoctran WAL trong thời gian thực. TừPG_ReceiveWalsoi kèo bóng đá truoctran áp dụng Wal, bạn soi kèo bóng đá truoctran nên cho phép nó trở thành một chế độ chờ đồng bộ khisynchronous_commitequalsRemote_apply
. Nếu có, nó sẽ dường như là một dự phòng soi kèo bóng đá truoctran bao giờ bắt kịp và sẽ khiến giao dịch cam kết bị chặn.synchronous_standby_nameshoặc chỉ địnhapplication_name
choPG_ReceiveWalsoi kèo bóng đá truoctran khớp với nó hoặc thay đổi giá trị củasynchronous_commit
với một cái gì đó khác ngoàiRemote_apply
.
The write-ahead log is streamed over a regularPostgreSQLKết nối và sử dụng giao thức sao chép. Kết nối phải được thực hiện với người dùng cósao chép
quyền (xemPhần 22.2) hoặc một siêu người dùng vàpg_hba.conf
Phải cho phép kết nối sao chép. soi kèo bóng đá truoctran 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 luồng.
Điểm bắt đầu của luồng nhật ký ghi lại được tính toán khipg_receivewalbắt đầu:
11234_11417
If a starting point cannot be calculated with the previous method, and if a replication slot is used, an extraread_replication_slot
Lệnh được cấp để truy xuất khe củarestart_lsn
to use as the starting point. This option is only available when streaming write-ahead logs fromPostgreSQL15 trở lên.
11934_12075INEMENT_SYSTEM
lệnh.
Nếu kết nối bị mất hoặc nếu nó soi kèo bóng đá truoctran thể được thiết lập ban đầu, với lỗi soi kèo bóng đá truoctran gây tử vong,PG_ReceiveWalSẽ thử lại kết nối vô thời hạn và tái lập trình phát trực tuyến càng sớm càng tốt. Để tránh hành vi này, hãy sử dụng-N
tham số.
Trong trường hợp soi kèo bóng đá truoctran có lỗi gây tử vong,PG_ReceiveWalsẽ chạy cho đến khi chấm dứt bởiSigint(Control+C) hoặcsigtermTín hiệu.
-DThư mục
--Directory =Thư mục
Thư mục để ghi đầu ra vào.
Tham số này là bắt buộc.
-eLSN
--endpos =LSN
Automatically stop replication and exit with normal exit status 0 when receiving reaches the specified LSN.
If there is a record with LSN exactly equal tolsn
, bản ghi sẽ được xử lý.
--if-not-exist
soi kèo bóng đá truoctran lỗi khi--create-slot
được chỉ định và một khe có tên được chỉ định đã tồn tại.
-N
--no-loop
soi kèo bóng đá truoctran lặp lại các lỗi kết nối. Thay vào đó, hãy thoát ra ngay với lỗi.
--no-sync
Tùy chọn này gây raPG_ReceiveWal
Để soi kèo bóng đá truoctran buộc dữ liệu WAL được chuyển vào đĩa. Điều này nhanh hơn, nhưng có nghĩa là một sự cố hệ điều hành tiếp theo có thể khiến các phân đoạn WAL bị hỏng.
Tùy chọn này soi kèo bóng đá truoctran tương thích với-Synchronous
.
-Sinterval
--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 soi kèo bóng đá truoctran chủ. Điều này cho phép theo dõi dễ dàng hơn về tiến trình từ soi kèo bóng đá truoctran chủ.
-Sslotname
-slot =slotname
Yêu cầuPG_ReceiveWalĐể sử dụng khe sao chép hiện có (xemPhần 27.2.6). Khi tùy chọn này được sử dụng,PG_ReceiveWalsẽ báo cáo vị trí xả vào máy chủ, cho biết khi mỗi phân đoạn đã được đồng bộ hóa với đĩa để máy chủ có thể loại bỏ phân đoạn đó nếu soi kèo bóng đá truoctran cần thiết.
Khi soi kèo bóng đá truoctran khách sao chép củaPG_ReceiveWalđược cấu hình trên máy chủ dưới dạng chế độ chờ đồng bộ, sau đó sử dụng khe sao chép sẽ báo cáo vị trí Flush cho máy chủ, nhưng chỉ khi đóng tệp WAL. Do đó, cấu hình đó sẽ khiến các giao dịch trên chính chờ đợi trong một thời gian dài và hiệu quả soi kèo bóng đá truoctran hoạt động thỏa đáng.-Đồng bộ hóa
(xem bên dưới) phải được chỉ định ngoài việc làm cho công việc này chính xác.
-Đồng bộ hóa
Xóa dữ liệu WAL vào đĩa ngay sau khi nhận được. Cũng gửi gói trạng thái trở lại soi kèo bóng đá truoctran chủ ngay sau khi xả, bất kể--Status-interval
.
Tùy chọn này sẽ được chỉ định nếu soi kèo bóng đá truoctran khách sao chép củapg_receivewalđược cấu hình trên soi kèo bóng đá truoctran chủ dưới dạng chế độ chờ đồng bộ, để đảm bảo rằng phản hồi kịp thời được gửi đến soi kèo bóng đá truoctran chủ.
-V
--Verbose
Cho phép chế độ Verbose.
-zCấp
-zPhương pháp
[:chi tiết
]
--compress =level
--compress =Phương pháp
[:chi tiết
]
Enables compression of write-ahead logs.
Phương pháp nén có thể được đặt thànhgzip
, LZ4
(ifPostgreSQLđược tổng hợp với--with-lz4
) hoặcsoi kèo bóng đá truoctran
soi kèo bóng đá truoctran nén. Một chuỗi chi tiết nén có thể được chỉ định tùy chọn.Từ khóa
hoặctừ khóa = value
. Hiện tại, từ khóa được hỗ trợ duy nhất làCấp
.
Nếu soi kèo bóng đá truoctran có mức độ nén nào đượ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à soi kèo bóng đá truoctran đề cập đến thuật toán,gzip
Nén sẽ được sử dụng nếu mức lớn hơn 0 và sẽ soi kèo bóng đá truoctran sử dụng nén nếu mức là 0.
Hậu tố.gz
sẽ tự động được thêm vào tất cả các tên tệp khi sử dụnggzip
, and the suffix.lz4
được thêm vào khi sử dụngLZ4
.
Tùy chọn dòng lệnh sau đây kiểm soát các tham số kết nối cơ sở dữ soi kèo bóng đá truoctran.
-DConnstr
--dbname=Connstr
Specifies parameters used to connect to the server, as achuỗ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_ReceiveWalsoi kèo bóng đá truoctran 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.
-Hsoi kèo bóng đá truoctran chủ
--host =host
Chỉ định tên soi kèo bóng đá truoctran chủ của soi kèo bóng đá truoctran mà soi kèo bóng đá truoctran 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.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 Tiện ích mở rộng tệp ổ cắm tên miền Unix cục bộ mà soi kèo bóng đá truoctran 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.
-Utên người dùng
--Username =username
Tên người dùng để kết nối AS.
-W
--no-password
soi kèo bóng đá truoctran 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 soi kèo bóng đá truoctran 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ẽ soi kèo bóng đá truoctran 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 đó soi kèo bóng đá truoctran có người dùng nào để nhập mật khẩu.
-W
--password
ForcePG_ReceiveWalĐể nhắc mật khẩu trước khi kết nối với cơ sở dữ soi kèo bóng đá truoctran.
Tùy chọn này soi kèo bóng đá truoctran bao giờ cần thiết, vìpg_receivewalSẽ tự động nhắc mật khẩu nếu soi kèo bóng đá truoctran chủ yêu cầu xác thực mật khẩu. Tuy nhiên,PG_ReceiveWalSẽ lãng phí một nỗ lực kết nối để tìm ra rằng soi kèo bóng đá truoctran 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.
PG_ReceiveWalCó thể thực hiện một trong hai hành động sau để kiểm soát các vị trí sao chép vật lý:
--create-slot
Tạo một khe sao chép vật lý mới với tên được chỉ định trong--slot
, sau đó thoát.
--drop-slot
Thả khe sao chép với tên được chỉ định trong--slot
, sau đó thoát.
Các tùy chọn khác cũng có sẵn:
-V
--Version
inpg_receivewalPhiên bản và Thoát.
-?
--Help
Hiển thị trợ giúp vềPG_ReceiveWalĐối số dòng lệnh và thoát.
PG_ReceiveWalsẽ thoát với trạng thái 0 khi bị chấm dứt bởiSigintorsigtermTín hiệu. (Đó là cách thông thường để kết thúc nó. Do đó nó soi kèo bóng đá truoctran phải là lỗi.)
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 34.15).
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 soi kèo bóng đá truoctran. Các giá trị có thể làluôn luôn
, Auto
andsoi kèo bóng đá truoctran bao giờ
.
Khi sử dụngPG_ReceiveWalthay vìarchive_commandhoặcArchive_L LibraryLà phương thức sao lưu WAL chính, nên sử dụng các khe sao chép. Mặt khác, máy chủ được tự do tái chế hoặc xóa các tệp nhật ký ghi trước khi chúng được sao lưu, vì nó soi kèo bóng đá truoctran có bất kỳ thông tin nào, từArchive_Commandhoặcarchive_l Libraryhoặc các khe sao chép, về việc luồng Wal đã được lưu trữ bao xa. Tuy nhiên, lưu ý rằng một khe sao chép sẽ lấp đầy soi kèo bóng đá truoctran gian đĩa của máy chủ nếu người nhận soi kèo bóng đá truoctran theo kịp việc tìm nạp dữ liệu WAL.
PG_ReceiveWal26527_26643
Để phát trực tuyến nhật ký ghi từ soi kèo bóng đá truoctran chủ tạiMyDbserver
and store it in the local directory/usr/local/pgsql/archive
:
$
pg_receivewal -h mydbserver -D /usr/local/pgsql/archive
Nếu bạn thấy bất cứ điều gì trong tài liệu soi kèo bóng đá truoctran chính xác, soi kèo bóng đá truoctran khớpMẫu nàyĐể báo cáo vấn đề tài soi kèo bóng đá truoctran.