ThePQEXECHàm là đủ để gửi các cách đọc kèo bóng đá trong các ứng dụng bình thường, đồng bộ. Nó có một vài thiếu sót, tuy nhiên, có thể quan trọng đối với một số người dùng:
PQEXECĐợi lệnh được hoàn thành. Ứng dụng có thể có công việc khác phải làm (chẳng hạn như duy trì giao diện người dùng), trong trường hợp đó sẽ cách đọc kèo bóng đá muốn chặn chờ phản hồi.
Vì việc thực hiện ứng dụng máy khách bị đình chỉ trong khi chờ kết quả, rất khó để ứng dụng quyết định rằng họ muốn cố gắng hủy lệnh liên tục. (Nó có thể được thực hiện từ một trình xử lý tín hiệu, nhưng cách đọc kèo bóng đá phải khác.)
PQEXECchỉ có thể trả về mộtpgresultCấu trúc. Nếu chuỗi cách đọc kèo bóng đá đã gửi chứa nhiềuSQLCác cách đọc kèo bóng đá, tất cả trừ cuối cùngpgresultbị loại bỏ bởiPQEXEC.
PQEXECLuôn thu thập toàn bộ kết quả của cách đọc kèo bóng đá, đệm nó trong mộtpgresult. Mặc dù điều này đơn giản hóa logic xử lý lỗi cho ứng dụng, nhưng nó có thể cách đọc kèo bóng đá thực tế đối với kết quả có chứa nhiều hàng.
Các ứng dụng cách đọc kèo bóng đá thích những hạn chế này thay vào đó có thể sử dụng các chức năng cơ bản màPQEXECđược xây dựng từ:PQSendQueryvàPQGetResult. Cũng cóPQSendQueryParams, PQSendPrepare, PQSendQueryPrepared, và, có thể được sử dụng vớiPQGetResultĐể nhân đôi chức năng củaPQExecparams, PQPrepare, PQEXECPREPARED, vàPQDescriptePortaltương ứng.
PQSendQuery gửi lệnh lên máy chủ mà cách đọc kèo bóng đá cần chờ kết quả. 1 được trả về nếu lệnh được gửi thành công và 0 nếu cách đọc kèo bóng đá (trong trường hợp đó, sử dụngpqerrormessageĐể biết thêm thông tin về sự thất bại).
int pqsendquery (pgconn *Conn, const char *cách đọc kèo bóng đá);
Sau khi gọi thành côngPQSendQuery, gọiPQGetResultMột hoặc nhiều lần để có được kết quả.PQSendQuerycách đọc kèo bóng đá thể được gọi lại (trên cùng một kết nối) cho đến khiPQGetResultđã trả về một con trỏ null, cho biết rằng cách đọc kèo bóng đá đã được thực hiện.
PQSendQueryParams Đệ trình lệnh và riêng biệt các tham số cho máy chủ mà cách đọc kèo bóng đá cần chờ kết quả
int pqsendqueryparams (pgconn *Conn,
cách đọc kèo bóng đá const char *,
int nparams,
const oid *paramtypes,
const char * const * paramValues,
const int *paramlengths,
const int *paramformats,
int resultformat);
Điều này tương đương vớiPQSendQueryNgoại trừ các tham số truy vấn có thể được chỉ định riêng biệt với chuỗi truy vấn. Các tham số của chức năng được xử lý giống hệt vớiPQExecParams. GiốngPQExecparams, nó sẽ cách đọc kèo bóng đá hoạt động trên các kết nối 2.0-giao thức và nó chỉ cho phép một lệnh trong chuỗi truy vấn.
PQSendPrepare Gửi yêu cầu tạo câu lệnh đã chuẩn bị với các tham số đã cho, mà cách đọc kèo bóng đá cần chờ hoàn thành.
int pqsendprepare (pgconn *Conn,
const char *stmtname,
const char *truy vấn,
int nparams,
const oid *paramtypes);
Đây là phiên bản cách đọc kèo bóng đá bộ củaPQPrepare: nó trả về 1 nếu nó có thể gửi yêu cầu và 0 nếu cách đọc kèo bóng đá. Sau một cuộc gọi thành công, hãy gọiPQGetResultĐể xác định xem máy chủ có tạo thành công câu lệnh đã chuẩn bị hay cách đọc kèo bóng đá. Các tham số của chức năng được xử lý giống hệt vớiPQPrepare. GiốngPQPrepare, nó sẽ cách đọc kèo bóng đá hoạt động trên các kết nối 2.0 giao thức.
PQSendQueryPrepared Gửi yêu cầu thực thi câu lệnh đã chuẩn bị với các tham số đã cho, mà cách đọc kèo bóng đá cần chờ kết quả.
int pqsendqueryprepared (PGConn *Conn,
const char *stmtname,
int nparams,
const char * const * paramValues,
const int *paramlengths,
const int *paramformats,
int resultformat);
Điều này tương tự nhưPQSendQueryParams, nhưng cách đọc kèo bóng đá sẽ được thực thi được chỉ định bằng cách đặt tên một câu cách đọc kèo bóng đá được chuẩn bị trước đó, thay vì đưa ra một chuỗi truy vấn. Các tham số của chức năng được xử lý giống hệt vớiPQEXECPREPARED. GiốngPQEXECPREPARED, nó sẽ cách đọc kèo bóng đá hoạt động trên các kết nối 2.0-giao thức.
18518_18631
18664_18731
Đây là phiên bản cách đọc kèo bóng đá bộ của: nó trả về 1 nếu nó có thể gửi yêu cầu và 0 nếu cách đọc kèo bóng đá. Sau một cuộc gọi thành công, hãy gọiPQGetResultĐể có được kết quả. Các tham số của chức năng được xử lý giống hệt với. Giống, nó sẽ cách đọc kèo bóng đá hoạt động trên các kết nối 2.0 giao thức.
Đệ trình yêu cầu lấy thông tin về cổng thông tin được chỉ định mà cách đọc kèo bóng đá cần chờ hoàn thành.
19578_19645
Đây là phiên bản cách đọc kèo bóng đá bộ củaPQDescriptePortal: nó trả về 1 nếu nó có thể gửi yêu cầu và 0 nếu cách đọc kèo bóng đá. Sau một cuộc gọi thành công, hãy gọiPQGetResultĐể có được kết quả. Các tham số của chức năng được xử lý giống hệt vớiPQDescriptePortal. GiốngPQDescriptePortal, nó sẽ cách đọc kèo bóng đá hoạt động trên các kết nối 2.0 giao thức.
PQGetResult Chờ kết quả tiếp theo từ trướcPQSendQuery, PQSendQueryParams, PQSendPrepare, PQSendQueryPrepared, hoặcGọi và trả về nó. Một con trỏ null được trả về khi lệnh hoàn tất và sẽ cách đọc kèo bóng đá còn kết quả nữa.
PQGetResultphải được gọi nhiều lần cho đến khi nó trả về một con trỏ null, cho biết lệnh được thực hiện. (Nếu được gọi khi cách đọc kèo bóng đá có lệnh nào hoạt động,PQGetResultSẽ chỉ trả lại một con trỏ null cùng một lúc.) Mỗi kết quả cách đọc kèo bóng đá có null từPQGetResultnên được xử lý bằng cách sử dụng cùngpgresultCác hàm accessor được mô tả trước đây. Đừng quên giải phóng mỗi đối tượng kết quả vớiPQClearKhi được thực hiện với nó. Lưu ý rằngPQGetResultSẽ chỉ chặn nếu một cách đọc kèo bóng đá đang hoạt động và dữ liệu phản hồi cần thiết chưa được đọc bởiPQConsumeInput.
ngay cả khiPQResultstatusCho biết lỗi nghiêm trọng,PQGetResultnên được gọi cho đến khi nó trả về một con trỏ null, để cho phéplibpqĐể xử lý hoàn toàn thông tin lỗi.
Sử dụngPQSendQueryvàPQGetResultgiải quyết một trongPQEXEC22159_22212SQLCác cách đọc kèo bóng đá, kết quả của các cách đọc kèo bóng đá đó có thể được lấy riêng lẻ. .
Một tính năng khác thường có thể thu được bằngPQSendQueryvàPQGetResultđang truy xuất kết quả truy vấn lớn một hàng tại một thời điểm. Điều này được thảo luận trongPhần 33.5.
Chính nó, gọiPQGetResultVẫn sẽ khiến máy khách chặn cho đến khi máy chủ hoàn thành tiếp theoSQLcách đọc kèo bóng đá. Điều này có thể tránh được bằng cách sử dụng đúng hai chức năng:
PQConsumeInput Nếu đầu vào có sẵn từ máy chủ, hãy tiêu thụ nó.
int pqconsumeinput (pgconn *Conn);
PQConsumeInputThông thường trả về 1 chỉ racách đọc kèo bóng đá có lỗi, nhưng trả về 0 nếu có một số loại rắc rối (trong trường hợp đópqerrormessagecó thể được tư vấn). Lưu ý rằng kết quả cách đọc kèo bóng đá cho biết liệu có bất kỳ dữ liệu đầu vào nào được thu thập hay cách đọc kèo bóng đá. Sau khi gọiPQConsumeInput, ứng dụng có thể kiểm trapqisbusyvà/hoặcpqnotifyesĐể xem trạng thái của họ có thay đổi cách đọc kèo bóng đá.
PQConsumeInputcó thể được gọi ngay cả khi ứng dụng chưa được chuẩn bị để xử lý kết quả hoặc thông báo. Chức năng sẽ đọc dữ liệu có sẵn và lưu nó trong bộ đệm, do đó gây raselect ()Chỉ dẫn đọc sẵn sàng đi. Do đó ứng dụng có thể sử dụngPQConsumeInputđể xóaselect ()Điều kiện ngay lập tức, sau đó kiểm tra kết quả lúc rảnh rỗi.
pqisbusy Trả về 1 nếu một cách đọc kèo bóng đá bận, nghĩa làPQGetResultSẽ chặn chờ nhập. Trả về 0 chỉ ra rằngPQGetResultCó thể được gọi với sự đảm bảo cách đọc kèo bóng đá chặn.
int pqisbusy (pgconn *Conn);
pqisbusyBản thân nó sẽ cách đọc kèo bóng đá cố gắng đọc dữ liệu từ máy chủ; Vì vậyPQConsumeInputphải được gọi trước hoặc trạng thái bận rộn sẽ cách đọc kèo bóng đá bao giờ kết thúc.
Một ứng dụng điển hình sử dụng các chức năng này sẽ có một vòng chính sử dụngselect ()hoặcpoll ()Để chờ tất cả các điều kiện mà nó phải đáp ứng. Một trong các điều kiện sẽ được nhập từ máy chủ, theo điều khoảnselect ()có nghĩa là dữ liệu có thể đọc được trên bộ mô tả tệp được xác định bởiPQSocket. Khi vòng chính phát hiện đầu vào sẵn sàng, nó sẽ gọiPQConsumeInputĐể đọc đầu vào. Sau đó nó có thể gọipqisbusy, tiếp theo làPQGetResultnếupqisbusyTrả về sai (0). Nó cũng có thể gọipqnotifyĐể phát hiệnThông báoTin nhắn (xemPhần 33.8).
Một máy khách sử dụngPQSendQuery/PQGetResultcũng có thể cố gắng hủy một cách đọc kèo bóng đá vẫn đang được máy chủ xử lý; nhìn thấyPhần 33.6. Nhưng bất kể giá trị trả về củaPQCANCEL, Ứng dụng phải tiếp tục với trình tự đọc kết quả thông thường bằng cách sử dụngPQGetResult. Việc hủy bỏ thành công chỉ đơn giản là khiến lệnh chấm dứt sớm hơn so với nếu cách đọc kèo bóng đá.
Bằng cách sử dụng các chức năng được mô tả ở trên, có thể tránh chặn trong khi chờ đợi đầu vào từ máy chủ cơ sở dữ liệu. Tuy nhiên, vẫn có thể ứng dụng sẽ chặn chờ gửi đầu ra đến máy chủ. Điều này tương đối cách đọc kèo bóng đá phổ biến nhưng có thể xảy ra nếu các lệnh SQL hoặc giá trị dữ liệu rất dài được gửi. (Sẽ có nhiều khả năng hơn nếu ứng dụng gửi dữ liệu quaSao chép trongTuy nhiên.) Để ngăn chặn khả năng này và đạt được hoạt động cơ sở dữ liệu hoàn toàn cách đọc kèo bóng đá chặn, các chức năng bổ sung sau đây có thể được sử dụng.
pqsetNonblocking Đặt trạng thái cách đọc kèo bóng đá chặn của kết nối.
int pqsetNonblocking (pgconn *Conn, int arg);
Đặt trạng thái kết nối thành cách đọc kèo bóng đá chặn nếuarglà 1 hoặc chặn nếuarglà 0. Trả về 0 nếu ok, -1 nếu lỗi.
Ở trạng thái cách đọc kèo bóng đá chặn, các cuộc gọi thành công đếnPQSendQuery, pqputline, pqputnbytes, pqputcopydatavàpqendcopysẽ cách đọc kèo bóng đá chặn; Những thay đổi của chúng được lưu trữ trong bộ đệm đầu ra cục bộ cho đến khi chúng được xả. Các cuộc gọi cách đọc kèo bóng đá thành công sẽ trả về một lỗi và phải được thử lại.
Lưu ý rằngPQEXECcách đọc kèo bóng đá tôn trọng chế độ cách đọc kèo bóng đá chặn; Nếu nó được gọi, dù sao nó cũng sẽ hành động theo thời trang.
pqisnonblocking Trả về trạng thái chặn của kết nối cơ sở dữ liệu.
int pqisnonblocking (const pgconn *Conn);
Trả về 1 nếu kết nối được đặt thành chế độ cách đọc kèo bóng đá chặn và 0 nếu chặn.
PQFLUSH cố gắng xóa bất kỳ dữ liệu đầu ra được xếp hàng nào vào máy chủ. Trả về 0 nếu thành công (hoặc nếu hàng đợi gửi trống), -1 nếu nó cách đọc kèo bóng đá thành công vì một số lý do hoặc 1 nếu nó cách đọc kèo bóng đá thể gửi tất cả dữ liệu trong hàng đợi gửi (trường hợp này chỉ có thể xảy ra nếu kết nối cách đọc kèo bóng đá chặn).
int pqflush (pgconn *Conn);
Sau khi gửi bất kỳ lệnh hoặc dữ liệu nào trên kết nối cách đọc kèo bóng đá chặn, hãy gọiPQFLUSH. Nếu nó trả về 1, hãy đợi ổ cắm được đọc hoặc viết. Nếu nó trở nên sẵn sàng viết, hãy gọiPQFLUSHMột lần nữa. Nếu nó trở nên sẵn sàng đọc, hãy gọiPQConsumeInput, sau đó gọiPQFLUSHMột lần nữa. Lặp lại cho đến khiPQFLUSHTrả về 0. (Cần kiểm tra sẵn sàng đọc và thoát đầu vào vớiPQConsumeInput, vì máy chủ có thể chặn cố gắng gửi cho chúng tôi dữ liệu, ví dụ: thông báo thông báo và sẽ cách đọc kèo bóng đá đọc dữ liệu của chúng tôi cho đến khi chúng tôi đọc nó.) Một lầnPQFLUSHTrả về 0, đợi ổ cắm được đọc và sau đó đọc phản hồi như mô tả ở trên.