| PostgreSQL: kèo bóng đá hôm nay và ngày mai liệu: | |||
|---|---|---|---|
| prev | UP | Chương 51. Giao thức Frontend/phụ trợ | Tiếp theo |
Phần này mô tả luồng thông báo và ngữ nghĩa của mỗi loại soi kèo bóng đá truoctran. (Chi tiết về biểu diễn chính xác của mỗi soi kèo bóng đá truoctran xuất hiện trongPhần 51.5.) Có soi kèo bóng đá truoctran số giao thức phụ khác nhau tùy thuộc vào trạng thái của kết nối: khởi động, truy vấn, gọi chức năng,sao chép, và chấm dứt. Ngoài ra còn có các quy định đặc biệt cho các hoạt động không đồng bộ (bao gồm các phản hồi soi kèo bóng đá truoctran và hủy lệnh), có thể xảy ra bất cứ lúc nào sau giai đoạn khởi động.
Để bắt đầu phiên, Frontend mở kết nối đến máy chủ và gửi soi kèo bóng đá truoctran khởi động. Thông báo này bao gồm tên của người dùng và cơ sở dữ liệu mà người dùng muốn kết nối;pg_hba.conf) Để xác định xem kết nối có được chấp nhận tạm thời hay soi kèo bóng đá truoctran và yêu cầu xác thực bổ sung nào (nếu có).
Máy chủ sau đó gửi một soi kèo bóng đá truoctran yêu cầu xác thực phù hợp, mà Frontend phải trả lời với soi kèo bóng đá truoctran phản hồi xác thực phù hợp (như mật khẩu). Đối với tất cả các phương thức xác thực ngoại trừ GSSAPI và SSPI, có nhiều nhất là một yêu cầu và một phản hồi.
Chu kỳ xác thực kết thúc bằng máy chủ từ chối cố gắng kết nối (ErrorResponse) hoặc gửi xác thực.
Các soi kèo bóng đá truoctran có thể từ máy chủ trong giai đoạn này là:
Nỗ lực kết nối đã bị từ chối. Máy chủ sau đó đóng ngay kết nối.
Trao đổi xác thực được hoàn thành thành công.
Frontend hiện phải tham gia hộp thoại xác thực Kerberos V5 (không được mô tả ở đây, soi kèo bóng đá truoctran phần của đặc tả Kerberos) với máy chủ. Nếu điều này thành công, máy chủ sẽ phản hồi với xác thực, nếu không nó sẽ phản hồi bằng soi kèo bóng đá truoctran lỗi.
Frontend hiện phải gửi Mật khẩu có chứa mật khẩu ở dạng văn bản rõ ràng. Nếu đây là mật khẩu chính xác, máy chủ sẽ phản hồi bằng xác thực, nếu không nó sẽ trả lời với soi kèo bóng đá truoctran errorResponse.
Frontend hiện phải gửi mật khẩu có chứa mật khẩu (có tên người dùng) được mã hóa qua MD5, sau đó được mã hóa lại bằng cách sử dụng muối ngẫu nhiên 4 byte được chỉ định trong soi kèo bóng đá truoctran xác thựcMD5Password. Nếu đây là mật khẩu chính xác, máy chủ sẽ trả lời với xác thực, nếu không nó sẽ trả lời với ErrorResponse.Concat ('MD5', MD5 (Concat (MD5 (Concat (Mật khẩu, tên người dùng)). (Hãy ghi nhớmd5 ()hàm trả về kết quả của nó dưới dạng chuỗi hex.)
Phản hồi này chỉ có thể đối với các kết nối miền đơn vị cục bộ trên các nền tảng hỗ trợ các soi kèo bóng đá truoctran chứng thực SCM. Frontend phải phát hành một thông báo thông tin đăng nhập SCM và sau đó gửi một byte dữ liệu duy nhất.
Frontend hiện phải bắt đầu đàm phán GSSAPI. Frontend sẽ gửi soi kèo bóng đá truoctran mật khẩu với phần đầu tiên của luồng dữ liệu GSSAPI để đáp ứng với điều này.
Frontend hiện phải bắt đầu đàm phán SSPI. Frontend sẽ gửi soi kèo bóng đá truoctran mật khẩu với phần đầu tiên của luồng dữ liệu SSPI để đáp ứng với điều này.
soi kèo bóng đá truoctran này chứa dữ liệu phản hồi từ bước trước đó của đàm phán GSSAPI hoặc SSPI (xác thựcGSS, xác thựcSPI hoặc xác thực trước đây). Nếu dữ liệu GSSAPI hoặc SSPI trong soi kèo bóng đá truoctran này cho biết cần nhiều dữ liệu hơn để hoàn thành xác thực, thì frontend phải gửi dữ liệu đó dưới dạng mật khẩu khác.
Máy chủ không hỗ trợ phiên bản giao thức nhỏ được khách hàng yêu cầu, nhưng không hỗ trợ phiên bản trước của giao thức; soi kèo bóng đá truoctran này cho biết phiên bản nhỏ được hỗ trợ cao nhất._PQ_.) trong gói khởi động. soi kèo bóng đá truoctran này sẽ được theo sau bởi ErrorResponse hoặc một soi kèo bóng đá truoctran cho biết sự thành công hay thất bại của xác thực.
Nếu frontend soi kèo bóng đá truoctran hỗ trợ phương thức xác thực được yêu cầu bởi máy chủ, thì nó sẽ ngay lập tức đóng kết nối.
Sau khi nhận được xác thực, frontend phải chờ thêm soi kèo bóng đá truoctran từ máy chủ. Trong giai đoạn này, một quá trình phụ trợ đang được bắt đầu, và Frontend chỉ là một người ngoài cuộc quan tâm.
Trong giai đoạn này, phụ trợ sẽ cố gắng áp dụng bất kỳ cài đặt tham số thời gian chạy bổ sung nào được đưa ra trong soi kèo bóng đá truoctran khởi động. Nếu thành công, các giá trị này sẽ trở thành mặc định phiên.
Các soi kèo bóng đá truoctran có thể từ phần phụ trợ trong giai đoạn này là:
Thông báo này cung cấp dữ liệu khóa bí mật mà frontend phải lưu nếu muốn có thể đưa ra các yêu cầu hủy sau này. Frontend không nên trả lời soi kèo bóng đá truoctran này, nhưng sẽ tiếp tục nghe một soi kèo bóng đá truoctran ReadyForQuery.
soi kèo bóng đá truoctran này soi kèo bóng đá truoctran cho Frontend về cài đặt (ban đầu) hiện tại của các tham số phụ trợ, chẳng hạn nhưclient_encodinghoặcDatestyle. Frontend có thể bỏ qua soi kèo bóng đá truoctran này hoặc ghi lại các cài đặt để sử dụng trong tương lai;Phần 51.2.6Để biết thêm chi tiết. Frontend không nên trả lời soi kèo bóng đá truoctran này, nhưng sẽ tiếp tục nghe một soi kèo bóng đá truoctran ReadyForQuery.
Khởi nghiệp được hoàn thành. Frontend hiện có thể phát hành các lệnh.
Khởi nghiệp không thành công. Kết nối được đóng sau khi gửi soi kèo bóng đá truoctran này.
Một thông điệp cảnh báo đã được ban hành. Frontend sẽ hiển thị soi kèo bóng đá truoctran nhưng tiếp tục nghe ReadyForQuery hoặc ErrorResponse.
Thông báo ReadyForQuery là cùng một soi kèo bóng đá truoctran mà phần phụ trợ sẽ phát hành sau mỗi chu kỳ lệnh. Tùy thuộc vào nhu cầu mã hóa của Frontend, thật hợp lý khi coi ReadyForQuery là bắt đầu một chu kỳ lệnh hoặc xem xét ReadyForQuery là kết thúc giai đoạn khởi động và mỗi chu kỳ lệnh tiếp theo.
Một chu trình truy vấn đơn giản được bắt đầu bởi frontend gửi một soi kèo bóng đá truoctran truy vấn đến phần phụ trợ. soi kèo bóng đá truoctran bao gồm một lệnh SQL (hoặc lệnh) được thể hiện dưới dạng chuỗi văn bản.
soi kèo bóng đá truoctran phản hồi có thể từ phần phụ trợ là:
lệnh SQL hoàn thành bình thường.
The backend is ready to copy data from the frontend to a table; nhìn thấyPhần 51.2.5.
Phần phụ trợ đã sẵn sàng sao chép dữ liệu từ bảng đến mặt trận; nhìn thấyPhần 51.2.5.
chỉ ra rằng các hàng sắp được trả lại để đáp ứng với AChọn, Fetch, vv Truy vấn. Nội dung của soi kèo bóng đá truoctran này mô tả bố cục cột của các hàng.
soi kèo bóng đá truoctran trong những hàng hàng được trả về bởi AChọn, Fetch, ETC truy vấn.
soi kèo bóng đá truoctran chuỗi truy vấn trống đã được nhận ra.
Đã xảy ra lỗi.
Xử lý chuỗi truy vấn đã hoàn tất. Một soi kèo bóng đá truoctran riêng được gửi để cho biết điều này vì chuỗi truy vấn có thể chứa nhiều lệnh SQL.
Một soi kèo bóng đá truoctran cảnh báo đã được đưa ra liên quan đến truy vấn. Các soi kèo bóng đá truoctran ngoài các câu trả lời khác, tức là, phần phụ trợ sẽ tiếp tục xử lý lệnh.
Phản hồi cho AChọnTruy vấn (hoặc các truy vấn khác trả về các bộ hàng, chẳng hạn nhưGiải thíchhoặcshow20979_21077CopyĐến hoặc từ Frontend gọi giao thức đặc biệt như được mô tả trongPhần 51.2.5. Tất cả các loại truy vấn khác thường chỉ tạo ra một soi kèo bóng đá truoctran CommandComplete.
Vì soi kèo bóng đá truoctran chuỗi truy vấn có thể chứa soi kèo bóng đá truoctran số truy vấn (được phân tách bằng dấu chấm phẩy), nên có thể có soi kèo bóng đá truoctran số chuỗi phản hồi như vậy trước khi kết thúc phụ trợ xử lý chuỗi truy vấn. ReadyForQuery được phát hành khi toàn bộ chuỗi đã được xử lý và phụ trợ đã sẵn sàng để chấp nhận soi kèo bóng đá truoctran chuỗi truy vấn mới.
Nếu nhận được chuỗi hoàn toàn trống (soi kèo bóng đá truoctran có nội dung nào khác ngoài khoảng trắng)
Trong trường hợp có lỗi, ErrorResponse được cấp theo sau là ReadyForQuery. Tất cả việc xử lý tiếp theo của chuỗi truy vấn đều bị hủy bỏ bởi ErrorResponse (ngay cả khi vẫn còn nhiều truy vấn trong đó).
Trong chế độ truy vấn đơn giản, định dạng của các giá trị truy xuất luôn luôn là văn bản, ngoại trừ khi lệnh đã cho làFetchTừ con trỏ được khai soi kèo bóng đá truoctran vớinhị phânTùy chọn. Trong trường hợp đó, các giá trị được truy xuất ở định dạng nhị phân.
Một frontend phải được chuẩn bị để chấp nhận các soi kèo bóng đá truoctran ErrorResponse và NoticeResponse bất cứ khi nào nó mong đợi bất kỳ loại soi kèo bóng đá truoctran nào khác. Xem thêmPhần 51.2.6Liên quan đến các soi kèo bóng đá truoctran mà phần phụ trợ có thể tạo do các sự kiện bên ngoài.
22713_22925
Giao thức truy vấn mở rộng chia nhỏ giao thức truy vấn đơn giản được mô tả ở trên thành nhiều bước. Kết quả của các bước chuẩn bị có thể được sử dụng lại nhiều lần để cải thiện hiệu quả.
Trong giao thức mở rộng, Frontend trước tiên sẽ gửi một thông báo phân tích cú pháp, chứa một chuỗi truy vấn văn bản, tùy chọn một số thông soi kèo bóng đá truoctran về các kiểu giữ chỗ dữ liệu và tên của một đối tượng định mức chuẩn bị đích (một chuỗi trống chọn câu lệnh đã chuẩn bị không được đặt tên). Phản hồi là Parsecomplete hoặc ErrorResponse.
Lưu ý:24037_24201$n) Được sử dụng trong chuỗi truy vấn. soi kèo bóng đá truoctran trường hợp đặc biệt khác là loại tham số có thể được chỉ định làvoid(nghĩa là oid củavoidPseudotype). Điều này có nghĩa là để cho phép các ký hiệu tham số được sử dụng cho các tham số chức năng thực sự là các tham số.voidtham số có thể được sử dụng, nhưng nếu soi kèo bóng đá truoctran biểu tượng tham số như vậy xuất hiện trong danh sách tham số của hàm, nó sẽ bị bỏ qua soi kèo bóng đá truoctran cách hiệu quả. Ví dụ: cuộc gọi chức năng nhưfoo ($ 1, $ 2, $ 3, $ 4)có thể khớp với soi kèo bóng đá truoctran hàm với hai trong và hai đối số ra, nếu$ 3và$ 4được chỉ định là có loạivoid.
Lưu ý:Chuỗi truy vấn có trong soi kèo bóng đá truoctran phân tích không thể bao gồm nhiều câu lệnh SQL; khác là một lỗi cú pháp được báo cáo.
Nếu được tạo thành công, soi kèo bóng đá truoctran đối tượng đã chuẩn bị được đặt tên kéo dài cho đến cuối phiên hiện tại, trừ khi bị phá hủy rõ ràng. soi kèo bóng đá truoctran tuyên bố được chuẩn bị không tên chỉ kéo dài cho đến khi câu lệnh phân tích điện phân tiếp theo chỉ định câu lệnh không tên là đích được đưa ra.Chuẩn bịvàthực thi.
Một khi một câu lệnh đã chuẩn bị tồn tại, nó có thể được chuẩn bị để thực thi bằng soi kèo bóng đá truoctran liên kết. Thông báo ràng buộc cho biết tên của câu lệnh được chuẩn bị nguồn (chuỗi trống biểu thị câu lệnh đã chuẩn bị không tên), tên của cổng thông tin đích (chuỗi trống biểu thị cổng thông tin không tên) và các giá trị sẽ sử dụng cho bất kỳ người giữ chỗ tham số nào có trong câu lệnh đã chuẩn bị.voidtham số trong soi kèo bóng đá truoctran phân tích, truyền các giá trị null cho chúng trong soi kèo bóng đá truoctran liên kết.) Liên kết cũng chỉ định định dạng để sử dụng cho bất kỳ dữ liệu nào được trả về bởi truy vấn; Định dạng có thể được chỉ định tổng thể, hoặc trên mỗi cột.
Lưu ý:Sự lựa chọn giữa văn bản và đầu ra nhị phân được xác định bởi các mã định dạng được đưa ra trong ràng buộc, bất kể lệnh SQL liên quan. Thenhị phânThuộc tính trong khai soi kèo bóng đá truoctran con trỏ là không liên quan khi sử dụng giao thức truy vấn mở rộng.
Kế hoạch truy vấn thường xảy ra khi soi kèo bóng đá truoctran liên kết được xử lý. Nếu câu lệnh đã chuẩn bị không có tham số hoặc được thực thi nhiều lần, máy chủ có thể lưu gói đã tạo và sử dụng lại nó trong các soi kèo bóng đá truoctran ràng buộc tiếp theo cho cùng một câu lệnh đã chuẩn bị.
Nếu được tạo thành công, một đối tượng cổng thông soi kèo bóng đá truoctran có tên kéo dài cho đến khi kết thúc giao dịch hiện tại, trừ khi bị phá hủy rõ ràng. Một cổng thông soi kèo bóng đá truoctran không tên bị phá hủy vào cuối giao dịch hoặc ngay khi câu lệnh liên kết tiếp theo chỉ định cổng thông soi kèo bóng đá truoctran không tên là đích được phát hành.Tuyên bố con trỏvàFetch.
Một khi một cổng thông tin tồn tại, nó có thể được thực thi bằng soi kèo bóng đá truoctran thực thi. Thông báo thực thi chỉ định tên cổng thông tin (chuỗi trống biểu thị cổng thông tin không tên) và số lượng hàng kết quả tối đa (không có nghĩa là"Tìm nạp tất cả các hàng"). Số lượng hàng kết quả chỉ có ý nghĩa đối với các cổng chứa các lệnh trả về các bộ hàng;
29022_29673
Khi hoàn thành mỗi loạt các soi kèo bóng đá truoctran trình độ mở rộng, Frontend sẽ phát hành soi kèo bóng đá truoctran đồng bộ hóa. Thông báo không tham số này khiến phần phụ trợ đóng giao dịch hiện tại nếu nó không ở trongBắt đầu/cam kếtKhối giao dịch ("Đóng"Có nghĩa là cam kết nếu không có lỗi hoặc quay lại nếu lỗi). Sau đó, soi kèo bóng đá truoctran phản hồi ReadyForQuery được ban hành.trong khiXử lý đồng bộ hóa - Điều này đảm bảo rằng có soi kèo bóng đá truoctran và chỉ có soi kèo bóng đá truoctran Sẵn sàng được gửi cho mỗi lần đồng bộ
Lưu ý:SYNC soi kèo bóng đá truoctran gây ra khối giao dịch được mở bằngBắt đầusẽ được đóng. Có thể phát hiện tình huống này vì thông báo ReadyForQuery bao gồm thông soi kèo bóng đá truoctran trạng thái giao dịch.
Ngoài các hoạt động cơ bản, cần thiết này, còn có soi kèo bóng đá truoctran số hoạt động tùy chọn có thể được sử dụng với giao thức trình điều khiển mở rộng.
Thông báo mô tả (biến thể cổng thông soi kèo bóng đá truoctran) Chỉ định tên của một cổng thông soi kèo bóng đá truoctran hiện có (hoặc một chuỗi trống cho cổng thông soi kèo bóng đá truoctran không tên). Phản hồi là một thông báo Rowdes mô tả các hàng sẽ được trả về bằng cách thực hiện cổng thông soi kèo bóng đá truoctran;
soi kèo bóng đá truoctran mô tả (biến thể câu lệnh) Chỉ định tên của một câu lệnh đã chuẩn bị hiện có (hoặc một chuỗi trống cho câu lệnh đã chuẩn bị không tên). Phản hồi là một soi kèo bóng đá truoctran tham số mô tả các tham số cần thiết cho câu lệnh, theo sau là soi kèo bóng đá truoctran ROWDES mô tả các hàng sẽ được trả về khi câu lệnh cuối cùng được thực thi (hoặc soi kèo bóng đá truoctran NODATA nếu câu lệnh sẽ không trả lại hàng).
Tip:Trong hầu hết các kịch bản, Frontend nên đưa ra soi kèo bóng đá truoctran hoặc biến thể khác của mô tả trước khi phát hành thực thi, để đảm bảo rằng nó biết cách diễn giải kết quả mà nó sẽ quay lại.
Thông điệp gần gũi đóng một câu lệnh hoặc cổng thông soi kèo bóng đá truoctran đã chuẩn bị hiện có và phát hành tài nguyên. Nó không phải là một lỗi để phát hành gần với câu lệnh hoặc tên cổng thông soi kèo bóng đá truoctran không tồn tại.
soi kèo bóng đá truoctran Flush không gây ra bất kỳ đầu ra cụ thể nào được tạo, nhưng buộc phần phụ trợ để cung cấp bất kỳ dữ liệu nào đang chờ xử lý trong bộ đệm đầu ra của nó. Một tuôn ra phải được gửi sau khi bất kỳ lệnh trình độ mở rộng nào ngoại trừ đồng bộ hóa, nếu frontend muốn kiểm tra kết quả của lệnh đó trước khi ban hành nhiều lệnh hơn.
Lưu ý:Thông báo truy vấn đơn giản xấp xỉ tương đương với chuỗi phân tích, BIND, Cổng mô tả, thực thi, đóng, đồng bộ hóa, sử dụng câu lệnh đã chuẩn bị không được đặt tên và đối tượng cổng thông soi kèo bóng đá truoctran và không có tham số. Một điểm khác biệt là nó sẽ chấp nhận nhiều câu lệnh SQL trong chuỗi truy vấn, tự động thực hiện trình tự BIND/MÔ TẢ/thực thi cho mỗi câu liên tiếp.
Hàm gọi phụ cho phép máy khách yêu cầu gọi trực tiếp của bất kỳ chức năng nào tồn tại trong cơ sở dữ liệuPG_PROCDanh mục hệ thống. Máy khách phải có quyền thực thi cho chức năng.
Lưu ý:Hàm gọi phụ là soi kèo bóng đá truoctran tính năng di sản có lẽ được tránh tốt nhất trong mã mới. Kết quả tương tự có thể được thực hiện bằng cách thiết lập soi kèo bóng đá truoctran câu lệnh đã chuẩn bịChọn chức năng ($ 1, ...). Chu trình cuộc gọi chức năng sau đó có thể được thay thế bằng BIND/EXECUTE.
Chu kỳ cuộc gọi chức năng được bắt đầu bởi Frontend gửi một thông báo FunctionCall đến phần phụ trợ. Phần phụ trợ sau đó gửi một hoặc nhiều soi kèo bóng đá truoctran phản hồi tùy thuộc vào kết quả của cuộc gọi chức năng và cuối cùng là một thông báo phản hồi ReadyForQuery.
soi kèo bóng đá truoctran phản hồi có thể từ phần phụ trợ là:
Đã xảy ra lỗi.
Cuộc gọi chức năng đã được hoàn thành và trả về kết quả được đưa ra trong soi kèo bóng đá truoctran. (Lưu ý rằng giao thức cuộc gọi chức năng chỉ có thể xử lý một kết quả vô hướng, không phải là loại hàng hoặc tập hợp kết quả.)
Xử lý cuộc gọi chức năng đã hoàn tất. ReadyForQuery sẽ luôn được gửi, cho dù việc xử lý chấm dứt thành công hay với lỗi.
Một soi kèo bóng đá truoctran cảnh báo đã được ban hành liên quan đến cuộc gọi chức năng. Các soi kèo bóng đá truoctran ngoài các câu trả lời khác, tức là, phần phụ trợ sẽ tiếp tục xử lý lệnh.
TheCopyLệnh cho phép truyền dữ liệu hàng loạt tốc độ cao đến hoặc từ máy chủ. Các hoạt động sao chép và sao chép mỗi lần chuyển kết nối thành soi kèo bóng đá truoctran giao thức phụ riêng biệt, kéo dài cho đến khi hoạt động hoàn tất.
Chế độ sao chép (truyền dữ liệu vào máy chủ) được bắt đầu khi phần phụ trợ thực thi ASao chép từ StdinTuyên bố SQL. Phần phụ trợ gửi một soi kèo bóng đá truoctran copyInresponse đến frontend.CopyCâu lệnh SQL soi kèo bóng đá truoctran thành công với lỗi). Phần phụ trợ sau đó trở lại chế độ xử lý lệnh mà nó đã ở trướcCopyBắt đầu, sẽ là giao thức truy vấn đơn giản hoặc mở rộng. Tiếp theo nó sẽ gửi soi kèo bóng đá truoctran trong hai CommandComplete (nếu thành công) hoặc errorResponse (nếu không).
Trong trường hợp lỗi được phát hiện theo hướng phụ trợ trong chế độ sao chép (bao gồm nhận thông báo copyfail), phần phụ trợ sẽ phát hành soi kèo bóng đá truoctran ErrorResponse. NếuCopyLệnh đã được cấp thông qua một thông báo trình biết mở rộng, phần phụ trợ bây giờ sẽ loại bỏ các soi kèo bóng đá truoctran phía trước cho đến khi nhận được soi kèo bóng đá truoctran đồng bộ hóa, sau đó nó sẽ phát hành ReadyForQuery và trở lại xử lý thông thường. NếuCopyLệnh đã được cấp trong một thông báo truy vấn đơn giản, phần còn lại của soi kèo bóng đá truoctran đó bị loại bỏ và ReadyForQuery được phát hành. Trong cả hai trường hợp, bất kỳ soi kèo bóng đá truoctran copyData, copyDone hoặc copyfail nào tiếp theo do frontend ban hành sẽ đơn giản là bị loại bỏ.
Phần phụ trợ sẽ bỏ qua các soi kèo bóng đá truoctran tuôn ra và đồng bộ hóa nhận được trong chế độ sao chép. Nhận bất kỳ loại soi kèo bóng đá truoctran không sao chép nào khác tạo thành một lỗi sẽ hủy bỏ trạng thái sao chép như được mô tả ở trên.Sao chép từ Stdin.)
Chế độ sao chép (truyền dữ liệu từ máy chủ) được bắt đầu khi phần phụ trợ thực thiSao chép vào stdoutCâu lệnh SQL. Phần phụ trợ gửi một thông báo CopyouTresponse đến phía trước, theo sau là không có hoặc nhiều soi kèo bóng đá truoctran copyData (luôn luôn một mỗi hàng), theo sau là copyDone.CopyBắt đầu và gửi CommandComplete. Frontend không thể hủy bỏ việc chuyển nhượng (ngoại trừ bằng cách đóng kết nối hoặc đưa ra yêu cầu hủy), nhưng nó có thể loại bỏ các soi kèo bóng đá truoctran copyData và copyDone không mong muốn.
Trong trường hợp lỗi được phát hiện theo phụ trợ trong chế độ sao chép, phụ trợ sẽ phát hành soi kèo bóng đá truoctran ErrorResponse và trở lại xử lý thông thường. Frontend nên coi việc nhận của ErrorResponse là chấm dứt chế độ sao chép.
Có thể soi kèo bóng đá truoctran noticeResponse và parameterstatus được xen kẽ giữa các soi kèo bóng đá truoctran copyData; Frontends phải xử lý các trường hợp này và cũng nên được chuẩn bị cho các loại soi kèo bóng đá truoctran không đồng bộ khác (xemPhần 51.2.6). Nếu không, bất kỳ loại soi kèo bóng đá truoctran nào khác ngoài COPYDATA hoặc COPYDONE có thể được coi là Chế độ sao chép kết thúc.
Có soi kèo bóng đá truoctran chế độ liên quan đến bản sao khác được gọi là Copy-Both, cho phép truyền dữ liệu hàng loạt tốc độ cao sangvàTừ máy chủ. Copy-Both Mode được bắt đầu khi phần phụ trợ trong chế độ Walsender thực thistart_ReplicationCâu lệnh. Phần phụ trợ gửi một soi kèo bóng đá truoctran copybothresponse đến frontend.Phần 51.3Để biết thêm thông soi kèo bóng đá truoctran về Subrotocol được truyền qua chế độ sao chép-cả.
soi kèo bóng đá truoctran CopyInresponse, CopyouTresponse và CopyBothResponse bao gồm các trường thông báo cho số lượng cột mỗi hàng và mã định dạng được sử dụng cho mỗi cột. (Kể từ khi triển khai hiện tại, tất cả các cột trong một đã choCopyHoạt động sẽ sử dụng cùng một định dạng, nhưng thiết kế soi kèo bóng đá truoctran không giả định điều này.)
Có một số trường hợp phụ trợ sẽ gửi soi kèo bóng đá truoctran không được nhắc cụ thể bởi luồng lệnh của Frontend. Frontends phải được chuẩn bị để đối phó với các soi kèo bóng đá truoctran này bất cứ lúc nào, ngay cả khi không tham gia vào một truy vấn.
Có thể tạo các soi kèo bóng đá truoctran của NoticeResponse được tạo do hoạt động bên ngoài; Ví dụ: nếu quản trị viên cơ sở dữ liệu ra lệnh"Fast"Tắt cơ sở dữ liệu, phần phụ trợ sẽ gửi một NoticeResponse cho biết thực tế này trước khi đóng kết nối. Theo đó, Frontends phải luôn luôn được chuẩn bị để chấp nhận và hiển thị các soi kèo bóng đá truoctran NoticeResponse, ngay cả khi kết nối không hoạt động.
Thông số thông báo sẽ được tạo bất cứ khi nào giá trị hoạt động thay đổi cho bất kỳ tham số nào mà phần phụ trợ soi kèo bóng đá truoctran rằng Frontend nên biết. Thông thường nhất là điều này xảy ra để đáp ứng vớisetLệnh SQL được thực hiện bởi Frontend và trường hợp này có hiệu quả đồng bộ - nhưng cũng có thể thay đổi trạng thái tham số xảy ra vì quản trị viên đã thay đổi tệp cấu hình và sau đó gửiSIGHUPTín hiệu cho máy chủ. Ngoài ra, nếu soi kèo bóng đá truoctransetLệnh được quay lại, một soi kèo bóng đá truoctran tham số thích hợp sẽ được tạo để báo cáo giá trị hiệu quả hiện tại.
Hiện tại có soi kèo bóng đá truoctran bộ tham số có dây cứng mà tham số sẽ được tạo ra: chúng làserver_version, server_encoding, client_encoding, application_name, is_superuser, session_Authorization, Datestyle, IntervalStyle, timezone, integer_datetimesvàStandard_Conforming_Strings. (server_encoding, timezonevàinteger_datetimeskhông được soi kèo bóng đá truoctran cáo bởi các bản phát hành trước 8.0;Standard_Conforming_Stringskhông được soi kèo bóng đá truoctran cáo bởi các bản phát hành trước 8.1;IntervalStyleKhông được soi kèo bóng đá truoctran cáo bởi các bản phát hành trước 8.4;application_nameKhông được soi kèo bóng đá truoctran cáo bởi các bản phát hành trước 9.0.) Lưu ý rằngserver_version, server_encodingvàinteger_datetimeslà các tham số giả soi kèo bóng đá truoctran thể thay đổi sau khi khởi động. Bộ này có thể thay đổi trong tương lai, hoặc thậm chí trở thành cấu hình.
Nếu Frontend phát hành ANghe44068_44191soi kèo bóng đá truoctranLệnh được thực thi cho cùng tên kênh.
Lưu ý:Hiện tại, soi kèo bóng đá truoctran chỉ có thể được gửi bên ngoài một giao dịch và do đó nó sẽ không xảy ra ở giữa một chuỗi phản hồi lệnh, mặc dù nó có thể xảy ra ngay trước khi ReadyForQuery. Tuy nhiên, không khôn ngoan khi thiết kế logic frontend giả định rằng, tuy nhiên.
Trong quá trình xử lý truy vấn, frontend có thể yêu cầu hủy truy vấn. Yêu cầu Hủy soi kèo bóng đá truoctran được gửi trực tiếp trên kết nối mở đến phần phụ trợ vì lý do hiệu quả thực hiện: Chúng tôi soi kèo bóng đá truoctran muốn có phần phụ trợ liên tục kiểm tra đầu vào mới từ phía trước trong quá trình xử lý truy vấn.
Để đưa ra yêu cầu Hủy, Frontend mở kết nối mới đến máy chủ và gửi soi kèo bóng đá truoctran DECCEQUEST, thay vì thông báo startupMessage thường được gửi qua kết nối mới. Máy chủ sẽ xử lý yêu cầu này và sau đó đóng kết nối.
soi kèo bóng đá truoctran hủyRequest sẽ bị bỏ qua trừ khi nó chứa cùng một dữ liệu khóa (khóa PID và Bí mật) được chuyển đến Frontend trong quá trình khởi động kết nối. Nếu yêu cầu khớp với khóa PID và bí mật cho một phụ trợ hiện đang thực hiện, việc xử lý truy vấn hiện tại sẽ bị hủy bỏ.
Tín hiệu hủy có thể hoặc có thể không có bất kỳ ảnh hưởng nào - ví dụ, nếu nó đến sau khi phần phụ trợ đã hoàn tất việc xử lý truy vấn, thì nó sẽ không có tác dụng. Nếu hủy bỏ có hiệu lực, nó sẽ dẫn đến lệnh hiện tại bị chấm dứt sớm với soi kèo bóng đá truoctran lỗi.
Kết quả của tất cả điều này là vì lý do của cả bảo mật và hiệu quả, mặt tiền không có cách trực tiếp nào để biết liệu soi kèo bóng đá truoctran yêu cầu hủy có thành công hay không. Nó phải tiếp tục chờ đợi phần phụ trợ để trả lời truy vấn.
Vì yêu cầu hủy được gửi qua kết nối mới đến máy chủ chứ không phải trên liên kết giao tiếp phía trước/phụ trợ soi kèo bóng đá truoctran thường, nên có thể yêu cầu hủy được cấp bởi bất kỳ quy trình nào, không chỉ là truy vấn của họ sẽ bị hủy. Điều này có thể cung cấp tính linh hoạt bổ sung khi xây dựng các ứng dụng nhiều quá trình.
Quy trình chấm dứt bình thường, duyên dáng là Frontend gửi soi kèo bóng đá truoctran chấm dứt và ngay lập tức đóng kết nối. Khi nhận được soi kèo bóng đá truoctran này, phụ trợ đóng kết nối và chấm dứt.
Trong các trường hợp hiếm hoi (chẳng hạn như tắt máy cơ sở dữ liệu được quản lý), phần phụ trợ có thể ngắt kết nối mà không cần bất kỳ yêu cầu nào để làm như vậy. Trong những trường hợp như vậy, phụ trợ sẽ cố gắng gửi một lỗi hoặc soi kèo bóng đá truoctran soi kèo bóng đá truoctran đưa ra lý do cho sự ngắt kết nối trước khi nó đóng kết nối.
Các kịch bản chấm dứt khác phát sinh từ các trường hợp thất bại khác nhau, chẳng hạn như kết xuất lõi ở đầu này hay đầu kia, mất liên kết liên lạc, mất đồng bộ hóa liên kết soi kèo bóng đá truoctran, v.v. Frontend có tùy chọn khởi chạy một phụ trợ mới bằng cách giới thiệu lại máy chủ nếu nó không muốn tự chấm dứt.
Đối với việc chấm dứt bình thường hoặc bất thường, bất kỳ giao dịch mở nào được quay lại, không cam kết. Tuy nhiên, người ta nên lưu ý rằng nếu soi kèo bóng đá truoctran frontend ngắt kết nối trong khi khôngChọnTruy vấn đang được xử lý, phần phụ trợ có thể sẽ hoàn thành truy vấn trước khi nhận thấy sự ngắt kết nối. Nếu truy vấn nằm ngoài bất kỳ khối giao dịch nào (bắt đầu...cam kếtTrình tự) Sau đó, kết quả của nó có thể được thực hiện trước khi ngắt kết nối được nhận ra.
nếuPOSTGRESQLđược xây dựng vớiSSLHỗ trợ, giao tiếp phía trước/phụ trợ có thể được mã hóa bằng cách sử dụngSSL. Điều này cung cấp bảo mật truyền soi kèo bóng đá truoctran trong các môi trường nơi những kẻ tấn công có thể nắm bắt lưu lượng phiên.PostgreSQLPhiên vớiSSL, xemPhần 18.9.
Để bắt đầuSSLKết nối -Crypted, Frontend ban đầu gửi soi kèo bóng đá truoctran SSLRequest thay vì StartupMessage. Máy chủ sau đó trả lời với một byte duy nhất có chứaShoặcn, chỉ ra rằng nó sẵn sàng hoặc soi kèo bóng đá truoctran muốn thực hiệnSSL, tương ứng. Mặt trận có thể đóng kết nối tại thời điểm này nếu nó soi kèo bóng đá truoctran hài lòng với phản hồi.S, thực hiệnSSLbắt tay khởi động (không được mô tả ở đây, soi kèo bóng đá truoctran phần củaSSLĐặc điểm kỹ thuật) với máy chủ. Nếu điều này thành công, tiếp tục gửi cho StartupMessage soi kèo bóng đá truoctran thường.SSL-encrypted. Để tiếp tục saun, Gửi phần khởi động soi kèo bóng đá truoctran thường và tiến hành mà không cần mã hóa.
Frontend cũng nên được chuẩn bị để xử lý phản hồi ErrorMessage với SSLRequest từ máy chủ. Điều này sẽ chỉ xảy ra nếu máy chủ có trước việc bổ sungSSLHỗ trợ choPostgreSQL. .SSL.
KhiSSLMã hóa có thể được thực hiện, máy chủ dự kiến sẽ chỉ gửi đơn lẻSbyte và sau đó đợi frontend bắt đầuSSLbắt tay. Nếu các byte bổ sung có sẵn để đọc tại thời điểm này, điều đó có thể có nghĩa là soi kèo bóng đá truoctran người đàn ông đang cố gắng thực hiện soi kèo bóng đá truoctran cuộc tấn công quá trình đệm bộ đệm (CVE-2021-23222). Frontends nên được mã hóa để đọc chính xác soi kèo bóng đá truoctran byte từ ổ cắm trước khi chuyển ổ cắm sang thư viện SSL của họ hoặc coi nó là vi phạm giao thức nếu họ thấy họ đã đọc Byte bổ sung.
SSLRequest ban đầu cũng có thể được sử dụng trong một kết nối đang được mở để gửi soi kèo bóng đá truoctran Decc
Trong khi giao thức soi kèo bóng đá truoctran cung cấp cách để máy chủ buộcSSLMã hóa, Quản trị viên có thể định cấu hình máy chủ để từ chối các phiên soi kèo bóng đá truoctran được mã hóa dưới dạng sản phẩm phụ của kiểm tra xác thực.