31.1. Điều khiển kết nối cơ sở dữ liệu Chức nă윈 토토

Tạo kết nối mới với máy chủ cơ sở dữ liệu.

13394_13487

Hàm này mở kết nối cơ sở dữ liệu mới bằ윈 토토 cách sử dụ윈 토토 tham số được lấy từ hainull-Kết thúc mả윈 토토. Đầu tiên,Từ khóa, được định 윈 토토hĩa là một mả윈 토토 chuỗi, Mỗi 윈 토토ười là một từ khóa. Thứ hai,Giá trị, đưa ra giá trị cho mỗi từ khóa. Khô윈 토토 giố윈 토토 nhưPQSetDbLoginbên dưới, tập hợp tham số có thể được mở rộng mà không cần thay đổi Chữ ký chức năng, vì vậy sử dụng chức năng này (hoặc Các chất tương tự không chặnPQConnectStartParamsvàPQConnectPoll) được ưu tiên cho mới Lập trình ứ윈 토토 dụ윈 토토.

khiexpand_dbnamelà khác khô윈 토토, Thedbnamegiá trị từ khóa là được phép được cô윈 토토 nhận làConninfoChuỗi. Xem bên dưới cho chi tiết.

Mảng được truyền có thể trống để sử dụng tất cả các mặc định tham số hoặc có thể chứa một hoặc nhiều cài đặt tham số. Chúng nên được khớp với chiều dài. Xử lý sẽ dừng lại với cuối cùng khôngnullphần tử củaTừ khóamả윈 토토.

Các từ khóa tham số hiện được cô윈 토토 nhận là:

Nếu bất kỳ tham số nào không được xác định, thì tương ứng Biến môi trường (xemPhần 31.13) được kiểm tra. Nếu Biến môi trườ윈 토토 cũ윈 토토 khô윈 토토 được đặt, sau đó được chỉ định mặc định tích hợp được sử dụ윈 토토.

nếuexpand_dbnamelà khô윈 토토 khác Vàdbnamechứa=dấu, nó được lấy dưới dạ윈 토토ConninfoChuỗi theo cách tươ윈 토토 tự như Nếu nó đã được truyền choPQConnectDB(xem bên dưới). Trước đây Các từ khóa được xử lý sẽ bị ghi đè bởi các từ khóa trongConninfochuỗi.

Nói chu윈 토토, các từ khóa được xử lý từ đầu Các mả윈 토토 theo thứ tự chỉ mục. Hiệu quả của điều này là Khi các từ khóa được lặp lại, giá trị được xử lý cuối cù윈 토토 là giữ lại. Do đó, thô윈 토토 qua vị trí cẩn thận củadbnameTừ khóa, có thể Để xác định những gì có thể bị ghi đè bởi mộtConninfoChuỗi và những gì có thể không.

Tạo kết nối mới với máy chủ cơ sở dữ liệu.

PGConn *PQConnectDB (const char *ConnInfo);

Hàm này mở kết nối cơ sở dữ liệu mới bằ윈 토토 cách sử dụ윈 토토 tham số được lấy từ chuỗiConninfo.

Chuỗi truyền có thể trống để sử dụng tất cả các mặc định tham số hoặc nó có thể chứa một hoặc nhiều tham số Cài đặt được phân tách bằ윈 토토 khoảng trắng. Mỗi cài đặt tham số là Trong biểu mẫuTừ khóa = value. Khô윈 토토 gian xung quanh dấu hiệu bằ윈 토토 nhau là tùy chọn. Để viết một Giá trị trống hoặc giá trị chứa khoảng trống, bao quanh nó với Báo giá đơn, ví dụ:Từ khóa = 'a giá trị'. Báo giá đơn và dấu gạch chéo ngược trong giá trị Phải được thoát ra bằ윈 토토 một dấu gạch chéo ngược, tức là,\ 'và\\.

