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

34.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 đố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 hàm accessor đượ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 hàm sau trả về giá trị tham số được thiết lập khi tỷ lệ kèo bóng đá trực tuyến hôm nay. Các giá trị này được cố định cho tuổi thọ của tỷ lệ kèo bóng đá trực tuyến hôm nay. Nếu chuỗi tỷ lệ kèo bóng đá trực tuyến hôm nay đa host được sử dụng, các giá trị củaPQHOST, PQPortPQPassCó thể thay đổi nếu tỷ lệ kèo bóng đá trực tuyến hôm nay mới được thiết lập bằng cùng mộtPGConnĐối tượng. Các giá trị khác được cố định cho vòng đời 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);

PQPassSẽ trả về mật khẩu được chỉ định trong các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay hoặc nếu không có và mật khẩu được lấy từPostgresql: Tài, nó sẽ trả lại điều đó. Trong trường hợp sau, nếu nhiều máy chủ được chỉ định trong các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay, thì không thể dựa vào kết quả củaPQPassCho đến khi tỷ lệ kèo bóng đá trực tuyến hôm nay được thiết lập. Trạng thái của tỷ lệ kèo bóng đá trực tuyến hôm nay có thể được kiểm tra bằng hàmpqstatus.

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 đang hoạt động. Đây có thể là tên máy chủ, địa chỉ IP hoặc đường dẫn thư mục nếu tỷ lệ kèo bóng đá trực tuyến hôm nay thông qua ổ cắm UNIX. (Trường hợp đường dẫn có thể được phân biệt vì nó sẽ luôn là một con đường tuyệt đối, bắt đầu bằng/.)

char *pqhost (const pgconn *Conn);

Nếu các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay được chỉ định cảhosthostaddr, sau đóPQHOSTsẽ trả vềmáy chủThông tin. Nếu chỉhostaddrđã được chỉ định, sau đó được trả về. Nếu nhiều máy chủ được chỉ định trong các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay,PQHOSTTrả về máy chủ thực sự được tỷ lệ kèo bóng đá trực tuyến hôm nay với.

PQHOSTreturnnullNếuConnĐối số lànull. Mặt khác, nếu có lỗi tạo ra thông tin máy chủ (có lẽ nếu tỷ lệ kèo bóng đá trực tuyến hôm nay chưa được thiết lập đầy đủ hoặc có lỗi), nó sẽ trả về một chuỗi trống.

Nếu nhiều máy chủ được chỉ định trong các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay, không thể dựa vào kết quả củaPQHOSTCho đến khi tỷ lệ kèo bóng đá trực tuyến hôm nay được thiết lập. Trạng thái của tỷ lệ kèo bóng đá trực tuyến hôm nay có thể được kiểm tra bằng hàmpqstatus.

PQHOSTADDR

Trả về địa chỉ IP máy chủ của tỷ lệ kèo bóng đá trực tuyến hôm nay hoạt động. Đây có thể là địa chỉ mà tên máy chủ được giải quyết hoặc địa chỉ IP được cung cấp thông quahostaddrtham số.

char *pqhostaddr (const pgconn *Conn);

PQHOSTADDRreturnnullNếuConnĐối số lànull. Mặt khác, nếu có lỗi tạo ra thông tin máy chủ (có lẽ nếu tỷ lệ kèo bóng đá trực tuyến hôm nay chưa được thiết lập đầy đủ hoặc có lỗi), nó sẽ trả về một chuỗi trống.

PQPort

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

char *pqport (const pgconn *Conn);

Nếu nhiều cổng được chỉ định trong các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay,PQPortTrả về cổng thực sự được tỷ lệ kèo bóng đá trực tuyến hôm nay với.

PQPortreturnnullNếuConnĐối số lànull. Mặt khác, nếu có lỗi tạo ra thông tin cổng (có lẽ nếu tỷ lệ kèo bóng đá trực tuyến hôm nay chưa được thiết lập đầy đủ hoặc có lỗi), nó sẽ trả về một chuỗi trống.

Nếu nhiều cổng được chỉ định trong các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay, không thể dựa vào kết quả củaPQPortCho đến khi tỷ lệ kèo bóng đá trực tuyến hôm nay được thiết lập. Trạng thái của tỷ lệ kèo bóng đá trực tuyến hôm nay có thể được kiểm tra bằng hàmpqstatus.

pqtty

