| Postgresql 8.4.22 Tài liệu | ||||
|---|---|---|---|---|
| prev | Backward nhanh | Chương 30.libpq- C Thư viện | Chuyển tiếp nhanh | NEXT |
Các 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 kèo bóng đá hom 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 kèo bóng đá hom nay của người truy cập được mô tả dưới đây để Nhận nội dung củaPGConn. Tham khảo nội bộPGConnTrường sử dụnglibpq-int.hkhông được đề xuất bởi vì họ có thể thay đổi trong tương lai.
11252_11374PGConnĐối tượng.
PQDB Trả về tên cơ sở dữ liệu của kèo bóng đá hom nay.
char *pqdb (const pgconn *Conn);
PQUSER Trả về tên người dùng của kèo bóng đá hom nay.
char *pquser (const pgconn *Conn);
PQPass Trả về mật khẩu của kèo bóng đá hom nay.
Char *PQPass (const pgconn *Conn);
PQHOST Trả về tên máy chủ máy chủ của kèo bóng đá hom nay.
char *pqhost (const pgconn *Conn);
PQPort Trả về cổng kèo bóng đá hom nay.
char *pqport (const pgconn *Conn);
PQTTY Trả về gỡ lỗittycủa kèo bóng đá hom nay. (Điều này là lỗi thời, vì máy chủ không dài hơn chú ý đếnttyCài đặt, nhưng chức kèo bóng đá hom nay vẫn còn Để tương thích ngược.)
char *pqtty (const pgconn *Conn);
PQOptions
Trả về các tùy chọn dòng lệnh được truyền trong Yêu cầu kèo bóng đá hom nay.
char *pqoptions (const pgconn *Conn);
Các chức năng sau khi trả về dữ liệu kèo bóng đá hom nay có thể thay đổi như Các hoạt động được thực thi trênPGConnĐối tượng.
pqstatus
Trả về trạng thái của kèo bóng đá hom 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 kèo bóng đá hom nay:Connection_okvàConnection_Bad. Một kèo bóng đá hom nay tốt với
cơ sở dữ liệu có trạng tháiConnection_ok. Một nỗ lực kèo bóng đá hom nay thất bại
được báo hiệu bởi trạng tháiConnection_Bad. Thông thường, kèo bóng đá hom 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 kèo bóng đá hom 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àPQConnectPollLiên quan đến người khác
Mã kèo bóng đá hom nay có thể được nhìn thấy.
PQTransactionStatus Trả về kèo bóng đá hom nay chuyển đổi hiện tại của máy chủ.
kèo bóng đá hom 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_inerror16270_16320PQTRANS_UNKNOWNđược báo cáo nếu kèo bóng đá hom 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.
| 16704_16713 |
|
|
PQParameterstatus Xem lên cài đặt tham số hiện tại của máy chủ.
17622_17715
Giá trị tham số nhất định được báo cáo bởi máy chủ
tự động khi khởi động kèo bóng đá hom 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, server_encoding, client_encoding, is_superuser, session_Authorization, Datestyle, IntervalStyle, timezone, integer_datetimesvàStandard_Conforming_Strings. (server_encoding, timezonevàinteger_datetimeskhông được báo cáo bởi phát hành trước 8.0;Standard_Conforming_Stringskhông được báo cáo bằng cách phát hành trước 8.1;IntervalStylekhông được báo cáo bởi các bản phát hành trước 8.4.) Lưu ý rằngserver_version, server_encodingvàinteger_datetimesKhông thể thay đổi sau Khởi nghiệp.
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_encodingDù sao. Ứng dụng là
được khuyến khích sử dụngPQParameterstatuschứ không phảiad hoc19745_19851client_encodingViasetSau khi kèo bóng đá hom nay khởi động sẽ không được
được phản ánh bởipqparameterstatus.) Đối vớiserver_version, Xem thêmPQServerVersion, trả về
thông tin ở dạng số dễ dàng hơn nhiều
So sánh với.
Nếu không có giá trị choStandard_Conforming_Strings20365_20419TẮT, nghĩa là, các dấu gạch chéo ngược được coi là trốn thoát trong chuỗi nghĩa đen. Ngoài ra, sự hiện diện của tham số này có thể được thực hiện như một dấu hiệu cho thấy cú pháp chuỗi thoát (E '...') được chấp nhận.
Mặc dù con trỏ được trả về được khai báoconst, thực tế chỉ vào bộ lưu trữ có thể thay đổi được liên kèo bóng đá hom nay vớiPGConnCấu trúc. Không khôn ngoan khi cho rằng con trỏ sẽ vẫn còn hợp lệ trên các truy vấn.
PQProtocolVersion Truy cập giao thức Frontend/phụ trợ đã sử dụng.
int pqProtocolVersion (const pgconn *Conn);
21385_21804PostgreSQL7.4 hoặc các máy chủ hoặc 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.)
PQServerVersion Trả về một số nguyên đại diện cho phiên bản phụ trợ.
int pqserverversion (const pgconn *Conn);
Ứng dụng có thể sử dụng điều này để xác định phiên bản của Máy chủ cơ sở dữ liệu mà họ được kèo bóng đá hom nay. Số là được hình thành bằng cách chuyển đổi các số chính, phụ và sửa đổi thành các số hai chữ số và nối chúng lại với nhau. Ví dụ, phiên bản 8.1.5 sẽ được trả lại là 80105 và Phiên bản 8.2 sẽ được trả lại dưới dạng 80200 (số 0 hàng đầu là không hiển thị). Số không được trả về nếu kèo bóng đá hom nay xấu.
pqerrormessage Trả 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 kèo bóng đá hom 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ốngpqerrormessagekèo bóng đá hom nay quả có thể là nhiều dòng và sẽ bao gồm một dấu vết
NEWLINE. Người gọi không nên giải phóng kèo bóng đá hom nay quả trực tiếp. Nó
sẽ được giải phóng khi được liên kèo bóng đá hom nayPGConnXử lý được chuyển chopqfinish. Chuỗi kèo bóng đá hom nay quả không được
dự kiến sẽ giữ nguyên các hoạt động trênPGConnCấu trúc.
PQSocketThu thập số lượng mô tả tệp của kèo bóng đá hom 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ủ kèo bóng đá hom 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 kèo bóng đá hom nay hoặc đặt lại.)
int pqsocket (const pgconn *Conn);
PQBackEndPidTrả về quy trìnhid(pid)củ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ần 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ề một 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ộ!
PQConnectionNeedSpasswordTrả về đúng (1) Nếu phương thức xác thực kèo bóng đá hom nay Yêu cầu một mật khẩu, nhưng không có sẵn. Trả về sai (0) nếu không.
26054_26124
Hàm này có thể được áp dụng sau khi kèo bóng đá hom nay thất bại cố gắng quyết định có nên nhắc người dùng cho mật khẩu.
PQConnectionSpasswordTrả về đúng (1) Nếu phương thức xác thực kèo bóng đá hom nay đã sử dụng mật khẩu. Trả về false (0) nếu không.
26663_26732
Hàm này có thể được áp dụng sau khi bị lỗi hoặc kèo bóng đá hom nay thành công cố gắng phát hiện xem máy chủ có yêu cầu một mật khẩu.
PQGetSSLTrả về SSL cấu trúc được sử dụng trong kèo bóng đá hom 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 chính xác cho chức kèo bóng đá hom nay này. Làm điều này cũng sẽ tự động bao gồmSSL.HtừOpenSSL.