Phiên bản được hỗ trợ:hiện tại(17) /16 / 15 / 14 / 13
Phiên bản phát triển:18 / Devel
Phiên bản không được hỗ trợ:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4
Tài liệu này dành cho phiên bản không được hỗ trợ của PostgreSQL.
Bạn có thể muốn xem cùng một trang chohiện tạiPhiên bản hoặc một trong các phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

31.2. Chức năng trạng thái tỷ lệ kèo bóng đá trực tuyến hôm nay

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 tỷ lệ kèo bóng đá trực tuyến hôm nay cơ sở dữ liệu hiện có.

Tip: libpqLập trình viên ứng dụng nên cẩn thận để duy trìPGConnTrừu tượng. Sử dụng Các chức tỷ lệ kèo bóng đá trực tuyến hôm nay của người phụ kiện được mô tả bên dưới để có được nội dung củaPGConn. Tham khảo nội bộPGConnTrường sử dụnglibpq-int.hkhông được khuyến nghị vì chúng có thể thay đổi trong tương lai.

Các chức tỷ lệ kèo bóng đá trực tuyến hôm 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.

PQDB

Trả về tên cơ sở dữ liệu của tỷ lệ kèo bóng đá trực tuyến hôm nay.

char *pqdb (const pgconn *Conn);
PQUSER

Trả về tên người dùng của tỷ lệ kèo bóng đá trực tuyến hôm nay.

char *pquser (const pgconn *Conn);
PQPass

Trả về mật khẩu của tỷ lệ kèo bóng đá trực tuyến hôm nay.

Char *PQPass (const pgconn *Conn);
PQHOST

Trả về tên máy chủ máy chủ của tỷ lệ kèo bóng đá trực tuyến hôm nay.

char *pqhost (const pgconn *Conn);
PQPort

Trả về cổng tỷ lệ kèo bóng đá trực tuyến hôm nay.

char *pqport (const pgconn *Conn);
PQTTY

Trả về bản gỡ lỗittycủa tỷ lệ kèo bóng đá trực tuyến hôm 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 tỷ lệ kèo bóng đá trực tuyến hôm 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 tỷ lệ kèo bóng đá trực tuyến hôm nay.

char *pqoptions (const pgconn *Conn);

Các chức tỷ lệ kèo bóng đá trực tuyến hôm nay sau khi trả về dữ liệu trạng thái 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 tỷ lệ kèo bóng đá trực tuyến hôm 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 đá trực tuyến hôm nay:Connection_okConnection_Bad. Một tỷ lệ kèo bóng đá trực tuyến hôm 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 đá trực tuyến hôm 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 đá trực tuyến hôm 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 đá trực tuyến hôm 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 choPQConnectStartParams, PQConnectStartPQConnectPollLiên quan đến khác Mã tỷ lệ kèo bóng đá trực tuyến hôm nay có thể được nhìn thấy.

PQTransactionStatus

Trả về tỷ lệ kèo bóng đá trực tuyến hôm nay chuyển đổi hiện tại của máy chủ.



        

tỷ lệ kèo bóng đá trực tuyến hôm 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 đá trực tuyến hôm 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

PQTransactionStatussẽ cho tỷ lệ kèo bóng đá trực tuyến hôm nay quả không chính xác khi sử dụngPostgreSQL7.3 Máy chủ có tham sốAutoCommitĐặt thành TẮT. Tính tỷ lệ kèo bóng đá trực tuyến hôm nay AutoCommit phía máy chủ có không bị từ chối và không tồn tại trong máy chủ sau này phiên bản.

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 tỷ lệ kèo bóng đá trực tuyến hôm 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.

tham số được báo cáo kể từ bản phát hành hiện tại bao gồmserver_version, server_encoding, client_encoding, application_name, is_superuser, session_Authorization, Datestyle, IntervalStyle, timezone, integer_datetimesStandard_conforming_strings. (server_encoding, timezoneinteger_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;application_namewas không được báo cáo bởi các bản phát hành trước 9.0.) Lưu ý rằngserver_version, server_encodinginteger_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_versionclient_encodingDù sao. Ứng dụng là được khuyến khích sử dụngPQParameterstatuschứ không phảiad hocMã để xác định các giá trị này. (Tuy nhiên, hãy cẩn thận với tỷ lệ kèo bóng đá trực tuyến hôm nay Pre-3.0, thay đổiclient_encodingViasetSau khi tỷ lệ kèo bóng đá trực tuyến hôm nay 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Ắ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ế nó chỉ vào bộ lưu trữ có thể thay đổi được liên tỷ lệ kèo bóng đá trực tuyến hôm 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);

Ứ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 (tỷ lệ kèo bóng đá trực tuyến hôm nay xấu). Điều này sẽ không thay đổi sau khi tỷ lệ kèo bóng đá trực tuyến hôm nay 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 tỷ lệ kèo bóng đá trực tuyến hôm nay. 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 tỷ lệ kèo bóng đá trực tuyến hôm 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 tỷ lệ kèo bóng đá trực tuyến hôm nay xấu.

pqerrormessage

Trả về thông báo lỗi được tạo gần đây nhất bởi một Hoạt động trên tỷ lệ kèo bóng đá trực tuyến hôm nay.

char *pqerrormessage (const pgconn *Conn);

Gần như tất cảlibpqCác chức tỷ lệ kèo bóng đá trực tuyến hôm 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ốngpqerrormessagetỷ lệ kèo bóng đá trực tuyến hôm 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 tỷ lệ kèo bóng đá trực tuyến hôm nay quả trực tiếp. Nó sẽ được giải phóng khi được liên tỷ lệ kèo bóng đá trực tuyến hôm nayPGConnXử lý được chuyển chopqfinish. Chuỗi tỷ lệ kèo bóng đá trực tuyến hôm nay quả không được dự kiến ​​sẽ giữ nguyên các hoạt động trênPGConnCấu trúc.

PQSocket

Lấy số lượng mô tả tệp của tỷ lệ kèo bóng đá trực tuyến hôm 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 đá trực tuyến hôm 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 đá trực tuyến hôm nay hoặc đặt lại.)

int pqsocket (const pgconn *Conn);
PQBackEndPid

Trả về quy trìnhid(pid) của quy trình máy chủ phụ trợ xử lý tỷ lệ kèo bóng đá trực tuyến hôm nay này.

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ề 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ộ!

PQConnectionNeedSpassword

Trả về đúng (1) Nếu phương thức xác thực tỷ lệ kèo bóng đá trực tuyến hôm 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.

25161_25215

Hàm này có thể được áp dụng sau khi tỷ lệ kèo bóng đá trực tuyến hôm 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.

PQConnectionSpassword

Trả về đúng (1) Nếu phương thức xác thực tỷ lệ kèo bóng đá trực tuyến hôm nay đã sử dụng mật khẩu. Trả về false (0) nếu không.

25711_25764

Hàm này có thể được áp dụng sau khi bị lỗi hoặc không thành công tỷ lệ kèo bóng đá trực tuyến hôm 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.

PQGetSSL

Trả về cấu trúc SSL được sử dụng trong tỷ lệ kèo bóng đá trực tuyến hôm nay hoặc null nếu ssl không được 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 tỷ lệ kèo bóng đá trực tuyến hôm nay này. Làm như vậy cũng sẽ tự động bao gồmssl.htừOpenSSL.