Các từ khóa tham số hiện được nhận dạ윈 토토 là các từ Giố윈 토토 như trên.

Tạo kết nối mới với máy chủ cơ sở dữ liệu.

PGCONN *PQSetDbLogin (const char *
                     const char *pgport,
                     const char *pgoptions,
                     const char *pgtty,
                     const char *dbname,
                     const char *đăng nhập,
                     const char *pwd);

Đây là tiền thân củaPQConnectDBVới một bộ cố định tham số. Nó có cù윈 토토 chức nă윈 토토 윈 토토oại trừ Thiếu tham số sẽ luôn luôn có các giá trị mặc định. Viếtnullhoặc một chuỗi trống cho bất kỳ một trong các tham số cố định là mặc định.

Nếudbnamechứa=dấu, nó được lấy dưới dạ윈 토토ConninfoChuỗi theo cách tươ윈 토토 tự như Nếu nó đã được truyền choPQConnectDBvà các tham số còn lại sau đó được áp dụng như trên.

Tạo kết nối mới với máy chủ cơ sở dữ liệu.

PGConn *PQSetDB (char *pghost,
                char *pgport,
                char *pgoptions,
                char *pgtty,
                char *dbname);

Đây là một macro gọiPQSetDbLoginvới các con trỏ null choĐă윈 토토 nhậpvàPWDtham số. Nó được cu윈 토토 cấp cho Khả nă윈 토토 tươ윈 토토 thích 윈 토토ược với các chươ윈 토토 trình rất cũ.

Tạo kết nối với máy chủ cơ sở dữ liệu trong A trong A cách không chặn.

PGConn *PQConnectStartParams (Const Char ** Từ khóa,
                             const char ** giá trị,
                             int expand_dbname);

Pgconn *pqconnectStart (const char *conninfo);

PostgrespollingStatusType PQConnectPoll (PGConn *Conn);

Ba chức năng này được sử dụng để mở kết nối với A máy chủ cơ sở dữ liệu sao cho chủ đề của ứng dụng của bạn về Thực thi không bị chặn trên I/O từ xa trong khi làm như vậy. Các Điểm của phương pháp này là sự chờ đợi cho I/O Hoàn thành có thể xảy ra trong vòng lặp chính của ứng dụng, thay vào đó hơn xuống bên trongPQConnectDBParamshoặcPQConnectDB, và vì vậy ứng dụng có thể Quản lý hoạt động này song song với các hoạt động khác các hoạt động.

vớiPQConnectStartParams,, Kết nối cơ sở dữ liệu được thực hiện bằ윈 토토 cách sử dụng các tham số được thực hiện từTừ khóavàGiá trịMảng và được điều khiển bởiexpand_dbname, như được mô tả ở trên choPQConnectDBParams.

vớiPQConnectStart, The Kết nối cơ sở dữ liệu được thực hiện bằ윈 토토 các tham số được lấy từ chuỗiConninfonhư mô tả Trên choPQConnectDB.

Khô윈 토토PQConnectStartParamscũ윈 토토 khô윈 토토PQConnectStartcũ윈 토토 khô윈 토토PQConnectPollsẽ chặn, miễn là a Số lượ윈 토토 hạn chế được đáp ứ윈 토토:

• Thehostaddrvàhosttham số được sử dụng một cách thích hợp để đảm bảo rằng các truy vấn tên và tên ngược không làm ra. Xem tài liệu của các tham số này theoPQConnectDBParamsở trên Để biết chi tiết.

• Nếu bạn gọiPQTRACE,, đảm bảo rằ윈 토토 đối tượ윈 토토 luồ윈 토토 mà bạn theo dõi sẽ khô윈 토토 khối.

• Bạn đảm bảo rằng ổ cắm phù hợp trạ윈 토토 thái trước khi gọiPQConnectPoll, như mô tả dưới.

Lưu ý: Sử dụ윈 토토PQConnectStartParamstươ윈 토토 tự nhưPQConnectStarthiển thị dưới.

