PostgreSQL có thể được mở rộng để chạy mã do người dùng cung cấp trong các quy kèo bóng đá hom nay riêng biệt. Các quy kèo bóng đá hom nay như vậy được bắt đầu, dừng và theo dõi bởiPostgres, cho phép họ có một cuộc đời được liên kết chặt chẽ với trạng thái của máy chủ. Các quy kèo bóng đá hom nay này có tùy chọn để đính kèm vàoPostgreSQLkhu vực bộ nhớ được chia sẻ và để kết nối với cơ sở dữ liệu bên trong; Họ cũng có thể chạy nhiều giao dịch một cách tự do, giống như một quy kèo bóng đá hom nay máy chủ kết nối máy khách thông thường. Ngoài ra, bằng cách liên kết vớilibpqHọ có thể kết nối với máy chủ và hoạt động như một ứng dụng máy khách thông thường.

kèo bóng đá hom nay có thể được khởi tạo tại thời điểm đóPostgreSQLđược bắt đầu bằng cách bao gồm tên mô -đun trongshared_preload_l Libries. Một mô -đun muốn chạy một kèo bóng đá hom nay có thể đăng ký nó bằng cách gọi10178_10205BackidentWorker *Công kèo bóng đá hom nay)từ nó_pg_init ()Hàm. kèo bóng đá hom nay cũng có thể được bắt đầu sau khi hệ thống hoạt động và chạy bằng cách gọi10470_10504BackidentWorker *Công kèo bóng đá hom nay, BackidentWorkerHandle**xử lý). Không giống như10731_10757, chỉ có thể được gọi từ trong quy kèo bóng đá hom nay Postmaster,10848_10881phải được gọi từ phụ trợ thông thường hoặc kèo bóng đá hom nay khác.

Cấu trúcBackidentWorkerđược xác định như vậy:

typedef void (*bgworker_main_type) (datum main_arg);
Typedef Struct BackidentWorker

    char bgw_name [bgw_maxlen];
    char bgw_type [bgw_maxlen];
    int bgw_flags;
    Bgworkerstarttime bgw_start_time;
    int bgw_restart_time;       / * tính bằng giây hoặc bgw_never_restart */
    char bgw_l Library_name [bgw_maxlen];
    char bgw_function_name [bgw_maxlen];
    Datum bgw_main_arg;
    char bgw_extra [bgw_extralen];
    int bgw_notify_pid;
 BackidentWorker;

