| Postgresql 8.3.23 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 đá việt nam 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 năng 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ụng11117_11130không được đề xuất bởi vì họ có thể thay đổi trong tương lai.
Các chức năng 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.
PQDB Trả về tên cơ sở dữ liệu của kèo bóng đá việt nam.
char *pqdb (const pgconn *Conn);
PQUSER Trả về tên người dùng của kèo bóng đá việt nam.
char *pquser (const pgconn *Conn);
PQPass Trả về mật khẩu của kèo bóng đá việt nam.
Char *PQPass (const pgconn *Conn);
PQHOST Trả về tên máy chủ máy chủ của kèo bóng đá việt nam.
char *pqhost (const pgconn *Conn);
PQPort Trả về cổng kèo bóng đá việt nam.
char *pqport (const pgconn *Conn);
pqtty Trả về gỡ lỗi12949_12954của kèo bóng đá việt nam. (Đ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 năng 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 đá việt nam.
char *pqoptions (const pgconn *Conn);
Các chức năng sau khi trả về dữ liệu kèo bóng đá việt nam 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 đá việt nam.
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 đá việt nam:Connection_okvàConnection_Bad. Một kèo bóng đá việt nam tốt với
cơ sở dữ liệu có trạng tháiConnection_ok. Một nỗ lực kèo bóng đá việt nam thất bại
được báo hiệu bởi trạng tháiConnection_Bad. Thông thường, kèo bóng đá việt nam 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 đá việt nam 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 đá việt nam có thể được nhìn thấy.
PQTransactionStatus
Trả về kèo bóng đá việt nam chuyển đổi hiện tại của máy chủ.
kèo bóng đá việt nam 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 kèo bóng đá việt nam 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 |
|
|
PQParameterstatus Xem 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 kèo bóng đá việt nam 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, 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.) 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ụngPQParameterstatusthay vìad hocMã để xác định các giá trị này.
(Tuy nhiên, hãy cẩn thận với kèo bóng đá việt nam Pre-3.0, thay đổiclient_encodingViasetSau khi kèo bóng đá việt nam khởi động sẽ không
đượ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_Stringsđược báo cáo, Các ứng dụng có thể giả sử đó làTẮT19708_19898E '...') được chấp nhận.
Mặc dù con trỏ được trả lại đượ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 đá việt nam 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);
Ứng dụng có thể muốn sử dụng điều này để xác định xem liệu Một số tính năng được hỗ trợ. Hiện tại, có thể Giá trị là 2 (giao thức 2.0), giao thức 3 (3.0) hoặc không (kèo bóng đá việt nam xấu). Điều này sẽ không thay đổi sau khi kèo bóng đá việt nam Khởi nghiệp hoàn tất, nhưng về mặt lý thuyết nó có thể thay đổi Trong quá trình thiết lập lại kèo bóng đá việt nam. Giao thức 3.0 sẽ bình thường được sử dụng khi giao tiếp vớiPostgreSQL7.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.)
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 đá việt nam. 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 đá việt nam 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.
22295_22356
Gần như tất cảlibpqCác chức năng sẽ đặt tin nhắn chopqerrormessageNếu họ thất bại. Lưu ý rằng bằng22579_22586Công ước, a
không trốngpqerrormessage22667_22819PGConnXử lý là
được truyền chopqfinish. Các
Chuỗi kèo bóng đá việt nam quả không nên được dự kiến sẽ giữ nguyên
trên các hoạt động trênPGConnCấu trúc.
PQSocketLấy số lượng mô tả tệp của kèo bóng đá việt nam Ổ 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 đá việt nam 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 đá việt nam hoặc đặt lại.)
int pqsocket (const pgconn *Conn);
PQBackendPid23778_23800id(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ụ 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ộ!
PQConnectionNeedSpasswordTrả về đúng (1) Nếu phương thức xác thực kèo bóng đá việt nam 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.
24830_24900
Chức năng này có thể được áp dụng sau khi kèo bóng đá việt nam 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 đá việt nam đã sử dụng mật khẩu do người gọi cung cấp. Trả về sai (0) nếu không.
25375_25444
25461_25626.pgassTệp) không được xem xét do người gọi cung cấp.
PQGetSSLTrả về SSL cấu trúc được sử dụng trong kèo bóng đá việt nam 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 năng này. Làm điều này cũng sẽ tự động bao gồmssl.htừOpenSSL.