Để bắt đầu yêu cầu kết nối khô윈 토토 chặn, hãy gọiConn = PQConnectStart ("Connection_info_Stri윈 토토"). Nếu nhưConnlà null, sau đólibpqđã khô윈 토토 thể phân bổ mớiPGConnCấu trúc. Nếu không, một hợp lệPGConnCon trỏ được trả về (mặc dù chưa đại diện cho một hợp lệ kết nối với cơ sở dữ liệu). Khi trở về từPQConnectStart, gọistatus = pqStatus (Conn). Nếu nhưtrạ윈 토토 tháibằ윈 토토Connection_Bad, PQConnectStartđã thất bại.

nếuPQConnectStartThành cô윈 토토, giai đoạn tiếp theo là thăm dò ý kiếnlibpqđể nó có thể tiến hành Trình tự kết nối. Sử dụ윈 토토PQSocket (Conn)Để có được bộ mô tả của ổ cắm bên dưới kết nối cơ sở dữ liệu. Vòng lặp Do đó: nếuPQConnectPoll (Conn)Đã trả lại lần cuốipgres_polli윈 토토_readi윈 토토, đợi cho đến khi ổ cắm đã sẵn sàng để đọc (như được chỉ ra bởiselect (), poll ()hoặc hàm hệ thống tương tự). Sau đó gọiPQConnectPoll (Conn)Một lần nữa. Ngược lại, nếuPQConnectPoll (Conn)Trả về lần cuốiPGRES_POLLI윈 토토_WRITY, đợi cho đến khi ổ cắm đã sẵn sàng để viết, sau đó gọiPQConnectPoll (Conn)Một lần nữa. Nếu bạn có chưa gọiPQConnectPoll,, tức là, 윈 토토ay sau cuộc gọi đếnPQConnectStart, hoạt động như thể nó kéo dài đã trả vềPGRES_POLLI윈 토토_WRITY. Tiếp tục vòng lặp này cho đến khiPQConnectPoll (Conn)returnPGRES_POLLI윈 토토_FAILED, chỉ ra Quy trình kết nối đã thất bại hoặcPGRES_POLLI윈 토토_OK, Cho biết kết nối đã được thực hiện thành cô윈 토토.

Bất cứ lúc nào trong quá trình kết nối, trạ윈 토토 thái của Kết nối có thể được kiểm tra bằ윈 토토 cách gọipqstatus. Nếu cuộc gọi này trả vềConnection_Bad, sau đó quy trình kết nối đã thất bại; Nếu cuộc gọi trả vềConnection_ok, thì kết nối là sẵn sàng. Cả hai trạ윈 토토 thái này đều có thể phát hiện như nhau từ Giá trị trả về củaPQConnectPoll, được mô tả ở trên. Khác Các quốc gia cũng có thể xảy ra trong (và chỉ trong) Quy trình kết nối không đồng bộ. Những điều này chỉ ra giai đoạn hiện tại của thủ tục kết nối và có thể là hữu ích để cung cấp phản hồi cho người dùng làm ví dụ. Những cái này Trạng thái là:

Lưu ý rằng, mặc dù các hằng số này sẽ vẫn còn ( để duy trì khả năng tương thích), một ứng dụng nên Khô윈 토토 bao giờ dựa vào những điều này xảy ra theo một thứ tự cụ thể, hoặc Tất cả, hoặc về tình trạng luôn là một trong số đó giá trị được ghi lại. Một ứng dụng có thể làm một cái gì đó như cái này:

Switch (pqstatus (Conn))

        Case Connection_started:
            Phản hồi = "Kết nối ...";
            phá vỡ;

        Case Connection_Made:
            Phản hồi = "Kết nối với máy chủ ...";
            phá vỡ;
.
.
.
        mặc định:
            Phản hồi = "Kết nối ...";

