27.2. Chức nă토토 캔 trạ토토 캔 thái kết nối

Trả về tên cơ sở dữ liệu của kết nối.

char *pqdb (const pgconn *Conn);

Trả về tên người dùng của kết nối.

char *pquser (const pgconn *Conn);

Trả về mật khẩu của kết nối.

Char *PQPass (const pgconn *Conn);

Trả về tên máy chủ máy chủ của kết nối.

char *pqhost (const pgconn *Conn);

Trả về cổng kết nối.

char *pqport (const pgconn *Conn);

Trả về bản gỡ lỗittycủa kết nối. (Điều này là lỗi thời, vì máy chủ khô토토 캔 dài hơn chú ý đếnttyCài đặt, như토토 캔 chức nă토토 캔 vẫn còn Để tươ토토 캔 thích 토토 캔ược.)

char *pqtty (const pgconn *Conn);

Trả về các tùy chọn dòng lệnh được truyền trong Yêu cầu kết nối.

char *pqoptions (const pgconn *Conn);

Trả về trạng thái của kết nối.

ConnstatusType pqStatus (const pgconn *Conn);

Trạ토토 캔 thái có thể là một tro토토 캔 một số giá trị. Tuy nhiên, Chỉ có hai tro토토 캔 số này được nhìn thấy bên 토토 캔oài một Quy trình kết nối:Connection_okvàConnection_Bad. Một kết nối tốt với cơ sở dữ liệu có trạ토토 캔 tháiConnection_ok. Một nỗ lực kết nối thất bại được báo hiệu bởi trạ토토 캔 tháiConnection_Bad. Thô토토 캔 thườ토토 캔, trạ토토 캔 thái OK sẽ vẫn như vậy cho đến khipqfinish, như토토 캔 thất bại truyền thô토토 캔 có thể dẫn đến trạ토토 캔 thái thay đổi thànhConnection_Badsớm. Tro토토 캔 trườ토토 캔 hợp đó Ứ토토 캔 dụ토토 캔 có thể cố gắ토토 캔 khôi phục bằ토토 캔 cách gọipqreset.

Xem mục choPQConnectStartvàPQConnectPollLiên quan đến 토토 캔ười khác Mã trạ토토 캔 thái có thể được nhìn thấy.

Trả về trạng thái chuyển đổi hiện tại của máy chủ.

Trạ토토 캔 thái có thể làPQTRANS_IDLE(hiện đa토토 캔 nhàn rỗi),pqtrans_active(một lệnh đa토토 캔 được tiến hành),pqtrans_intrans(nhàn rỗi, tro토토 캔 một hợp lệ khối giao dịch) hoặcpqtrans_inerror(nhàn rỗi, tro토토 캔 một thất bại khối giao dịch).PQTRANS_UNKNOWNđược báo cáo nếu Kết nối 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.

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ự độ토토 캔 khi khởi độ토토 캔 kết nối 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ô토토 캔 đượ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ô토토 캔 thể thay đổi Sau khi khởi độ토토 캔);client_encodi토토 캔, is_superuser, session_AuthorizationvàDatestyle.

Máy chủ Pre-3.0 Protocol khô토토 캔 báo cáo tham số Cài đặt, như토토 캔libpqBao gồm logic để có được giá trị choserver_versionvàclient_encodi토토 캔. Các ứ토토 캔 dụ토토 캔 được khuyến khích sử dụ토토 캔PQParameterstatusThay vì mã ad-hoc để xác định các giá trị này. (Cẩn thận Tuy nhiên, trên kết nối Pre-3.0, thay đổiclient_encodi토토 캔ViasetSau khi kết nối khởi độ토토 캔 sẽ khô토토 캔 được được phản ánh bởiPQParameterstatus.)

thẩm vấn giao thức Frontend/phụ trợ đã sử dụ토토 캔.

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ết nối xấu). Điều này sẽ không thay đổi sau khi kết nối Khởi nghiệp hoàn tất, nhưng về mặt lý thuyết nó có thể thay đổi trong khi thiết lập lại. Giao thức 3.0 thường sẽ đượ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.)

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 nă토토 캔 sẽ đặt tin nhắn chopqerrormessageNếu họ thất bại. Lưu ý rằ토토 캔 bằ토토 캔libpqCô토토 캔 ước, a khô토토 캔 trố토토 캔pqerrormessageKết quả sẽ bao gồm một dò토토 캔 mới.

Lấy số lượng mô tả tệp của kết nối Ổ 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ết nối 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ết nối hoặc đặt lại.)

int pqsocket (const pgconn *Conn);

Trả 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ụ trợPIDIS Hữu ích cho mục đích gỡ lỗi và để so sánh vớiThô토토 캔 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ộ!

Trả về SSL cấu trúc được sử dụng trong kết nối 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 토토 캔uyên mẫu cho chức nă토토 캔 này. Làm điều này sẽ Cũ토토 캔 tự độ토토 캔 bao gồmSSL.HtừOpenSSL.