Chức tỷ lệ kèo bóng đá trực tuyến hôm nay này không còn làm gì cả, nhưng nó vẫn dành cho khả tỷ lệ kèo bóng đá trực tuyến hôm nay tương thích ngược. Hàm luôn trả về một chuỗi trống hoặcnullNếuConnĐối số lànull.

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 khi 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 quy trình tỷ lệ kèo bóng đá trực tuyến hôm nay không đồng bộ: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 lỗ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 các mã tỷ lệ kèo bóng đá trực tuyến hôm nay khác có thể được trả về.

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 khối giao dịch hợp lệ) hoặcpqtrans_inerror(nhàn rỗi, trong một khối giao dịch thất bại).pqtrans_unknownđược báo cáo nếu tỷ lệ kèo bóng đá trực tuyến hôm nay 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.

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);

Các giá trị tham số nhất định được báo cáo 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ị của chúng 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 một 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, application_name, default_transaction_read_only, in_hot_standby, is_superuser, session_Authorization, Datestyle, IntervalStyle, timezone, Integer_DatetimesStandard_Conforming_Strings. (server_encoding, timezoneInteger_Datetimeskhông được báo cáo bởi các bản phát hành trước 8.0;Standard_Conforming_Stringskhông được báo cáo bởi các bản 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_namekhông được báo cáo bởi các bản phát hành trước 9.0;default_transaction_read_onlyin_hot_standbyKhông được báo cáo bởi các bản phát hành trước 14.) Lưu ý rằngserver_version, server_encodinginteger_datetimesKhông thể thay đổi sau khi khởi động.

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 các chuỗi chữ. Ngoài ra, sự hiện diện của tham số này có thể được coi là 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 hiệu lực trên các truy vấn.

PQProtocolVersion

thẩm vấn giao thức Frontend/phụ trợ đang được sử dụng.

int pqProtocolVersion (const pgconn *Conn);

Các ứng dụng có thể muốn sử dụng chức năng này để xác định xem một số tính năng nhất định có được hỗ trợ hay không. Hiện tại, các giá trị có thể là 3 (giao thức 3.0) hoặc không (tỷ lệ kèo bóng đá trực tuyến hôm nay xấu). Phiên bản giao thức sẽ không thay đổi sau khi tỷ lệ kèo bóng đá trực tuyến hôm nay khởi động hoàn tất, nhưng về mặt lý thuyết, nó có thể thay đổi trong quá trình đặt lại tỷ lệ kèo bóng đá trực tuyến hôm nay. Giao thức 3.0 được hỗ trợ bởiPostgreSQLPhiên bản máy chủ 7.4 trở lên.

PQServerVersion

Trả về một số nguyên đại diện cho phiên bản máy chủ.

int pqserverversion (const pgconn *Conn);

Các ứng dụng có thể sử dụng chức năng này để xác định phiên bản của máy chủ cơ sở dữ liệu mà chúng được tỷ lệ kèo bóng đá trực tuyến hôm nay. Kết quả được hình thành bằng cách nhân số phiên bản chính của máy chủ với 10000 và thêm số phiên bản nhỏ. Ví dụ: Phiên bản 10.1 sẽ được trả về dưới dạng 100001 và phiên bản 11.0 sẽ được trả lại là 110000. Không được trả về nếu tỷ lệ kèo bóng đá trực tuyến hôm nay xấu.

Trước phiên bản chính 10,PostgreSQLđã sử dụng số phiên bản ba phần trong đó hai phần đầu tiên cùng nhau đại diện cho phiên bản chính. Cho các phiên bản đó,PQServerVersionSử dụng hai chữ số cho mỗi phần; Ví dụ: Phiên bản 9.1.5 sẽ được trả lại là 90105 và phiên bản 9.2.0 sẽ được trả về là 90200.

Do đó, với mục đích xác định khả năng tương thích tính năng, các ứng dụng nên chia tỷ lệ kèo bóng đá trực tuyến hôm nay quả củaPQServerVersionbởi 100 không 10000 để xác định số phiên bản chính logic. Trong tất cả các chuỗi phát hành, chỉ có hai chữ số cuối cùng khác nhau giữa các bản phát hành nhỏ (bản phát hành sửa lỗi).

pqerrormessage

Trả về thông báo lỗi được tạo gần đây nhất bởi một thao tác 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ằnglibpqquy ước, một người không trốngpqerrormessagetỷ lệ kèo bóng đá trực tuyến hôm nay quả có thể bao gồm nhiều dòng và sẽ bao gồm một dòng mới. 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 nên được dự kiến ​​sẽ giữ nguyên trong các hoạt động trênPGConnCấu trúc.

PQSocket

Lấy số lượng mô tả tệp của ổ cắm tỷ lệ kèo bóng đá trực tuyến hôm nay vào máy chủ. Một mô tả hợp lệ sẽ lớn hơn hoặc bằng 0; Kết quả của -1 chỉ ra rằng không có tỷ lệ kèo bóng đá trực tuyến hôm nay máy chủ hiện đang mở. (Điều này sẽ không thay đổi trong quá trình hoạt động bình thường, nhưng có thể thay đổi trong quá trình thiết lập hoặc đặt lại tỷ lệ kèo bóng đá trực tuyến hôm nay.)