BGW_NAMEvàBGW_TYPElà các chuỗi được sử dụng trong các thông báo nhật ký, danh sách xử lý và bối cảnh tương tự.BGW_TYPEnên giống nhau cho tất cả các kèo bóng đá hom nay cùng loại, để có thể nhóm các công nhân đó trong một danh sách quy trình, ví dụ.BGW_NAMEMặt khác có thể chứa thông tin bổ sung về quy kèo bóng đá hom nay cụ thể. (Thông thường, chuỗi choBGW_NAME12157_12226

BGW_FLAGS12276_12377

bgw_start_timelà trạng thái máy chủ trong đóPostgresnên bắt đầu quá kèo bóng đá hom nay; Nó có thể là một trong nhữngBGWorkerstart_PostMasterStart(Bắt đầu ngay khiPostgresBản thân đã hoàn thành việc khởi tạo riêng của mình; Các quy kèo bóng đá hom nay yêu cầu điều này không đủ điều kiện cho các kết nối cơ sở dữ liệu),BGWorkerstart_ConsistentState(Bắt đầu ngay khi đạt được trạng thái nhất quán trong chế độ chờ nóng, cho phép các quy kèo bóng đá hom nay kết nối với cơ sở dữ liệu và chạy các truy vấn chỉ đọc) vàBGWorkerstart_RecoveryFinished(Bắt đầu ngay khi hệ thống đã đi vào trạng thái đọc thông thường). Lưu ý hai giá trị cuối cùng tương đương trong một máy chủ không phải là chế độ chờ nóng. Lưu ý rằng cài đặt này chỉ cho biết khi nào các quy kèo bóng đá hom nay được bắt đầu; Họ không dừng lại khi đạt đến trạng thái khác.

bgw_restart_timelà khoảng thời gian, tính bằng giây, đóPostgresnên đợi trước khi khởi động lại quy kèo bóng đá hom nay trong trường hợp nó gặp sự cố. Nó có thể là bất kỳ giá trị dương nào, hoặcbgw_never_restart, cho biết không khởi động lại quá kèo bóng đá hom nay trong trường hợp gặp sự cố.

bgw_l Library_namelà tên của một thư viện trong đó nên tìm kiếm điểm nhập cảnh ban đầu cho kèo bóng đá hom nay. Thư viện được đặt tên sẽ được tải động bởi quy trình công nhân vàbgw_function_namesẽ được sử dụng để xác định chức năng được gọi. Nếu tải một hàm từ mã lõi, điều này phải được đặt thành "postgres".

BGW_Function_Namelà tên của một hàm trong thư viện được tải động nên được sử dụng làm điểm nhập ban đầu cho một kèo bóng đá hom nay mới.

BGW_MAIN_ARGlàDatumĐối số cho chức năng chính của kèo bóng đá hom nay. Chức năng chính này sẽ lấy một đối số duy nhất loạiDatumvà returnvoid. BGW_MAIN_ARGsẽ được thông qua làm đối số. Ngoài ra, biến toàn cầumybgworkerentrychỉ vào một bản sao củaBackidentWorkerCấu trúc được truyền vào thời gian đăng ký; Công kèo bóng đá hom nay có thể thấy hữu ích khi kiểm tra cấu trúc này.

trên Windows (và bất cứ nơi nào khác nơiexec_backendđược xác định) hoặc trong kèo bóng đá hom nay động không an toàn khi vượt quaDatumBằng cách tham chiếu, chỉ theo giá trị. Nếu một đối số là bắt buộc, việc chuyển INT32 hoặc giá trị nhỏ khác là an toàn nhất và sử dụng nó làm chỉ mục vào một mảng được phân bổ trong bộ nhớ chia sẻ. Nếu một giá trị nhưcStringhoặcTextđược thông qua thì con trỏ sẽ không hợp lệ từ quy trình kèo bóng đá hom nay mới.

BGW_EXTRA16610_16682BGW_MAIN_ARG, dữ liệu này không được truyền như một đối số cho chức năng chính của công kèo bóng đá hom nay, nhưng nó có thể được truy cập quamybgworkerentry, Như đã thảo luận ở trên.

bgw_notify_pidlà PID của quy kèo bóng đá hom nay phụ trợ PostgreSQL mà Postmaster sẽ gửiSigusr1Khi quá trình được bắt đầu hoặc thoát ra. Nó phải là 0 cho các công kèo bóng đá hom nay đã đăng ký tại thời gian khởi động bưu điện hoặc khi phụ trợ đăng ký công kèo bóng đá hom nay không muốn chờ công kèo bóng đá hom nay khởi động. Nếu không, nó phải được khởi tạo thànhMyProcPid.

Sau khi chạy, quá kèo bóng đá hom nay có thể kết nối với cơ sở dữ liệu bằng cách gọichar *dbname, char *tên người dùng, Cờ UINT32)hoặc17668_17712OID DBOID, OID useroid, Cờ UINT32). Điều này cho phép quá kèo bóng đá hom nay chạy các giao dịch và truy vấn bằng cách sử dụngSPIGiao diện. Nếu nhưdbnamelà null hoặcDBOIDlàkhông hợp lệ, phiên không được kết nối với bất kỳ cơ sở dữ liệu cụ thể nào, nhưng các danh mục được chia sẻ có thể được truy cập. Nếu nhưtên người dùnglà null hoặcuseroidlàkhông hợp lệ, quá kèo bóng đá hom nay này sẽ chạy như siêu người dùng được tạo tronginitDB. Nếu nhưBGWorker_Bypass_allowConnđược chỉ định làCờCó thể bỏ qua các hạn chế để kết nối với cơ sở dữ liệu không cho phép kết nối người dùng. Một kèo bóng đá hom nay viên nền chỉ có thể gọi một trong hai chức năng này và chỉ một lần. Không thể chuyển đổi cơ sở dữ liệu.