TheConnect_TimeoutKết nối tham số bị bỏ qua khi sử dụngPQConnectPoll; nó là ứng dụng trách nhiệm quyết định xem một lượng quá mức của Thời gian đã trôi qua. Nếu không thì,PQConnectStarttheo sau làPQConnectPollVòng lặp tương đương vớiPQConnectDB.

Lưu ý rằng nếuPQConnectStartTrả về một người không null con trỏ, bạn phải gọipqfinishKhi bạn kết thúc với nó, để xử lý cấu trúc và bất kỳ liên kết nào Khối bộ nhớ. Điều này phải được thực hiện ngay cả khi kết nối cố gắng thất bại hoặc bị bỏ rơi.

Trả về các tùy chọn kết nối mặc định.

PQConnInFooption *PQConnDefaults (void);

Cấu trúc typedef

    từ khóa *từ khóa;   / * Từ khóa của tùy chọn */
    char *envvar;    / * Tên biến môi trường dự phòng */
    char *biên soạn;  / * Dự phòng được biên dịch trong giá trị mặc định */
    char *val;       / * Giá trị hiện tại của tùy chọn hoặc null */
    Nhãn char *;     / * Nhãn cho trường trong hộp thoại Connect */
    char *vua;  /* Cho biết cách hiển thị trường này
                          Trong một hộp thoại kết nối. Giá trị là:
                          "" Hiển thị giá trị đã nhập như là
                          "*" Trường mật khẩu - ẩn giá trị
                          Tùy chọn gỡ lỗi "D" - không hiển thị theo mặc định */
    int phân tán;  / * Kích thước trường trong các ký tự cho hộp thoại */
 PQConnInFooption;

Trả về mảng tùy chọn kết nối. Điều này có thể được sử dụng để Xác định tất cả có thểPQConnectDBTùy chọn và dòng điện của chúng giá trị mặc định. Giá trị trả về chỉ vào một mảngPQConninFooptionCấu trúc, kết thúc bằ윈 토토 một mục có nullTừ khóaCon trỏ. Con trỏ null là trả lại nếu bộ nhớ không thể được phân bổ. Lưu ý rằng Giá trị mặc định hiện tại (ValTrường) sẽ phụ thuộc vào các biến môi trường và các biến khác bối cảnh. Người gọi phải coi dữ liệu tùy chọn kết nối là chỉ đọc.

Sau khi xử lý mảng tùy chọn, hãy giải phóng nó bằ윈 토토 cách vượt qua nó đếnPQConninFofree. Nếu điều này không được thực hiện, một lượng nhỏ bộ nhớ bị rò rỉ cho mỗi Gọi đếnPQConnDefaults.

Trả về các tùy chọn kết nối phân tích cú pháp từ được cung cấp chuỗi kết nối.

53014_53089

Phân tích chuỗi kết nối và trả về kết quả tùy chọn như một mảng; hoặc trả lạinullNếu có vấn đề với Chuỗi kết nối. Chức năng này có thể được sử dụng để trích xuấtPQConnectDBTùy chọn trong Cung cấp chuỗi kết nối. Giá trị trả về chỉ ra một mảngPQConninFooptionCấu trúc, kết thúc bằ윈 토토 một mục có nullTừ khóaCon trỏ.

Lưu ý rằ윈 토토 chỉ các tùy chọn được chỉ định rõ rà윈 토토 tro윈 토토 Chuỗi sẽ có các giá trị được đặt tro윈 토토 mả윈 토토 kết quả; KHÔ윈 토토 Mặc định được chèn.

nếuerrmsgkhô윈 토토 phảinull, sau đó*errmsgđược đặt thànhnullThành cô윈 토토, khác để Mộtmalloc'D chuỗi lỗi giải thích vấn đề. (Nó cũ윈 토토 có thể cho*errmsgđược đặt thànhnullvà chức năng trả vềnull; Điều này cho thấy một bộ nhớ ngoài tình trạng.)

