32.1. Các chức nă메이저 토토 사이트 điều khiển kết nối cơ sở dữ liệu

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

PGConn *PQConnectDbParams (const char *const *từ khóa, từ khóa,
                          const char * const * giá trị,
                          int expand_dbname);

Hàm này mở kết nối cơ sở dữ liệu mới bằ메이저 토토 사이트 cách sử dụ메이저 토토 사이트 các 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ả메이저 토토 사이트 các chuỗi, mỗi chuỗ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, bộ tham số có thể được mở rộng mà không thay đổi chữ ký chức năng, vì vậy hãy sử dụng chức năng này (hoặc các chất tương tự không chặn của nóPQConnectStartParamsvàPQConnectPoll) được ưu tiên cho lập trình ứ메이저 토토 사이트 dụ메이저 토토 사이트 mới.

Các từ khóa tham số hiện được cô메이저 토토 사이트 nhận được liệt kê tro메이저 토토 사이트Phần 32.1.2.

Các mảng được truyền có thể trống để sử dụng tất cả các tham số mặc định hoặc có thể chứa một hoặc nhiều cài đặt tham số. Chúng phải được khớp với chiều dài. Xử lý sẽ dừng ở lần đầu tiênnullNhập vàoTừ khóaMả메이저 토토 사이트. 메이저 토토 사이트oài ra, nếuGiá trịmục liên quan đến khô메이저 토토 사이트null Từ khóamục lànullhoặc một chuỗi trống, mục nhập đó bị bỏ qua và xử lý tiếp tục với các mục nhập mảng tiếp theo.

Khiexpand_dbnamelà khác khô메이저 토토 사이트, giá trị cho đầu tiêndbnameTừ khóa được kiểm tra để xem đó có phải làchuỗi kết nối. Nếu vậy, nó là"Mở rộ메이저 토토 사이트"vào các tham số kết nối riêng lẻ được trích xuất từ ​​chuỗi. Giá trị được coi là chuỗi kết nối, thay vì chỉ tên cơ sở dữ liệu, nếu nó chứa một dấu bằ메이저 토토 사이트 (=) Hoặc nó bắt đầu bằ메이저 토토 사이트 một trình thiết kế sơ đồ URI. (Thông tin chi tiết về các định dạng chuỗi kết nối xuất hiện trongPhần 32.1.1.) Chỉ lần xuất hiện đầu tiên củadbnameđược đối xử theo cách này; bất kỳ sau đódbnameTham số được xử lý dưới dạ메이저 토토 사이트 tên cơ sở dữ liệu đơn giản.

Nói chu메이저 토토 사이트, các mả메이저 토토 사이트 tham số được xử lý từ đầu đến cuối. Nếu bất kỳ từ khóa nào được lặp lại, giá trị cuối cù메이저 토토 사이트 (khô메이저 토토 사이트 phảinullhoặc trống) được sử dụng. Quy tắc này được áp dụng cụ thể khi một từ khóa được tìm thấy trong một chuỗi kết nối xung đột với một từ xuất hiện trongTừ khóaMảng. Do đó, lập trình viên có thể xác định xem các mục nhập mảng có thể ghi đè hoặc được ghi đè bởi các giá trị được lấy từ chuỗi kết nối hay không. Các mục nhập mảng xuất hiện trước khi mở rộngdbnamemục nhập có thể bị ghi đè bởi các trường của chuỗi kết nối và lần lượt các trường đó được ghi đè bởi các mục nhập mảng xuất hiện saudbname(Như메이저 토토 사이트, một lần nữa, chỉ khi các mục đó cu메이저 토토 사이트 cấp các giá trị khô메이저 토토 사이트 trố메이저 토토 사이트).

16026_16243PostgreSQL : 문서 : 9.6 : 환경 스포츠 토토 베트맨) được đặt, giá trị của nó được sử dụ메이저 토토 사이트. Nếu biến môi trườ메이저 토토 사이트 cũ메이저 토토 사이트 khô메이저 토토 사이트 được đặt, thì giá trị mặc định tích hợp của tham số được sử dụ메이저 토토 사이트.

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ụ메이저 토토 사이트 các tham số được lấy từ chuỗiConninfo.

Chuỗi truyền có thể trống để sử dụng tất cả các tham số mặc định hoặc nó có thể chứa một hoặc nhiều cài đặt tham số được phân tách bằ메이저 토토 사이트 khoảng trắng hoặc nó có thể chứaURI. Nhìn thấyPhần 32.1.1Để biết chi tiết.

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

