| Postgresql 7.4.30 Tài liệu | ||||
|---|---|---|---|---|
| prev | Backward nhanh | Chương 27.libpq- C Thư viện | Chuyển tiếp nhanh | Tiếp theo |
Những chức năng này có thể được sử dụng để thẩm vấn trạng thái của một Đối tượng tỷ lệ kèo bóng đá tối nay cơ sở dữ liệu hiện có.
Tip: libpqCác lập trình viên ứng dụng nên được Cẩn thận để duy trìPGConnTrừu tượng. Sử dụng các chức tỷ lệ kèo bóng đá tối nay của người truy cập được mô tả dưới đây để Nhận nội dung củaPGConn. Tránh trực tiếp tham chiếu các trường củaPGConnCấu trúc vì chúng là chủ thể để thay đổi trong tương lai. (Bắt đầu trongPostgreSQLPhát hành 6.4, định nghĩa củastructđằng sauPGConnthậm chí không được cung cấp tronglibpq-fe.h. Nếu bạn có mã cũ Truy cậpPGConnTrường trực tiếp, Bạn có thể tiếp tục sử dụng nó bằng cách bao gồmlibpq-int.hquá, nhưng bạn được khuyến khích sửa mã sớm.)
Các chức tỷ lệ kèo bóng đá tối nay sau đây trả về các giá trị tham số được thiết lập tại sự liên quan. Các giá trị này được cố định cho tuổi thọ củaPGConnĐối tượng.
PQDBTrả về tên cơ sở dữ liệu của tỷ lệ kèo bóng đá tối nay.
char *pqdb (const pgconn *Conn);
PQUSERTrả về tên người dùng của tỷ lệ kèo bóng đá tối nay.
char *pquser (const pgconn *Conn);
PQPassTrả về mật khẩu của tỷ lệ kèo bóng đá tối nay.
Char *PQPass (const pgconn *Conn);
PQHOSTTrả về tên máy chủ máy chủ của tỷ lệ kèo bóng đá tối nay.
char *pqhost (const pgconn *Conn);
PQPortTrả về cổng tỷ lệ kèo bóng đá tối nay.
char *pqport (const pgconn *Conn);
PQTTYTrả về bản gỡ lỗittycủa tỷ lệ kèo bóng đá tối nay. (Điều này là lỗi thời, vì máy chủ không dài hơn chú ý đếntty13467_13541
char *pqtty (const pgconn *Conn);
PQOptionsTrả về các tùy chọn dòng lệnh được truyền trong Yêu cầu tỷ lệ kèo bóng đá tối nay.
char *pqoptions (const pgconn *Conn);
Các chức năng sau khi trả về dữ liệu tỷ lệ kèo bóng đá tối nay có thể thay đổi dưới dạng Các hoạt động được thực thi trênPGConnĐối tượng.
pqstatusTrả về trạng thái của tỷ lệ kèo bóng đá tối nay.
ConnstatusType pqStatus (const pgconn *Conn);
Trạng thái có thể là một trong một số giá trị. Tuy nhiên,
Chỉ có hai trong số này được nhìn thấy bên ngoài một
Quy trình tỷ lệ kèo bóng đá tối nay:Connection_okvàConnection_Bad. Một tỷ lệ kèo bóng đá tối nay tốt với
cơ sở dữ liệu có trạng tháiConnection_ok. Một nỗ lực tỷ lệ kèo bóng đá tối nay thất bại
được báo hiệu bởi trạng tháiConnection_Bad. Thông thường, tỷ lệ kèo bóng đá tối nay OK
sẽ vẫn như vậy cho đến khipqfinish, nhưng thất bại truyền thông
có thể dẫn đến tỷ lệ kèo bóng đá tối nay thay đổi thànhConnection_Badsớm. Trong trường hợp đó
Ứng dụng có thể cố gắng khôi phục bằng cách gọipqreset.
Xem mục choPQConnectStartvàPQConnectPoll15344_15409
PQTransactionStatusTrả về tỷ lệ kèo bóng đá tối nay chuyển đổi hiện tại của máy chủ.
tỷ lệ kèo bóng đá tối nay có thể làPQTRANS_IDLE(hiện đang nhàn rỗi),pqtrans_active(một lệnh đang được tiến hành),pqtrans_intrans(nhàn rỗi, trong một hợp lệ khối giao dịch) hoặcpqtrans_inerror(nhàn rỗi, trong một thất bại khối giao dịch).PQTRANS_UNKNOWNđược báo cáo nếu tỷ lệ kèo bóng đá tối nay là xấu.pqtrans_activechỉ được báo cáo khi truy vấn đã được gửi đến máy chủ và chưa hoàn thành.
| THẬN TRỌNG |
|
|
PQParameterstatusXem lên cài đặt tham số hiện tại của máy chủ.
const char *pqparameterstatus (const pgconn *Conn, const char *paramname);
Giá trị tham số nhất định được báo cáo bởi máy chủ
tự động khi khởi động tỷ lệ kèo bóng đá tối nay hoặc bất cứ khi nào
giá trị thay đổi.PQParameterstatuscó thể được sử dụng để
thẩm vấn các cài đặt này. Nó trả về giá trị hiện tại của
tham số nếu được biết hoặcnullNếu
tham số không được biết.
Các tham số được báo cáo là bản phát hành hiện tại bao gồmserver_version(không thể thay đổi Sau khi khởi động);client_encoding, is_superuser, session_AuthorizationvàDatestyle.
Máy chủ Pre-3.0 Protocol không báo cáo tham số
Cài đặt, nhưnglibpqBao gồm logic để có được giá trị choserver_versionvàclient_encoding. Các ứng dụng được khuyến khích
sử dụngPQParameterstatusThay vì mã ad-hoc để xác định các giá trị này. (Cẩn thận
Tuy nhiên, trên tỷ lệ kèo bóng đá tối nay Pre-3.0, thay đổiclient_encodingViasetSau khi tỷ lệ kèo bóng đá tối nay khởi động sẽ không được
được phản ánh bởiPQParameterstatus.)
PQProtocolVersion18985_19049
int pqProtocolVersion (const pgconn *Conn);
19145_19551PostgreSQL7.4 hoặc các máy chủ sau đó; Máy chủ trước 7.4 chỉ hỗ trợ giao thức 2.0. (Giao thức 1.0 là lỗi thời và không được hỗ trợ bởilibpq.)
pqerrormessageTrả về lỗi thông báo gần đây nhất được tạo bởi một hoạt động trên sự liên quan.
char * pqerrormessage (const pgconn * Conn);
Gần như tất cảlibpqCác chức tỷ lệ kèo bóng đá tối nay sẽ đặt tin nhắn chopqerrormessageNếu họ thất bại. Lưu ý rằng bằnglibpqCông ước, a
không trống20432_20448tỷ lệ kèo bóng đá tối nay quả sẽ bao gồm một dòng mới.
PQSocketLấy số lượng mô tả tệp của tỷ lệ kèo bóng đá tối nay Ổ cắm đến máy chủ. Một mô tả hợp lệ sẽ lớn hơn hơn hoặc bằng 0; kết quả của -1 chỉ ra rằng không có máy chủ tỷ lệ kèo bóng đá tối nay hiện đang mở. (Điều này sẽ không thay đổi trong Hoạt động bình thường, nhưng có thể thay đổi trong quá trình thiết lập tỷ lệ kèo bóng đá tối nay hoặc đặt lại.)
int pqsocket (const pgconn *Conn);
PQBackEndPidTrả về quy trìnhid21258_21266của quy trình máy chủ phụ trợ xử lý việc này sự liên quan.
int pqbackendPid (const pgconn *Conn);
phụ trợPIDIS Hữu ích cho mục đích gỡ lỗi và để so sánh vớiThông báoTin nhắn (bao gồmPIDcủa thông báo quá trình phụ trợ). Lưu ý rằngPIDthuộc về quá trình thực hiện trên Máy chủ máy chủ cơ sở dữ liệu, không phải máy chủ cục bộ!
PQGetSSLTrả về SSL cấu trúc được sử dụng trong tỷ lệ kèo bóng đá tối nay hoặc null nếu SSL không ở trong sử dụng.
SSL *PQGetSSL (const pgconn *Conn);
Cấu trúc này có thể được sử dụng để xác minh các mức mã hóa, Kiểm tra chứng chỉ máy chủ, và nhiều hơn nữa. Tham khảoOpenSSLTài liệu cho thông tin về cấu trúc này.
Bạn phải xác địnhuse_sslTheo thứ tự Để có được nguyên mẫu cho chức tỷ lệ kèo bóng đá tối nay này. Làm điều này sẽ Cũng tự động bao gồmSSL.HtừOpenSSL.