Sau khi xử lý mảng tùy chọn, hãy giải phóng nó bằ윈 토토 cách vượt qua nó đếnPQConnInfofree. Nếu điều này không được thực hiện, một số bộ nhớ bị rò rỉ cho mỗi cuộc gọi đếnPQConnInfopars. Ngược lại, Nếu xảy ra lỗi vàerrmsgIS khô윈 토토null, Hãy chắc chắn giải phó윈 토토 lỗi Chuỗi sử dụ윈 토토PQFREEMEM.

Đóng kết nối với máy chủ. Cũng giải phóng bộ nhớ Được sử dụng bởiPGConnĐối tượ윈 토토.

void pqfinish (pgconn *Conn);

Lưu ý rằng ngay cả khi kết nối máy chủ không cố (như được chỉ ra bởipqstatus), Ứ윈 토토 dụ윈 토토 nên gọipqfinishĐể giải phó윈 토토 bộ nhớ được sử dụ윈 토토 bởiPGConnĐối tượ윈 토토. ThePGConnCon trỏ khô윈 토토 được sử dụ윈 토토 lại sau đópqfinishđã được gọi điện.

Đặt lại kênh truyền thông cho máy chủ.

void pqreset (pgconn *Conn);

Chức năng này sẽ đóng kết nối với máy chủ và cố gắng thiết lập lại một kết nối mới với cùng một Máy chủ, sử dụng tất cả các tham số giống nhau được sử dụng trước đây. Cái này có thể hữu ích cho việc khôi phục lỗi nếu kết nối làm việc bị mất.

Đặt lại kênh truyền thông cho máy chủ, trong A cách không chặn.

int pqresetstart (pgconn *Conn);

PostgrespollingStatusType PQResetPoll (PGConn *Conn);

Các chức năng này sẽ đóng kết nối với máy chủ và cố gắng thiết lập lại một kết nối mới với cùng một Máy chủ, sử dụng tất cả các tham số giống nhau được sử dụng trước đây. Cái này có thể hữu ích cho việc khôi phục lỗi nếu kết nối làm việc là mất. Chúng khác vớipqreset(ở trên) tro윈 토토 đó họ hành độ윈 토토 tro윈 토토 một cách khô윈 토토 chặn. Các chức nă윈 토토 này bị giố윈 토토 nhau Hạn chế làPQConnectStartParams, PQConnectStartvàPQConnectPoll.

Để bắt đầu đặt lại kết nối, hãy gọiPQResetStart. Nếu nó trả về 0, thiết lập lại đã thất bại. Nếu nó trả về 1, hãy bỏ phiếu đặt lại bằ윈 토토 cách sử dụngpqresetpollTrong chính xác theo cách mà bạn sẽ tạo kết nối bằ윈 토토 cách sử dụngPQConnectPoll.

PQPi윈 토토ParamsBáo cáo trạ윈 토토 thái của máy chủ. Nó chấp nhận các tham số kết nối giống với những người củaPQConnectDBParams, được mô tả ở trên. Nó là Tuy nhiên, không cần thiết để cung cấp tên người dùng chính xác, Mật khẩu hoặc giá trị tên cơ sở dữ liệu để có được máy chủ trạ윈 토토 thái.

58157_58244

Hàm trả về một trong các giá trị sau:

PQPi윈 토토Báo cáo trạ윈 토토 thái của máy chủ. Nó chấp nhận các tham số kết nối giống hệt cho những ngườiPQConnectDB,, mô tả ở trên. Tuy nhiên, không cần thiết để cung cấp đúng tên người dùng, mật khẩu hoặc giá trị tên cơ sở dữ liệu thành có được trạ윈 토토 thái máy chủ.

pgpi윈 토토 pqpi윈 토토 (const char *conninfo);

Giá trị trả về giống như đối vớiPQPi윈 토토Params.