int pqsocket (const pgconn *Conn);
PQBackendPid

Trả về quy trìnhid(pid)của quá trình 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ụ trợPIDrất 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 quy trình phụ trợ thông báo). Lưu ý rằngPIDthuộc về quá trình thực thi 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 khẩu, nhưng không có sẵn. Trả về false (0) nếu không.

int pqconnectionNeedSpassword (const pgconn *Conn);

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ó nhắc người dùng về mật khẩu không.

PQConnectionSpassword

Trả về true (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.

30684_30737

Hàm này có thể được áp dụng sau khi cố gắng tỷ lệ kèo bóng đá trực tuyến hôm nay thành công hoặc không thành công để phát hiện xem máy chủ có yêu cầu mật khẩu hay không.

Các chức năng sau trả về thông tin liên quan đến SSL. Thông tin này thường không thay đổi sau khi tỷ lệ kèo bóng đá trực tuyến hôm nay được thiết lập.

PQSSlinuse

Trả về true (1) Nếu tỷ lệ kèo bóng đá trực tuyến hôm nay sử dụng SSL, false (0) nếu không.

int pqsslinuse (const pgconn *Conn);
PQSSlattribution

Trả về thông tin liên quan đến SSL về tỷ lệ kèo bóng đá trực tuyến hôm nay.

31783_31862

Danh sách các thuộc tính có sẵn khác nhau tùy thuộc vào thư viện SSL đang được sử dụng và loại tỷ lệ kèo bóng đá trực tuyến hôm nay. Nếu một thuộc tính không khả dụng, hãy trả về null.

Các thuộc tính sau đây thường có sẵn:

Thư viện

Tên của việc triển khai SSL đang sử dụng. (Hiện tại, chỉ"OpenSSL"được triển khai)

Giao thức

Phiên bản SSL/TLS đang được sử dụng. Các giá trị chung là"TLSV1", "TLSV1.1""TLSV1.2", nhưng việc triển khai có thể trả về các chuỗi khác nếu một số giao thức khác được sử dụng.

key_bits

Số bit khóa được sử dụng bởi thuật toán mã hóa.

mật mã

Một tên ngắn của ciphersuite được sử dụng, ví dụ:"DHE-RSA-DES-CBC3-SHA". Các tên được cụ thể cho mỗi triển khai SSL.

Nén

Trả về "BẬT" Nếu nén SSL được sử dụng, nếu không nó sẽ trả về "TẮT".

PQSSlattributenames

Trả về một mảng tên thuộc tính SSL có sẵn. Mảng bị chấm dứt bởi một con trỏ null.

const char * const * pqsslattributenames (const pgconn * Conn);
PQSSLSTRuct

34181_34267

34300_34367

Cấu trúc có sẵn phụ thuộc vào việc thực hiện SSL đang sử dụng. VìOpenSSL, có một cấu trúc, có sẵn dưới tên "OpenSSL" và nó trả về một con trỏ choOpenSSL SSLCấu trúc. Để sử dụng chức tỷ lệ kèo bóng đá trực tuyến hôm nay này, mã dọc theo các dòng sau có thể được sử dụng:

#include <libpq-fe.h
#include <openSSL/ssl.h

...

    SSl *SSl;

    dbconn = pqconnectdb (...);
    ...

    ssl = pqsslstruct (dbconn, "openSSL");
    Nếu (SSL)

        / * Sử dụng các chức tỷ lệ kèo bóng đá trực tuyến hôm nay OpenSSL để truy cập SSL *//

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à hơn thế nữa. Tham khảoOpenSSLTài liệu để biết thông tin về cấu trúc này.

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.

VOID *PQGETSSL (const pgconn *Conn);

Hàm này tương đương vớiPQSSLStruct (Conn, "OpenSSL"). Nó không nên được sử dụng trong các ứng dụng mới, vì cấu trúc được trả về dành riêng choOpenSSLvà sẽ không khả dụng nếu người khácSSLThực hiện được sử dụng. Để kiểm tra xem tỷ lệ kèo bóng đá trực tuyến hôm nay có sử dụng SSL không, hãy gọiPQSSlinuseThay vào đó, và để biết thêm chi tiết về tỷ lệ kèo bóng đá trực tuyến hôm nay, sử dụngPQSSlattribution.

Gửi hiệu chỉnh

Nếu bạn thấy bất cứ điều gì trong tài liệu không chính xác, không khớp Kinh nghiệm của bạn với tính tỷ lệ kèo bóng đá trực tuyến hôm nay cụ thể hoặc yêu cầu làm rõ thêm, Vui lòng sử dụngMẫu nàyĐể báo cáo vấn đề tài liệu.