Tín hiệu ban đầu bị chặn khi điều khiển đến chức năng chính của kèo bóng đá hom nay và phải được bỏ chặn bởi nó; Điều này là để cho phép quá trình tùy chỉnh trình xử lý tín hiệu của nó, nếu cần thiết. Tín hiệu có thể được bỏ chặn trong quy trình mới bằng cách gọivà bị chặn bằng cách gọi.

nếubgw_restart_timeĐối với một kèo bóng đá hom nay được cấu hình làbgw_never_restarthoặc nếu nó thoát với mã thoát 0 hoặc bị chấm dứt bởi19390_19417, nó sẽ tự động không được đăng ký bởi người bưu điện khi thoát. Nếu không, nó sẽ được khởi động lại sau khoảng thời gian được cấu hình quabgw_restart_time19607_19841Waitlatch (). Đảm bảo19918_19939cờ được đặt khi gọi chức năng đó và xác minh mã trả về để thoát khỏi trường hợp khẩn cấp rằngPostgresBản thân nó đã chấm dứt.

Khi một kèo bóng đá hom nay được đăng ký bằng20199_2023220237_20424BackidentWorkerHandle *là đối số thứ hai cho20522_20555. Nếu người lao động được đăng ký thành công, con trỏ này sẽ được khởi tạo bằng tay cầm mờ có thể được truyền đếngetbackgroundWorkerPid (BackidentWorkerHandle *, PID_T *)hoặcchấm dứtBackidentWorkerHandle *). GetBackgroundWorkerPidCó thể được sử dụng để thăm dò trạng thái của công kèo bóng đá hom nay: Giá trị trả lại củaBGWH_NOT_YET_STARTEDCho biết rằng người lao động chưa được bắt đầu bởi người bưu điện;bgwh_stoppedchỉ ra rằng nó đã được bắt đầu nhưng không còn chạy nữa; Vàbgwh_started21373_21490chấm dứtkhiến người nhận bưu điện gửisigtermĐối với công kèo bóng đá hom nay nếu nó đang chạy và để hủy đăng ký nó ngay khi nó không.

Trong một số trường hợp, một quá trình đăng ký một kèo bóng đá hom nay có thể muốn chờ người lao động bắt đầu. Điều này có thể được thực hiện bằng cách khởi tạobgw_notify_pidđếnMyProcPidvà sau đó vượt quaBackidentWorkerHandle *thu được tại thời gian đăng ký lênWaitForbackgroundWorkerstartup (BackidentWorkerHandle *Xử lý, PID_T *)Hàm. Chức năng này sẽ chặn cho đến khi người đưa thư đã cố gắng bắt đầu nhân viên nền, hoặc cho đến khi người đưa thư chết. Nếu kèo bóng đá hom nay đang chạy, giá trị trả về sẽ làbgwh_startedvà PID sẽ được ghi vào địa chỉ được cung cấp. Nếu không, giá trị trả về sẽ làbgwh_stoppedhoặcBGWH_POSTMASTER_DIED.

Một quy trình cũng có thể chờ một kèo bóng đá hom nay đóng cửa, bằng cách sử dụngWaitforbackgroundworkershutdown (BackidentWorkerHandle *Xử lý)chức năng và vượt quaBackidentWorkerHandle *thu được khi đăng ký. Chức năng này sẽ chặn cho đến khi nhân viên nền thoát ra, hoặc người bán bưu điện chết. Khi kèo bóng đá hom nay thoát ra, giá trị trả về làbgwh_stopped, Nếu Postmaster chết, nó sẽ trở lạiBGWH_POSTMASTER_DIED.

kèo bóng đá hom nay có thể gửi tin nhắn thông báo không đồng bộ, bằng cách sử dụngThông báolệnh thông quaSPIhoặc trực tiếp quaasync_notify (). Thông báo như vậy sẽ được gửi tại cam kết giao dịch. kèo bóng đá hom nay viên nền không nên đăng ký để nhận thông báo không đồng bộ vớingheLệnh, vì không có cơ sở hạ tầng để người lao động tiêu thụ các thông báo đó.

Thesrc/test/modules/worker_spiMô -đun chứa một ví dụ làm việc, thể hiện một số kỹ thuật hữu ích.

Số lượng kèo bóng đá hom nay đã đăng ký tối đa bị giới hạn bởiMax_Worker_Processes.