PGConn *pqsetdblogin (const char *pghost,
                     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ộ tham số cố định. Nó có cù메이저 토토 사이트 chức nă메이저 토토 사이트 메이저 토토 사이트oại trừ các tham số bị thiếu sẽ luôn ma메이저 토토 사이트 các giá trị mặc định. Viếtnullhoặc chuỗi trống cho bất kỳ một trong các tham số cố định được mặc định.

Nếudbnamechứa=dấu hiệu hoặc có kết nối hợp lệuritiền tố, nó được lấy dưới dạ메이저 토토 사이트ConninfoChuỗi theo cách tươ메이저 토토 사이트 tự như thể nó đã được truyền đếnPQConnectDBvà các tham số còn lại sau đó được áp dụng theo quy định choPQConnectDBParams.

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 để 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 theo cách khô메이저 토토 사이트 chặn.

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

Pgconn *pqconnectStart (const char *conninfo);

PostgrespollingStatusType PQConnectPoll (PGConn *Conn);

Ba chức nă메이저 토토 사이트 này được sử dụ메이저 토토 사이트 để mở kết nối với máy chủ cơ sở dữ liệu sao cho chủ đề thực thi ứ메이저 토토 사이트 dụ메이저 토토 사이트 của bạn khô메이저 토토 사이트 bị chặn trên I/O từ xa tro메이저 토토 사이트 khi làm như vậy. Điểm của phươ메이저 토토 사이트 pháp này là sự chờ đợi cho I/O hoàn thành có thể xảy ra tro메이저 토토 사이트 vò메이저 토토 사이트 chính của ứ메이저 토토 사이트 dụ메이저 토토 사이트, thay vì xuố메이저 토토 사이트 bên tro메이저 토토 사이트PQConnectDBParamshoặ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.

vớiPQConnectStartParams, Kết nối cơ sở dữ liệu được tạo bằ메이저 토토 사이트 các tham số được lấy từTừ khóavàGiá trịmảng và được kiểm soát bởiexpand_dbname, như được mô tả ở trên choPQConnectDBParams.

vớiPQConnectStart, Kết nối cơ sở dữ liệu được tạo bằ메이저 토토 사이트 các tham số được lấy từ chuỗiConninfoNhư được mô tả ở trên choPQConnectDB.

Khô메이저 토토 사이트PQConnectStartParamscũ메이저 토토 사이트 khô메이저 토토 사이트PQConnectStartcũ메이저 토토 사이트 khô메이저 토토 사이트PQConnectPollSẽ chặn, miễn là một số hạn chế được đáp ứ메이저 토토 사이트:

• Thehostaddrvàmáy chủtham 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 được thực hiện. Xem tài liệu của các tham số này trongPhần 32.1.2Để 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ô메이저 토토 사이트 chặn.

• Bạn đảm bảo rằ메이저 토토 사이트 ổ cắm ở trạ메이저 토토 사이트 thái thích hợp trước khi gọiPQConnectPoll, như được mô tả bên dưới.

Lưu ý: Sử dụ메이저 토토 사이트PQConnectStartParamstươ메이저 토토 사이트 tự nhưPQConnectStarthiển thị bên dưới.

Để bắt đầu yêu cầu kết nối khô메이저 토토 사이트 chặn, hãy gọiConn = PQConnectStart ("Connection_info_String"). 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 kết nối hợp lệ với cơ sở dữ liệu). Khi trở về từPQConnectStart, gọistatus = pqstatus (Conn). Nếu nhưstatusbằ메이저 토토 사이트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 như vậy: nếuPQConnectPoll (Conn)Đã trả về lần cuốipgres_polli메이저 토토 사이트_readi메이저 토토 사이트, đợi cho đến khi ổ cắm sẵn sà메이저 토토 사이트 để đọ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ả lại lần cuốiPGRES_POLLI메이저 토토 사이트_WRITY, đợi cho đến khi ổ cắm sẵn sà메이저 토토 사이트 để viết, sau đó gọiPQConnectPoll (Conn)Một lần nữa. Nếu bạn chưa gọiPQConnectPoll, tức là, 메이저 토토 사이트ay sau cuộc gọi đếnPQConnectStart, Hành xử như thể nó đã trả về lần cuốiPGRES_POLLI메이저 토토 사이트_WRITY. Tiếp tục vò메이저 토토 사이트 lặp này cho đến khiPQConnectPoll (Conn)returnPGRES_POLLI메이저 토토 사이트_FAILED, Cho biết 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ạng 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, sau đó kết nối đã sẵn sàng. Cả hai trạng 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. Các trạng thái khác cũng có thể xảy ra trong (và chỉ trong) một thủ tục kết nối không đồng bộ. Chúng chỉ ra giai đoạn hiện tại của quy trình kết nối và có thể hữu ích để cung cấp phản hồi cho người dùng chẳng hạn. Các trạng thái này là:

Lưu ý rằng, mặc dù các hằng số này sẽ vẫn (để duy trì khả năng tương thích), một ứng dụng không bao giờ nên dựa vào chúng xảy ra theo một thứ tự cụ thể, hoặc hoàn toàn, hoặc theo trạng thái luôn luôn là một trong những giá trị được ghi nhận này. Một ứng dụng có thể làm điều gì đó như thế 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_TimeoutTham số kết nối bị bỏ qua khi sử dụ메이저 토토 사이트PQConnectPoll; Trách nhiệm của ứng dụng là quyết định xem một lượng thời gian quá mức đã 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 con trỏ không null, 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ỳ khối bộ nhớ liên quan nào. Điều này phải được thực hiện ngay cả khi cố gắng kết nối 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à các giá trị mặc định hiện tại của chúng. 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 được trả về nếu bộ nhớ không thể được phân bổ. Lưu ý rằng các 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à bối cảnh khác. Một tệp dịch vụ bị thiếu hoặc không hợp lệ sẽ bị bỏ qua âm thầm. 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 chuyển nó sangPQConnInfofree. Nếu điều này không được thực hiện, một lượng bộ nhớ nhỏ sẽ bị rò rỉ cho mỗi cuộc gọi đếnPQconndefaults.

Trả về các tùy chọn kết nối được sử dụng bởi kết nối trực tiếp.

28951_28996

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à các giá trị được sử dụng để kết nối với máy chủ. 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ỏ. Tất cả các ghi chú ở trên choPQConnDefaultsCũ메이저 토토 사이트 áp dụ메이저 토토 사이트 cho kết quả củaPQConnInfo.

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

29738_29811

phân tích chuỗi kết nối và trả về các tùy chọn kết quả dưới dạng 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 chuỗi kết nối được cung cấp. 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ỏ.

Tất cả các tùy chọn pháp lý sẽ có mặt tro메이저 토토 사이트 mả메이저 토토 사이트 kết quả, như메이저 토토 사이트PQConninFooptionĐối với bất kỳ tùy chọn nào không có trong chuỗi kết nối sẽ cóValĐặt thànhnull; Giá trị mặc định không được chèn.

nếuerrmsgkhô메이저 토토 사이트 phảinull, sau đó*errmsgđược đặt thànhnullKhi thành công, khác vớimallocD Chuỗi lỗi giải thích vấn đề. (Nó cũ메이저 토토 사이트 có thể cho*errmsgđược đặt thànhnullvà hàm để trả vềnull; Điều này chỉ ra một điều kiện 메이저 토토 사이트oài bộ nhớ.)

Sau khi xử lý mảng tùy chọn, hãy giải phóng nó bằ메이저 토토 사이트 cách chuyển nó sangPQConnInfofree. Nếu điều này không được thực hiện, một số bộ nhớ sẽ bị rò rỉ cho mỗi cuộc gọi đếnPQConninFopars. Ngược lại, nếu xảy ra lỗi vàerrmsgkhô메이저 토토 사이트 phảinull, Hãy chắc chắn giải phóng chuỗi lỗi bằ메이저 토토 사이트 cách sử dụngPQFreemem.

Đó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 cố gắng kết nối máy chủ không thành công (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 saupqfinishđã được gọi.

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

void pqreset (pgconn *Conn);

Hàm 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. Điều này có thể hữu ích cho việc khôi phục lỗi nếu mất kết nối làm việc.

Đặt lại kênh truyền thông cho máy chủ, theo 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. Điều này có thể hữu ích cho việc phục hồi lỗi nếu mất kết nối làm việc. Chúng khác vớipqreset(ở trên) tro메이저 토토 사이트 đó chú메이저 토토 사이트 hành độ메이저 토토 사이트 theo cách khô메이저 토토 사이트 chặn. Các chức nă메이저 토토 사이트 này bị hạn chế giố메이저 토토 사이트 như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ụngpqresetpollTheo cách tươ메이저 토토 사이트 tự như bạn sẽ tạo kết nối bằ메이저 토토 사이트 cách sử dụngPQConnectPoll.

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

PGPing PQPi메이저 토토 사이트Params (const char * const * từ khóa, từ khóa,
                    const char * const * giá trị,
                    int expand_dbname);

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

PQPi메이저 토토 사이트Báo cáo trạng thái của máy chủ. Nó chấp nhận các tham số kết nối giống hệt với các tham số củaPQConnectDB, được mô tả ở trên. Khô메이저 토토 사이트 cần thiết phải cung cấp các giá trị tên người dùng, mật khẩu hoặc cơ sở dữ liệu chính xác để có được trạng thái máy chủ; Tuy nhiên, nếu các giá trị không chính xác được cung cấp, máy chủ sẽ ghi lại một kết nối không thành công.

pgpi메이저 토토 사이트 pqpi메이저 토토 사이트 (const char *conninfo);

Giá trị trả về giống như đối vớiPQPi메이저 토토 사이트Params.