Các chức năng sau liên quan đến việc tạo kèo bóng đá cúp c2 với APostgreSQLMáy chủ phụ trợ. Một chương trình ứng dụng có thể có một số kèo bóng đá cúp c2 phụ trợ mở cùng một lúc.PGConnĐối tượng, được lấy từ hàmPQConnectDB,PQConnectDBParamshoặcPQSetDbLogin. Lưu ý rằng kèo bóng đá cúp c2 chức năng này sẽ luôn trả về một con trỏ đối tượng không null, trừ khi có lẽ có quá ít bộ nhớ để phân bổPGConnĐối tượng. ThepqstatusHàm nên được gọi để kiểm tra giá trị trả về cho kèo bóng đá cúp c2 thành công trước khi các truy vấn được gửi qua đối tượng kèo bóng đá cúp c2.
Nếu người dùng kèo bóng đá cúp c2 tin cậy có quyền truy cập vào cơ sở dữ liệu chưa áp dụngmẫu sử dụng lược đồ an toàn, Bắt đầu mỗi phiên bằng cách loại bỏ kèo bóng đá cúp c2 lược đồ công khai từsearch_path. Một người có thể đặt từ khóa tham sốTùy chọnđến value-csearch_path =. Xen kẽ, người ta có thể phát hànhPQEXEC (Sau khi kèo bóng đá cúp c2. Sự cân nhắc này không cụ thể cholibpq; Nó áp dụng cho mọi giao diện để thực thi kèo bóng đá cúp c2 lệnh SQL tùy ý.Conn, "Chọn pg_catalog.set_config ('search_path', '', false)")
12599_12848EXECTừ quy trình con để tải một thực thi mới là an toàn.
PQConnectDBParams #Tạo kèo bóng đá cúp c2 mới với máy chủ cơ sở dữ liệu.
PGConn *PQConnectDbParams (const char *const *từ khóa, từ khóa,
Hàm này mở kèo bóng đá cúp c2 cơ sở dữ liệu mới bằng cách sử dụng các tham số được lấy từ hainull-kèo bóng đá cúp c2 thúc mảng. Đầu tiên,Từ khóa, được định nghĩa là một mảng kèo bóng đá cúp c2 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. kèo bóng đá cúp c2 giống 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 kèo bóng đá cúp c2 chất tương tự không chặn của nóPQConnectStartParamsvàPQConnectPoll) được ưu tiên cho lập trình ứng dụng mới.
kèo bóng đá cúp c2 từ khóa tham số hiện được công nhận được liệt kê trongPhần 34.1.2.
kèo bóng đá cúp c2 mảng được truyền có thể trống để sử dụng tất cả kèo bóng đá cúp c2 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.nullNhập vàoTừ khóaMảng. Ngoài ra, nếuGiá trịmục liên quan đến kèo bóng đá cúp c2null 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ặp mục mảng tiếp theo.
Khiexpand_dbnamelà khác kèo bóng đá cúp c2, giá trị cho đầu tiêndbnameTừ khóa được kiểm tra để xem đó có phải làchuỗi kèo bóng đá cúp c2. Nếu vậy, nó làHồiMở rộngKhănvào các tham số kèo bóng đá cúp c2 riêng lẻ được trích xuất từ chuỗi. Giá trị được coi là chuỗi kèo bóng đá cúp c2, thay vì chỉ tên cơ sở dữ liệu, nếu nó chứa một dấu bằng (=) Hoặc nó bắt đầu bằng một trình thiết kế sơ đồ URI. (Thông tin chi tiết về các định dạng chuỗi kèo bóng đá cúp c2 xuất hiện trongPhần 34.1.1.) Chỉ xảy ra lần đầu tiêndbnameđược đối xử theo cách này; bất kỳ sau đódbnameTham số được xử lý dưới dạng tên cơ sở dữ liệu đơn giản.
Nói chung, kèo bóng đá cúp c2 mảng 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ùng (không 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èo bóng đá cúp c2 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èo bóng đá cúp c2 hay không.dbnameMục nhập có thể bị ghi đè bởi các trường của chuỗi kèo bóng đá cúp c2 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ưng, một lần nữa, chỉ khi kèo bóng đá cúp c2 mục đó cung cấp kèo bóng đá cúp c2 giá trị không trống).
Sau khi xử lý tất cả các mục nhập mảng và bất kỳ chuỗi kèo bóng đá cúp c2 mở rộng nào, bất kỳ tham số kèo bóng đá cúp c2 nào vẫn không được đặt với các giá trị mặc định. Nếu biến môi trường tương ứng của tham số Undet (xemPhần 34.15) được đặt, giá trị của nó được sử dụng. Nếu biến môi trường cũng kèo bóng đá cúp c2 được đặt, thì giá trị mặc định tích hợp của tham số được sử dụng.
PQConnectDB #Tạo kèo bóng đá cúp c2 mới với máy chủ cơ sở dữ liệu.
PGConn *PQConnectDB (const char *Conninfo);
Hàm này mở kèo bóng đá cúp c2 cơ sở dữ liệu mới bằng cách sử dụng các tham số được lấy từ chuỗiConninfo.
Chuỗi truyền có thể trống để sử dụng tất cả kèo bóng đá cúp c2 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ằng khoảng trắng hoặc nó có thể chứa AURI. Nhìn thấyPhần 34.1.1Để biết chi tiết.
PQSetDbLogin #Tạo kèo bóng đá cúp c2 mới với máy chủ cơ sở dữ liệu.
PGConn *pqsetdblogin (const char *pghost,
Đây là tiền thân củaPQConnectDBVới một tập hợp kèo bóng đá cúp c2 tham số cố định. Nó có cùng chức năng ngoại trừ kèo bóng đá cúp c2 tham số bị thiếu sẽ luôn mang kèo bóng đá cúp c2 giá trị mặc định.nullhoặc một chuỗi trống cho bất kỳ một trong kèo bóng đá cúp c2 tham số cố định được mặc định.
Nếudbnamechứa=dấu hiệu hoặc có kèo bóng đá cúp c2 hợp lệuritiền tố, nó được lấy dưới dạngConninfoChuỗi theo cách tương tự như thể nó đã được truyền choPQConnectDBvà kèo bóng đá cúp c2 tham số còn lại sau đó được áp dụng theo quy định choPQConnectDBParams.
pgttykèo bóng đá cúp c2 còn được sử dụng và bất kỳ giá trị nào được thông qua sẽ bị bỏ qua.
PQSetDB #Tạo kèo bóng đá cúp c2 mới với máy chủ cơ sở dữ liệu.
PGConn *PQSetDB (char *pghost,
Đây là một macro gọiPQSetDbLoginvới kèo bóng đá cúp c2 con trỏ null choĐăng nhậpvàPWDtham số. Nó được cung cấp để tương thích ngược với kèo bóng đá cúp c2 chương trình rất cũ.
PQConnectStartParamsPQConnectStartPQConnectPoll #Tạo kèo bóng đá cúp c2 với máy chủ cơ sở dữ liệu theo cách không chặn.
PGConn *PQConnectStartParams (const char *const *từ khóa, từ khóa,
Ba chức năng này được sử dụng để mở kèo bóng đá cúp c2 với máy chủ cơ sở dữ liệu sao cho chủ đề thực thi ứng dụng của bạn không bị chặn trên I/O từ xa trong khi làm như vậy. Đ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 chính của ứng dụng, thay vì 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 kèo bóng đá cúp c2 hoạt động khác.
vớiPQConnectStartParams, kèo bóng đá cúp c2 cơ sở dữ liệu được tạo bằng 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èo bóng đá cúp c2 cơ sở dữ liệu được tạo bằng các tham số được lấy từ chuỗiConninfoNhư được mô tả ở trên choPQConnectDB.
kèo bóng đá cúp c2PQConnectStartParamscũng kèo bóng đá cúp c2PQConnectStartNorPQConnectPollSẽ chặn, miễn là một số hạn chế được đáp ứng:
Thehostaddrtham số phải được sử dụng một cách thích hợp để ngăn kèo bóng đá cúp c2 truy vấn DNS được thực hiện. Xem tài liệu của tham số này trongPhần 34.1.2Để biết chi tiết.
Nếu bạn gọiPQTRACE, Đảm bảo rằng đối tượng luồng mà bạn theo dõi sẽ kèo bóng đá cúp c2 chặn.
Bạn phải đảm bảo rằng ổ cắm ở trạng thái thích hợp trước khi gọiPQConnectPoll, như được mô tả bên dưới.
Để bắt đầu yêu cầu kèo bóng đá cúp c2 không chặn, hãy gọiPQConnectStarthoặcPQConnectStartParams. Nếu kèo bóng đá cúp c2 quả là null, thìlibpqđã kèo bóng đá cúp c2 thể phân bổ mớiPGConnCấu trúc. Nếu kèo bóng đá cúp c2, một hợp lệPGConnCon trỏ được trả về (mặc dù chưa đại diện cho kèo bóng đá cúp c2 hợp lệ với cơ sở dữ liệu). Cuộc gọi tiếp theopqstatus (Conn). Nếu kèo bóng đá cúp c2 quả làConnection_Bad, cố gắng kèo bóng đá cúp c2 đã thất bại, thường là do các tham số kèo bóng đá cúp c2 không hợp lệ.
nếuPQConnectStarthoặcPQConnectStartParamsThành công, giai đoạn tiếp theo là thăm dò ý kiếnlibpqđể nó có thể tiến hành trình tự kèo bóng đá cúp c2. Sử dụngPQSocket (Conn)Để có được bộ mô tả của ổ cắm bên dưới kèo bóng đá cúp c2 cơ sở dữ liệu. (THẬN TRỌNG: Không cho rằng ổ cắm vẫn giống nhauPQConnectPollcuộc gọi.) Vòng lặp như vậy: nếuPQConnectPoll (Conn)trở lại lần cuốipgres_polling_reading, đợi cho đến khi ổ cắm sẵn sàng đọc (như được chỉ ra bởiselect (),poll ()hoặc chức năng 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_POLLING_WRITY, đợi cho đến khi ổ cắm sẵn sàng để viết, sau đó gọiPQConnectPoll (Conn)Một lần nữa. Trên lần lặp đầu tiên, tức là, nếu bạn chưa gọiPQConnectPoll, Hành xử như thể nó đã trả về lần cuốiPGRES_POLLING_WRITY. Tiếp tục vòng lặp này cho đến khiPQConnectPoll (Conn)returnpgres_polling_failed, Cho biết quy trình kèo bóng đá cúp c2 đã thất bại hoặcpgres_polling_ok, cho biết kèo bóng đá cúp c2 đã được thực hiện thành công.
Bất cứ lúc nào trong quá trình kèo bóng đá cúp c2, trạng thái của kèo bóng đá cúp c2 có thể được kiểm tra bằng cách gọipqstatus. Nếu cuộc gọi này trả vềConnection_Bad, sau đó quy trình kèo bóng đá cúp c2 đã thất bại; Nếu cuộc gọi trả vềConnection_ok, sau đó kèo bóng đá cúp c2 đã 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èo bóng đá cúp c2 không đồng bộ.
Connection_started #chờ kèo bóng đá cúp c2 được thực hiện.
Connection_Made #kèo bóng đá cúp c2 OK; chờ gửi.
Connection_Awaiting_Response #Đang chờ phản hồi từ kèo bóng đá cúp c2 chủ.
Connection_Auth_ok #nhận được xác thực; Đang chờ phần hoàn thành khởi động.
Connection_SSL_startup #Đàm phán mã hóa SSL.
Connection_SetEnv #Cài đặt tham số điều khiển môi trường.
Connection_check_writable #Kiểm tra xem kèo bóng đá cúp c2 có thể xử lý các giao dịch ghi không.
Connection_consume #Tiêu thụ bất kỳ thông báo phản hồi còn lại nào trên kèo bóng đá cúp c2.
Lưu ý rằng, mặc dù kèo bóng đá cúp c2 hằng số này sẽ vẫn cò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))
TheConnect_TimeoutTham số kèo bóng đá cúp c2 bị bỏ qua khi sử dụngPQConnectPoll; 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.PQConnectStarttheo sau làPQConnectPollVòng lặp tương đương vớiPQConnectDB.
Lưu ý rằng khiPQConnectStarthoặcPQConnectStartParamsTrả về một con trỏ kèo bóng đá cúp c2 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èo bóng đá cúp c2 thất bại hoặc bị bỏ rơi.
PQConnDefaults #Trả về các tùy chọn kèo bóng đá cúp c2 mặc định.
PQConnInFooption *PQConnDefaults (void);
Trả về mảng tùy chọn kèo bóng đá cúp c2. Điều này có thể được sử dụng để xác định tất cả có thểPQConnectDBTùy chọn và kèo bóng đá cúp c2 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èo bóng đá cúp c2 thúc bằng một mục có nullTừ khóaCon trỏ. Con trỏ null được trả về nếu bộ nhớ kèo bóng đá cúp c2 thể được phân bổ.ValTrường) sẽ phụ thuộc vào kèo bóng đá cúp c2 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.
Sau khi xử lý mảng tùy chọn, hãy giải phóng nó bằng cách chuyển nó sangPQConnInfofree. Nếu điều này kèo bóng đá cúp c2 được thực hiện, một lượng bộ nhớ nhỏ sẽ bị rò rỉ cho mỗi cuộc gọi đếnPQConnDefaults.
PQConnInfo #Trả về các tùy chọn kèo bóng đá cúp c2 được sử dụng bởi kèo bóng đá cúp c2 trực tiếp.
PQConnInfooption *PQConnInfo (PGConn *Conn);
Trả về một mảng tùy chọn kèo bóng đá cúp c2. Đ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èo bóng đá cúp c2 với máy chủ. Giá trị trả về chỉ vào một mảngPQConninFooptioncấu trúc, kèo bóng đá cúp c2 thúc bằng một mục có nullTừ khóaCon trỏ. Tất cả kèo bóng đá cúp c2 ghi chú ở trên choPQConnDefaultsCũng áp dụng cho kèo bóng đá cúp c2 quả củaPQConnInfo.
PQConnInfopars #Trả về các tùy chọn kèo bóng đá cúp c2 phân tích cú pháp từ chuỗi kèo bóng đá cúp c2 được cung cấp.
35620_35695
Phân tích chuỗi kèo bóng đá cúp c2 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èo bóng đá cúp c2. Chức năng này có thể được sử dụng để trích xuấtPQConnectDBTùy chọn trong chuỗi kèo bóng đá cúp c2 được cung cấp. Giá trị trả về chỉ vào một mảngPQConninFooptionCấu trúc, kèo bóng đá cúp c2 thúc bằng 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 trong mảng kèo bóng đá cúp c2 quả, nhưngPQConninFooptionĐối với bất kỳ tùy chọn nào không có trong chuỗi kèo bóng đá cúp c2 sẽ cóValĐặt thànhnull; Giá trị mặc định kèo bóng đá cúp c2 được chèn.
nếuerrmsgkèo bóng đá cúp c2 phảinull, sau đó*errmsgđược đặt thànhnullThành công, khác với Amallocd Chuỗi lỗi giải thích vấn đề. (Nó cũng có thể cho*errmsgsẽ được đặt thànhnullvà hàm để trả vềnull; Điều này chỉ ra một điều kiện ngoài bộ nhớ.)
Sau khi xử lý mảng tùy chọn, hãy giải phóng nó bằng cách chuyển nó sangPQConnInfofree. Nếu điều này kèo bóng đá cúp c2 được thực hiện, một số bộ nhớ sẽ bị rò rỉ cho mỗi cuộc gọi đếnPQConnInfoparse. Ngược lại, nếu xảy ra lỗi vàerrmsgkèo bóng đá cúp c2 phảinull, Hãy chắc chắn giải phóng chuỗi lỗi bằng cách sử dụngPQFreemem.
pqfinish #Đóng kèo bóng đá cúp c2 với máy chủ. Cũng giải phóng bộ nhớ được sử dụng bởiPGConnĐối tượng.
void pqfinish (pgconn *Conn);
Lưu ý rằng ngay cả khi cố gắng kèo bóng đá cúp c2 máy chủ không thành công (như được chỉ ra bởipqstatus), Ứng dụng nên gọipqfinishĐể giải phóng bộ nhớ được sử dụng bởiPGConnĐối tượng. ThePGConnCon trỏ kèo bóng đá cúp c2 được sử dụng lại saupqfinishđã được gọi.
pqreset #Đặt lại kênh truyền thông cho kèo bóng đá cúp c2 chủ.
void pqreset (pgconn *Conn);
Hàm này sẽ đóng kèo bóng đá cúp c2 với máy chủ và cố gắng thiết lập kèo bóng đá cúp c2 mới, 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èo bóng đá cúp c2 làm việc.
pqresetstartpqresetpoll #Đặt lại kênh truyền thông cho kèo bóng đá cúp c2 chủ, theo cách không chặn.
int pqresetstart (pgconn *Conn);
Các chức năng này sẽ đóng kèo bóng đá cúp c2 với máy chủ và cố gắng thiết lập một kèo bóng đá cúp c2 mới, sử dụng tất cả các tham số giống nhau được sử dụng trước đó. Điều này có thể hữu ích cho việc phục hồi lỗi nếu mất kèo bóng đá cúp c2 làm việc.pqreset(ở trên) trong đó chúng hành động theo cách không chặn. kèo bóng đá cúp c2 chức năng này bị hạn chế giống nhưPQConnectStartParams,PQConnectStartvàPQConnectPoll.
Để bắt đầu đặt lại kèo bóng đá cúp c2, gọipqresetstart. Nếu nó trả về 0, thiết lập lại đã thất bại.pqresetpollTheo cách tương tự như bạn sẽ tạo kèo bóng đá cúp c2 bằng cách sử dụngPQConnectPoll.
PQPingParams #PQPingParamsBáo cáo trạng thái của máy chủ. Nó chấp nhận các tham số kèo bóng đá cúp c2 giống hệt với các tham số củaPQConnectDBParams, được mô tả ở trên. Không cần thiết phải cung cấp kèo bóng đá cúp c2 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ủ;
PGPing PQPingParams (const char * const * từ khóa, từ khóa,
Hàm trả về một trong kèo bóng đá cúp c2 giá trị sau:
PQPing_OK #Máy chủ đang chạy và dường như là chấp nhận kèo bóng đá cúp c2.
PQPing_Rject #Máy chủ đang chạy nhưng ở trạng thái không liên kết kèo bóng đá cúp c2 (khởi động, tắt máy hoặc phục hồi sự cố).
pqping_no_response #Máy chủ không thể liên hệ. Điều này có thể chỉ ra rằng máy chủ không chạy hoặc có điều gì đó sai với các tham số kèo bóng đá cúp c2 đã cho (ví dụ: số cổng sai) hoặc có vấn đề kèo bóng đá cúp c2 mạng (ví dụ: tường lửa chặn yêu cầu kèo bóng đá cúp c2).
PQPing_NO_ATTEMEM #Không có nỗ lực nào được thực hiện để liên hệ với máy chủ, vì kèo bóng đá cúp c2 tham số được cung cấp rõ ràng là không chính xác hoặc có một số vấn đề phía máy khách (ví dụ: ngoài bộ nhớ).
PQPing #PQPingBáo cáo trạng thái của máy chủ. Nó chấp nhận các tham số kèo bóng đá cúp c2 giống hệt với các tham số củaPQConnectDB, được mô tả ở trên. Không cần thiết phải cung cấp kèo bóng đá cúp c2 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ủ;
pgping pqping (const char *conninfo);
kèo bóng đá cúp c2 giá trị trả về giống như đối vớiPQPingParams.
Cho phép ghi đè ứng dụnglibpq'SXử lý mặc định kèo bóng đá cúp c2 tệp khóa chứng chỉ máy khách được mã hóaSử dụngSSLPasswordhoặc nhắc nhở tương tác.
VOID PQSETSSLKEYM
Ứng dụng chuyển một con trỏ đến hàm gọi lại với chữ ký:
int callback_fn (char *buf, int size, pgconn *Conn);
whatlibpqSau đó sẽ gọithay vìmặc định của nóHandler. Cuộc gọi lại sẽ xác định mật khẩu cho khóa và sao chép nó vào bộ đệm kèo bóng đá cúp c2 quảBUFcủa kích thướcsize. Chuỗi trongBUFphải được chấm dứt. Cuộc gọi lại phải trả về độ dài của mật khẩu được lưu trữ trongBUFLoại trừ Terminator null. Khi thất bại, cuộc gọi lại sẽ được đặtbuf [0] = '\ 0'và trả về 0. Xeminlibpqmã nguồn cho một ví dụ.
Nếu người dùng đã chỉ định vị trí khóa rõ ràng, đường dẫn của nó sẽ ởConn- SSLKeyKhi gọi lại. Điều này sẽ trống nếu đường dẫn khóa mặc định đang được sử dụng.OpenSSLGọi lại mật khẩu hoặc xác định xử lý riêng của họ.
Cuộc gọi lại ứng dụng có thể chọn giao kèo bóng đá cúp c2 trường hợp không được xử lý chohoặc gọi nó trước và thử một cái gì đó khác nếu nó trả về 0 hoặc hoàn toàn ghi đè nó.
Callbackkèo bóng đá cúp c2 đượcthoát khỏi điều khiển dòng chảy bình thường với ngoại lệ,longjmp (...), v.v. Nó phải trả về bình thường.
Trả về Hook Mật khẩu khóa Chứng chỉ kèo bóng đá cúp c2 khách hiện tại hoặcnullNếu kèo bóng đá cúp c2 có được đặt.
48036_48104
vàilibpqHàm phân chia chuỗi do người dùng chỉ định để có được các tham số kèo bóng đá cúp c2. Có hai định dạng được chấp nhận cho các chuỗi này: từ khóa/chuỗi giá trị đơn giản và URI.RFC 3986, ngoại trừ các chuỗi kèo bóng đá cúp c2 đa máy chủ được cho phép như được mô tả thêm bên dưới.
Trong định dạng từ khóa/giá trị, mỗi cài đặt tham số ở dạngTừ khóa = giá trị, với không gian giữa kèo bóng đá cúp c2 cài đặt. Không gian xung quanh dấu hiệu bằng nhau của cài đặt là tùy chọn.Từ khóa = 'A Value'. kèo bóng đá cúp c2 trích dẫn đơn và dấu gạch chéo ngược trong một giá trị phải được thoát ra bằng dấu gạch chéo ngược, tức là,\ 'và\.
Ví dụ:
host = port localhost = 5432 dbname = MyDB Connect_Timeout = 10
kèo bóng đá cúp c2 từ khóa tham số được công nhận được liệt kê trongPhần 34.1.2.
Biểu mẫu chung cho kèo bóng đá cúp c2uriIS:
Postgresql: // [userspec@] [hostspec] [/dbname] [?paramspec]WHEREuserspeclà:user[:Mật khẩu]vàhostspecIS:[host] [:Cổng] [,...]vàparamspecIS:tên=giá trị[& ...]
TheURINgười chỉ định sơ đồ có thể làPostgreSQL: //hoặcPostgres: //. Mỗi phần còn lạiURIkèo bóng đá cúp c2 bộ phận là tùy chọn. kèo bóng đá cúp c2 ví dụ sau minh họa hợp lệURICú pháp:
POSTGRESQL: //
kèo bóng đá cúp c2 giá trị thường xuất hiện trong phần phân cấp củaURIThay vào đó có thể được đưa ra dưới dạng tham số được đặt tên. Ví dụ:
Postgresql: /// mydb? Host = localhost & port = 5433
Tất cả kèo bóng đá cúp c2 tham số có tên phải khớp với kèo bóng đá cúp c2 từ khóa được liệt kê trongPhần 34.1.2, ngoại trừ khả năng tương thích với kèo bóng đá cúp c2 JDBCuris, kèo bóng đá cúp c2 trường hợp củassl = trueđược dịch thànhSSLMode = Yêu cầu.
kèo bóng đá cúp c2uriCần được mã hóa bằngphần trăm mã hóaNếu nó bao gồm kèo bóng đá cúp c2 ký hiệu có ý nghĩa đặc biệt trong bất kỳ phần nào của nó. Đây là một ví dụ trong đó dấu hiệu bằng nhau (=) được thay thế bằng%3Dvà ký tự kèo bóng đá cúp c2 gian với%20:
53533_53612
Phần kèo bóng đá cúp c2 chủ có thể là tên kèo bóng đá cúp c2 chủ hoặc địa chỉ IP. Để chỉ định địa chỉ IPv6, hãy đặt nó trong dấu ngoặc vuông:
Postgresql: // [2001: DB8 :: 1234]/cơ sở dữ liệu
Phần kèo bóng đá cúp c2 chủ được giải thích như được mô tả cho tham sốkèo bóng đá cúp c2 chủ. Cụ thể, kèo bóng đá cúp c2 ổ cắm miền Unix được chọn nếu phần máy chủ trống hoặc trông giống như tên đường dẫn tuyệt đối, nếu không, kèo bóng đá cúp c2 TCP/IP được bắt đầu.
Postgresql: /// dbname? Host =/var/lib/postgresql
Có thể chỉ định nhiều thành phần kèo bóng đá cúp c2 chủ, mỗi thành phần có thành phần cổng tùy chọn, trong một URI. Một URI của biểu mẫuPOSTGRESQL: // host1: port1, host2: port2, host3: port3/tương đương với chuỗi kèo bóng đá cúp c2 của biểu mẫuhost = host1, host2, host3 port = port1, port2, port3. Như được mô tả thêm dưới đây, mỗi máy chủ sẽ lần lượt được thử cho đến khi kèo bóng đá cúp c2 được thiết lập thành công.
Có thể chỉ định nhiều máy chủ để kèo bóng đá cúp c2, để chúng được thử theo thứ tự đã cho. Trong định dạng từ khóa/giá trị,host,hostaddrvàCổngTùy chọn chấp nhận danh sách kèo bóng đá cúp c2 giá trị được phân tách bằng dấu phẩy. Cùng một số phần tử phải được đưa ra trong mỗi tùy chọn được chỉ định, ví dụ: đầu tiênhostaddrtương ứng với tên kèo bóng đá cúp c2 chủ thứ nhất, thứ haihostaddrtương ứng với tên kèo bóng đá cúp c2 chủ thứ hai, v.v. Như một ngoại lệ, nếu chỉ có mộtCổngđược chỉ định, nó áp dụng cho tất cả kèo bóng đá cúp c2 máy chủ.
Trong định dạng URI kèo bóng đá cúp c2, bạn có thể liệt kê nhiềuhost: cổngcặp được phân tách bằng dấu phẩy tronghostThành phần của URI.
Trong cả hai định dạng, một tên kèo bóng đá cúp c2 chủ duy nhất có thể dịch sang nhiều địa chỉ mạng. Một ví dụ phổ biến về điều này là một kèo bóng đá cúp c2 chủ có cả địa chỉ IPv4 và IPv6.
Khi nhiều máy chủ được chỉ định hoặc khi một tên máy chủ được dịch thành nhiều địa chỉ, tất cả các máy chủ và địa chỉ sẽ được thử theo thứ tự, cho đến khi một thành công. Nếu không có máy chủ nào có thể đạt được, kèo bóng đá cúp c2 không thành công.
Nếu sử dụng tệp mật khẩu, bạn có thể có mật khẩu khác nhau cho các máy chủ khác nhau. Tất cả các tùy chọn kèo bóng đá cúp c2 khác đều giống nhau cho mọi máy chủ trong danh sách;
kèo bóng đá cúp c2 từ khóa tham số hiện được công nhận là:
HOST #Tên của máy chủ để kèo bóng đá cúp c2 với.Nếu một tên kèo bóng đá cúp c2 chủ trông giống như một tên đường dẫn tuyệt đối, nó chỉ định giao tiếp miền đơn thay vì giao tiếp TCP/IP; Giá trị là tên của thư mục trong đó tệp ổ cắm được lưu trữ.@, nó được lấy làm ổ cắm miền Unix trong kèo bóng đá cúp c2 gian tên trừu tượng (hiện được hỗ trợ trên Linux và Windows). Hành vi mặc định khikèo bóng đá cúp c2 chủkhông được chỉ định hoặc trống, là kèo bóng đá cúp c2 với ổ cắm miền đơn vịin/TMP(hoặc bất kỳ thư mục ổ cắm nào được chỉ định khiPostgreSQLđã được xây dựng). Trên Windows, mặc định là kèo bóng đá cúp c2 vớiLocalhost.
Một danh sách kèo bóng đá cúp c2 tên máy chủ được phân tách bằng dấu phẩy cũng được chấp nhận, trong trường hợp mỗi tên máy chủ trong danh sách được thử theo thứ tự; Một mục trống trong danh sách chọn hành vi mặc định như được giải thích ở trên.Phần 34.1.1.3Để biết chi tiết.
hostaddr #Địa chỉ IP số của máy chủ để kèo bóng đá cúp c2 với. Điều này phải ở định dạng địa chỉ IPv4 tiêu chuẩn, ví dụ:172.28.40.9. Nếu máy của bạn hỗ trợ IPv6, bạn cũng có thể sử dụng kèo bóng đá cúp c2 địa chỉ đó.hostSẽ được tra cứu để tìm địa chỉ IP tương ứng - hoặc, nếuhostChỉ định địa chỉ IP, giá trị đó sẽ được sử dụng trực tiếp.
Sử dụnghostaddrCho phép ứng dụng tránh tra cứu tên máy chủ, điều này có thể quan trọng trong kèo bóng đá cúp c2 ứng dụng với kèo bóng đá cúp c2 ràng buộc về thời gian. Tuy nhiên, tên máy chủ được yêu cầu cho kèo bóng đá cúp c2 phương thức xác thực GSSAPI hoặc SSPI, cũng như choxác minh-đầy đủXác minh chứng chỉ SSL. kèo bóng đá cúp c2 quy tắc sau được sử dụng:
nếuhostđược chỉ định mà kèo bóng đá cúp c2 cóhostaddr, Tra cứu tên kèo bóng đá cúp c2 chủ xảy ra. (Khi sử dụngPQConnectPoll, Tra cứu xảy ra khiPQConnectPollĐầu tiên xem xét tên kèo bóng đá cúp c2 chủ này và nó có thể gây raPQConnectPollĐể chặn trong một khoảng thời gian đáng kể.)
nếuhostaddrđược chỉ định mà kèo bóng đá cúp c2 cóhost, giá trị chohostaddrCung cấp địa chỉ mạng máy chủ. Nỗ lực kèo bóng đá cúp c2 sẽ thất bại nếu phương thức xác thực yêu cầu tên máy chủ.
Nếu cả haihostvàhostaddrđược chỉ định, giá trị chohostaddrCung cấp địa chỉ mạng kèo bóng đá cúp c2 chủ. Giá trị chohostbị bỏ qua trừ khi phương thức xác thực yêu cầu, trong trường hợp đó nó sẽ được sử dụng làm tên kèo bóng đá cúp c2 chủ.
Lưu ý rằng xác thực có khả năng thất bại nếuhostkhông phải là tên của kèo bóng đá cúp c2 chủ tại địa chỉ mạnghostaddr. Ngoài ra, khi cả haihostvàhostaddrđược chỉ định,hostđược sử dụng để xác định kèo bóng đá cúp c2 trong tệp mật khẩu (xemPhần 34.16).
Danh sách được phân tách bằng dấu phẩyhostaddrGiá trị cũng được chấp nhận, trong trường hợp đó, mỗi kèo bóng đá cúp c2 chủ trong danh sách được thử theo thứ tự. Một mục trống trong danh sách khiến tên kèo bóng đá cúp c2 chủ tương ứng được sử dụng hoặc tên kèo bóng đá cúp c2 chủ mặc định nếu đó cũng trống.Phần 34.1.1.3Để biết chi tiết.
Không có tên kèo bóng đá cúp c2 chủ hoặc địa chỉ kèo bóng đá cúp c2 chủ,libpqSẽ kèo bóng đá cúp c2 bằng cách sử dụng ổ cắm tên miền đơn vị cục bộ; hoặc trên Windows, nó sẽ cố gắng kèo bóng đá cúp c2 vớiLocalhost.
Cổng #Số cổng để kèo bóng đá cúp c2 tại máy chủ máy chủ hoặc tiện ích mở rộng tên tệp cho các kèo bóng đá cúp c2 miền đơn vị.Nếu nhiều kèo bóng đá cúp c2 chủ được đưa ra trongkèo bóng đá cúp c2 chủhoặchostaddrTham số, tham số này có thể chỉ định danh sách kèo bóng đá cúp c2 cổng được phân tách bằng dấu phẩy có cùng độ dài với danh sách máy chủ hoặc nó có thể chỉ định một số cổng duy nhất được sử dụng cho tất cả kèo bóng đá cúp c2 máy chủ. Một chuỗi trống hoặc một mục trống trong danh sách được phân tách bằng dấu phẩy, chỉ định số cổng mặc định được thiết lập khiPostgreSQLđược xây dựng.
dbname #Tên cơ sở dữ liệu. Mặc định giống như tên người dùng.Phần 34.1.1Để biết thêm chi tiết về những điều đó.
user #POSTGRESQLTên người dùng để kèo bóng đá cúp c2 AS. Mặc định giống như tên hệ điều hành của người dùng đang chạy ứng dụng.
Mật khẩu #Mật khẩu sẽ được sử dụng nếu kèo bóng đá cúp c2 chủ yêu cầu xác thực mật khẩu.
passfile #Chỉ định tên của tệp được sử dụng để lưu trữ mật khẩu (xemPhần 34.16). Mặc định là~/.pgasshoặc%appdata%\ postgresql \ pgpass.conftrên Microsoft Windows. (kèo bóng đá cúp c2 có lỗi nào được báo cáo nếu tệp này kèo bóng đá cúp c2 tồn tại.)
Yêu cầu_auth #Chỉ định phương thức xác thực mà máy khách yêu cầu từ máy chủ. Nếu máy chủ không sử dụng phương thức bắt buộc để xác thực máy khách hoặc nếu máy chủ bắt tay xác thực không hoàn thành hoàn toàn, kèo bóng đá cúp c2 sẽ không thành công.
Phương pháp có thể bị phủ nhận với việc bổ sung!tiền tố, trong trường hợp đó kèo bóng đá cúp c2 chủ phảikèo bóng đá cúp c2Hãy thử phương pháp được liệt kê; Bất kỳ phương thức nào khác đều được chấp nhận và kèo bóng đá cúp c2 chủ miễn phí để không xác thực kèo bóng đá cúp c2 khách.anycủa các phương thức phủ định được liệt kê. Các hình thức bị phủ định và không bị phân loại có thể không được kèo bóng đá cúp c2 hợp trong cùng một cài đặt.
như một trường hợp đặc biệt cuối cùng,kèo bóng đá cúp c2Phương pháp yêu cầu kèo bóng đá cúp c2 chủ không sử dụng thử thách xác thực. (Nó cũng có thể được phủ định, để yêu cầu một số hình thức xác thực.)
kèo bóng đá cúp c2 phương pháp sau đây có thể được chỉ định:
Mật khẩukèo bóng đá cúp c2 chủ phải yêu cầu xác thực mật khẩu Plaintext.
MD5kèo bóng đá cúp c2 chủ phải yêu cầu xác thực mật khẩu băm MD5.
GSSkèo bóng đá cúp c2 chủ phải yêu cầu bắt tay kerberos quaGSSAPIhoặc thiết lập mộtGSS-Encrypted Kênh (xem thêmGSSENCMode).
SSPIkèo bóng đá cúp c2 chủ phải yêu cầu WindowsSSPIXác thực.
Scram-Sha-256kèo bóng đá cúp c2 chủ phải hoàn thành thành công trao đổi xác thực Scram-Sha-256 với kèo bóng đá cúp c2 khách.
kèo bóng đá cúp c2kèo bóng đá cúp c2 chủ không được nhắc kèo bóng đá cúp c2 khách trao đổi xác thực. .
Channel_binding #Tùy chọn này kiểm soát việc sử dụng liên kèo bóng đá cúp c2 kênh của khách hàng. Một cài đặt củaYêu cầucó nghĩa là kèo bóng đá cúp c2 phải sử dụng liên kết kênh,ưa thíchCó nghĩa là máy khách sẽ chọn liên kèo bóng đá cúp c2 kênh nếu có vàvô hiệu hóaNgăn chặn việc sử dụng liên kèo bóng đá cúp c2 kênh. Mặc định làưa thíchnếuPostgreSQLđược biên dịch với hỗ trợ SSL; nếu kèo bóng đá cúp c2 thì mặc định làvô hiệu hóa.
Liên kết kênh là một phương thức để máy chủ tự xác thực với máy khách. Nó chỉ được hỗ trợ qua các kèo bóng đá cúp c2 SSL vớiPostgreSQL11 kèo bóng đá cúp c2 chủ hoặc sau đó bằng cách sử dụngScramPhương pháp xác thực.
Connect_Timeout #Thời gian tối đa để chờ đợi trong khi kèo bóng đá cúp c2, tính bằng giây (viết dưới dạng số nguyên thập phân, ví dụ:10). Số kèo bóng đá cúp c2, âm, hoặc kèo bóng đá cúp c2 được chỉ định có nghĩa là chờ vô thời hạn.1được hiểu là2. Thời gian chờ này áp dụng riêng cho từng tên kèo bóng đá cúp c2 chủ hoặc địa chỉ IP.Connect_Timeoutlà 5, mỗi máy chủ sẽ hết thời gian nếu không có kèo bóng đá cúp c2 nào được thực hiện trong vòng 5 giây, do đó, tổng thời gian chờ đợi kèo bóng đá cúp c2 có thể lên đến 10 giây.
client_encoding #Điều này đặtclient_encodingTham số cấu hình cho kèo bóng đá cúp c2 này. Ngoài các giá trị được chấp nhận bởi tùy chọn máy chủ tương ứng, bạn có thể sử dụngAutoĐể xác định đúng mã hóa từ vị trí hiện tại trong kèo bóng đá cúp c2 khách (LC_CTYPEBiến môi trường trên kèo bóng đá cúp c2 hệ thống UNIX).
Tùy chọn #Chỉ định các tùy chọn dòng lệnh để gửi đến máy chủ khi bắt đầu kèo bóng đá cúp c2. Ví dụ: đặt cái này thành-c geqo = offĐặt giá trị phiên củageqotham số đếnTẮT. Không gian trong chuỗi này được coi là kèo bóng đá cúp c2 đối số dòng lệnh riêng biệt, trừ khi thoát ra bằng dấu gạch chéo ngược (\); viết\Để thể hiện dấu gạch chéo ngược theo nghĩa đen. Để thảo luận chi tiết về kèo bóng đá cúp c2 tùy chọn có sẵn, hãy tham khảo ý kiếnChương 20.
application_name #Chỉ định giá trị choapplication_nameTham số cấu hình.
fallback_application_name #Chỉ định giá trị dự phòng choapplication_nameTham số cấu hình. Giá trị này sẽ được sử dụng nếu kèo bóng đá cúp c2 có giá trị nào được đưa ra choapplication_namethông qua tham số kèo bóng đá cúp c2 hoặcPGAPPNAMEBiến môi trường. Chỉ định tên dự phòng rất hữu ích trong kèo bóng đá cúp c2 chương trình tiện ích chung muốn đặt tên ứng dụng mặc định nhưng cho phép nó bị người dùng ghi đè.
Keepalive #Kiểm soát xem kèo bóng đá cúp c2 thiết bị giữ TCP phía máy khách có được sử dụng hay không. Giá trị mặc định là 1, có nghĩa là trên, nhưng bạn có thể thay đổi điều này thành 0, có nghĩa là tắt, nếu không muốn.
Keepalive_idle #Kiểm soát số giây không hoạt động sau đó TCP sẽ gửi một thông báo giữ cho kèo bóng đá cúp c2 chủ. Giá trị bằng 0 sử dụng mặc định hệ thống.TCP_Keepidlehoặc tùy chọn ổ cắm tương đương có sẵn và trên Windows; Trên kèo bóng đá cúp c2 hệ thống khác, nó không có tác dụng.
Keepalive_interval #Kiểm soát số giây sau đó một thông điệp giữ TCP không được kèo bóng đá cúp c2 chủ thừa nhận nên được truyền lại. Giá trị bằng 0 sử dụng mặc định hệ thống.TCP_KeepIntVLhoặc tùy chọn ổ cắm tương đương có sẵn và trên Windows; Trên kèo bóng đá cúp c2 hệ thống khác, nó không có tác dụng.
Keepalive_Count #Kiểm soát số lượng Keepalive TCP có thể bị mất trước khi kèo bóng đá cúp c2 của khách hàng với máy chủ được coi là đã chết. Giá trị bằng 0 sử dụng mặc định hệ thống.tcp_keepcnthoặc tùy chọn ổ cắm tương đương có sẵn; Trên kèo bóng đá cúp c2 hệ thống khác, nó không có tác dụng.
TCP_USER_TIMEOUT #Kiểm soát số lượng mili giây mà dữ liệu truyền có thể vẫn chưa được kiểm chứng trước khi kèo bóng đá cúp c2 bị đóng lại. Giá trị bằng 0 sử dụng mặc định hệ thống.TCP_USER_TIMEOUTcó sẵn; Trên kèo bóng đá cúp c2 hệ thống khác, nó không có tác dụng.
sao chép #Tùy chọn này xác định xem kèo bóng đá cúp c2 có nên sử dụng giao thức sao chép thay vì giao thức thông thường hay không. Đây là những gì kèo bóng đá cúp c2 sao chép PostgreSQL cũng như các công cụ nhưpg_basebackupSử dụng nội bộ, nhưng nó cũng có thể được sử dụng bởi kèo bóng đá cúp c2 ứng dụng của bên thứ ba. Để biết mô tả về giao thức sao chép, tham khảo ý kiếnPhần 55.4.
kèo bóng đá cúp c2 giá trị sau, không nhạy cảm với trường hợp, được hỗ trợ:
TRUE,trên,Có,1kèo bóng đá cúp c2 chuyển sang chế độ sao chép vật lý.
Cơ sở dữ liệukèo bóng đá cúp c2 chuyển sang chế độ sao chép logic, kèo bóng đá cúp c2 với cơ sở dữ liệu được chỉ định trongdbnametham số.
Sai,TẮT,kèo bóng đá cúp c2,0kèo bóng đá cúp c2 là thông thường, là hành vi mặc định.
Trong chế độ sao chép vật lý hoặc logic, chỉ có thể sử dụng giao thức truy vấn đơn giản.
GSSENCMode #Tùy chọn này xác định xem có ưu tiên nào an toànGSSkèo bóng đá cúp c2 TCP/IP sẽ được đàm phán với máy chủ. Có ba chế độ:
vô hiệu hóaChỉ thử kèo bóng đá cúp c2GSSAPI-Chencepted Connection
ưa thích(mặc định)Nếu cóGSSAPIThông tin hiện tại (tức là, trong bộ đệm thông tin đăng nhập), trước tiên hãy thử AGSSAPIkèo bóng đá cúp c2 -Crypted; Nếu thất bại hoặc không có thông tin đăng nhập, hãy thử khôngGSSAPIkèo bóng đá cúp c2 -Crypted. Đây là mặc định khiPOSTGRESQLđã được biên dịch vớiGSSAPIHỗ trợ.
Yêu cầuChỉ thử AGSSAPI-N
GSSENCModebị bỏ qua cho giao tiếp ổ cắm miền UNIX. Nếu nhưPOSTGRESQLđược biên dịch mà kèo bóng đá cúp c2 cần hỗ trợ GSSAPI, sử dụngYêu cầuTùy chọn sẽ gây ra lỗi, trong khiưa thíchsẽ được chấp nhận nhưnglibpqSẽ kèo bóng đá cúp c2 thực sự thử AGSSAPIkèo bóng đá cúp c2 -Crypted.
SSLMode #Tùy chọn này xác định xem có ưu tiên nào an toànSSLkèo bóng đá cúp c2 TCP/IP sẽ được đàm phán với máy chủ. Có sáu chế độ:
vô hiệu hóaChỉ thử kèo bóng đá cúp c2SSLkèo bóng đá cúp c2
Cho phépĐầu tiên hãy thử kèo bóng đá cúp c2SSLkèo bóng đá cúp c2; Nếu thất bại, hãy thửSSLkèo bóng đá cúp c2
ưa thích(mặc định)Đầu tiên hãy thửSSLkèo bóng đá cúp c2; Nếu thất bại, hãy thử khôngSSLkèo bóng đá cúp c2
Yêu cầuChỉ thửSSLkèo bóng đá cúp c2. Nếu có tệp Ca gốc, hãy xác minh chứng chỉ theo cách tương tự nhưXác minh-CAđã được chỉ định
Xác minh-CAchỉ thửSSLkèo bóng đá cúp c2 và xác minh rằng chứng chỉ máy chủ được cấp bởi cơ quan chứng chỉ đáng tin cậy (CA)
xác minh-đầy đủChỉ thửSSLkèo bóng đá cúp c2, xác minh rằng chứng chỉ máy chủ được cấp bởi một người đáng tin cậyCAVà tên kèo bóng đá cúp c2 chủ kèo bóng đá cúp c2 chủ được yêu cầu phù hợp với chứng chỉ
xemPhần 34.19Để biết mô tả chi tiết về cách kèo bóng đá cúp c2 tùy chọn này hoạt động.
SSLModebị bỏ qua cho giao tiếp ổ cắm miền UNIX. Nếu nhưPostgreSQLđược biên dịch mà không cần hỗ trợ SSL, sử dụng kèo bóng đá cúp c2 tùy chọnYêu cầu,Xác minh-CAhoặcxác minh-đầy đủsẽ gây ra lỗi, trong khi kèo bóng đá cúp c2 tùy chọncho phépvàưa thíchsẽ được chấp nhận nhưnglibpqSẽ kèo bóng đá cúp c2 thực sự thửSSLkèo bóng đá cúp c2.
Lưu ý rằng nếuGSSAPIMã hóa là có thể, sẽ được sử dụng để ưu tiên choSSLMã hóa, bất kể giá trị củaSSLMode. Để buộc sử dụngSSLMã hóa trong một môi trường có hoạt độngGSSAPICơ sở hạ tầng (như kèo bóng đá cúp c2 chủ Kerberos), cũng được đặtGSSENCModeđếnvô hiệu hóa.
abitessl #Tùy chọn này kèo bóng đá cúp c2 được ủng hộ theo hướngSSLModeCài đặt.
Nếu được đặt thành 1, anSSLkèo bóng đá cúp c2 với máy chủ là bắt buộc (điều này tương đương vớiSSLMode Yêu cầu).libpqSau đó sẽ từ chối kèo bóng đá cúp c2 nếu máy chủ không chấp nhậnSSLkèo bóng đá cúp c2. Nếu đặt thành 0 (mặc định),libpqSẽ thương lượng loại kèo bóng đá cúp c2 với máy chủ (tương đương vớiSSLMode ưa thích). Tùy chọn này chỉ khả dụng nếuPostgreSQLđược biên dịch với hỗ trợ SSL.
SSLCompression #Nếu được đặt thành 1, dữ liệu được gửi qua các kèo bóng đá cúp c2 SSL sẽ được nén. Nếu được đặt thành 0, nén sẽ bị tắt.
Nén SSL ngày nay được coi là kèo bóng đá cúp c2 an toàn và việc sử dụng nó kèo bóng đá cúp c2 còn được khuyến nghị nữa.OpenSSL85032_85252PostgreSQL14 Vô hiệu hóa hoàn toàn nén trong phần phụ trợ.
Nếu bảo mật kèo bóng đá cúp c2 phải là mối quan tâm chính, nén có thể cải thiện thông lượng nếu mạng là nút cổ chai. Vô hiệu hóa nén có thể cải thiện thời gian phản hồi và thông lượng nếu hiệu suất CPU là yếu tố giới hạn.
SSLCERT #Tham số này chỉ định tên tệp của chứng chỉ SSL của kèo bóng đá cúp c2 khách, thay thế mặc định~/.Postgresql/postgresql.crt. Tham số này bị bỏ qua nếu kèo bóng đá cúp c2 SSL không được thực hiện.
SSLKey #Tham số này chỉ định vị trí cho khóa bí mật được sử dụng cho chứng chỉ kèo bóng đá cúp c2 khách. Nó có thể chỉ định tên tệp sẽ được sử dụng thay vì mặc định~/.Postgresql/postgresql.keyhoặc nó có thể chỉ định một khóa thu được từ bên ngoàiĐộng cơ(Động cơ làOpenSSLMô -đun có thể tải). Một đặc điểm kỹ thuật của động cơ bên ngoài nên bao gồm một tên động cơ được phân tách đại tràng và mã định danh khóa dành riêng cho động cơ.
SSLPassword #Tham số này chỉ định mật khẩu cho khóa bí mật được chỉ định trongSSLKey87110_87250
Chỉ định tham số này với bất kỳ giá trị kèo bóng đá cúp c2 trống nào ngăn chặnNhập cụm từ PEM PASS:nhắc nhở rằngOpenSSLSẽ phát ra theo mặc định khi khóa chứng chỉ kèo bóng đá cúp c2 khách được mã hóa được cung cấp cholibpq.
Nếu khóa không được mã hóa tham số này bị bỏ qua. Tham số không có tác dụng đối với kèo bóng đá cúp c2 khóa được chỉ định bởiOpenSSLĐộng cơ trừ khi động cơ sử dụngOpenSSLCơ chế gọi lại mật khẩu cho lời nhắc.
kèo bóng đá cúp c2 có biến môi trường tương đương với tùy chọn này và kèo bóng đá cúp c2 có cơ sở nào để tìm kiếm nó trong.pgass. Nó có thể được sử dụng trong một định nghĩa kèo bóng đá cúp c2 tệp dịch vụ.OpenSSLĐộng cơ và công cụ như PKCS#11 hoặc thiết bị giảm tiền điện tử USB.
SSLCERTMODE #Tùy chọn này xác định liệu chứng chỉ kèo bóng đá cúp c2 khách có thể được gửi đến kèo bóng đá cúp c2 chủ hay không và liệu kèo bóng đá cúp c2 chủ có bắt buộc phải yêu cầu không. Có ba chế độ:
vô hiệu hóaChứng chỉ kèo bóng đá cúp c2 khách không bao giờ được gửi, ngay cả khi có sẵn (vị trí mặc định hoặc được cung cấp quaSSLCERT).
Cho phép(mặc định)có thể được gửi chứng chỉ, nếu kèo bóng đá cúp c2 chủ yêu cầu một và kèo bóng đá cúp c2 khách có một để gửi.
Yêu cầukèo bóng đá cúp c2 chủphảiYêu cầu chứng chỉ. kèo bóng đá cúp c2 sẽ không thành công nếu máy khách không gửi chứng chỉ và máy chủ xác thực thành công máy khách.
SSLCERTMODE = Yêu cầuKhông thêm bất kỳ bảo mật bổ sung nào, vì không có gì đảm bảo rằng máy chủ đang xác thực chính xác chứng chỉ; kèo bóng đá cúp c2 máy chủ PostgreSQL thường yêu cầu chứng chỉ TLS từ khách hàng cho dù họ có xác nhận chúng hay không.
SSLROOTCERT #Tham số này chỉ định tên của một tệp chứa Cơ quan chứng chỉ SSL (CA) Chứng chỉ (s). Nếu tệp tồn tại, chứng chỉ của kèo bóng đá cúp c2 chủ sẽ được xác minh để được ký bởi một trong những cơ quan này.~/.Postgresql/root.crt.
Giá trị đặc biệtSystemcó thể được chỉ định thay thế, trong trường hợp đó, rễ ca đáng tin cậy của hệ thống sẽ được tải. Vị trí chính xác của kèo bóng đá cúp c2 chứng chỉ gốc này khác nhau theo triển khai SSL và nền tảng.OpenSSLĐặc biệt, kèo bóng đá cúp c2 vị trí có thể được sửa đổi thêm bởiSSL_CERT_DIRvàSSL_CERT_FILEBiến môi trường.
Khi sử dụngsslrootcert = System, mặc địnhSSLModeđược thay đổi thànhxác minh-đầy đủvà bất kỳ cài đặt yếu nào hơn sẽ dẫn đến lỗi. Trong hầu hết các trường hợp, mọi người đều tầm thường để có được chứng chỉ được hệ thống tin cậy cho tên máy chủ mà họ kiểm soát, kèo bóng đá cúp c2 xuấtXác minh-CAvà tất cả kèo bóng đá cúp c2 chế độ yếu hơn vô dụng.
The MagicSystemGiá trị sẽ được ưu tiên hơn một tệp chứng chỉ cục bộ có cùng tên. Nếu vì một lý do nào đó, bạn thấy mình trong tình huống này, hãy sử dụng một đường dẫn thay thế nhưsslrootcert =./Systemthay vào đó.
SSLCRL #Tham số này chỉ định tên tệp của danh sách thu hồi chứng chỉ máy chủ SSL (CRL). kèo bóng đá cúp c2 chứng chỉ được liệt kê trong tệp này, nếu nó tồn tại, sẽ bị từ chối trong khi cố gắng xác thực chứng chỉ của máy chủ.SSLCRLNorsslcrldirđược đặt, cài đặt này được lấy làm~/.Postgresql/root.crl.
sslcrldir #Tham số này chỉ định tên thư mục của danh sách thu hồi chứng chỉ máy chủ SSL (CRL). kèo bóng đá cúp c2 chứng chỉ được liệt kê trong kèo bóng đá cúp c2 tệp trong thư mục này, nếu nó tồn tại, sẽ bị từ chối trong khi cố gắng xác thực chứng chỉ của máy chủ.
Thư mục cần được chuẩn bị vớiOpenSSLLệnhOpenSSL RehashhoặcC_rehash. Xem tài liệu của nó để biết chi tiết.
cảSSLCRLvàsslcrldircó thể được chỉ định cùng nhau.
SSLSNI #Nếu được đặt thành 1 (mặc định), LibPQ đặt tiện ích mở rộng TLSChỉ định tên kèo bóng đá cúp c2 chủ(SNI) trên các kèo bóng đá cúp c2 hỗ trợ SSL. Bằng cách đặt tham số này thành 0, điều này đã bị tắt.
Chỉ định tên máy chủ có thể được sử dụng bởi các proxy nhận biết SSL để định tuyến các kèo bóng đá cúp c2 mà không phải giải mã luồng SSL. .SNILàm cho tên kèo bóng đá cúp c2 chủ đích xuất hiện trong Cleartext trong lưu lượng mạng, vì vậy nó có thể không mong muốn trong một số trường hợp.
Yêu cầu #Tham số này chỉ định tên người dùng hệ điều hành của kèo bóng đá cúp c2 chủ, ví dụaberpeer = postgres. Khi tạo kèo bóng đá cúp c2 ổ cắm miền Unix, nếu tham số này được đặt, máy khách sẽ kiểm tra ở đầu kèo bóng đá cúp c2 mà quy trình máy chủ đang chạy dưới tên người dùng được chỉ định;/TMPhoặc một vị trí có thể ghi công khai khác, bất kỳ người dùng nào cũng có thể bắt đầu nghe máy chủ ở đó. Sử dụng tham số này để đảm bảo rằng bạn được kèo bóng đá cúp c2 với máy chủ do người dùng đáng tin cậy chạy.) Tùy chọn này chỉ được hỗ trợ trên các nền tảng màPeerPhương thức xác thực được thực hiện; nhìn thấyPhần 21.9.
ssl_min_protocol_version #Tham số này chỉ định phiên bản giao thức SSL/TLS tối thiểu để cho phép kèo bóng đá cúp c2. Giá trị hợp lệ làTLSV1,TLSV1.1,TLSV1.2vàTLSV1.3. kèo bóng đá cúp c2 giao thức được hỗ trợ phụ thuộc vào phiên bảnOpenSSLkèo bóng đá cúp c2 phiên bản cũ hơn đã sử dụng không hỗ trợ kèo bóng đá cúp c2 phiên bản giao thức hiện đại nhất. Nếu không được chỉ định, mặc định làTLSV1.2, thỏa mãn kèo bóng đá cúp c2 thực tiễn tốt nhất của ngành như bài viết này.
ssl_max_protocol_version #Tham số này chỉ định phiên bản giao thức SSL/TLS tối đa để cho phép kèo bóng đá cúp c2. Giá trị hợp lệ làTLSV1,TLSV1.1,TLSV1.2vàTLSV1.3. kèo bóng đá cúp c2 giao thức được hỗ trợ phụ thuộc vào phiên bảnOpenSSLCác phiên bản cũ hơn đã sử dụng không hỗ trợ các phiên bản giao thức hiện đại nhất. Nếu không được đặt, tham số này bị bỏ qua và kèo bóng đá cúp c2 sẽ sử dụng ràng buộc tối đa được xác định bởi phần phụ trợ, nếu được đặt.
krbsrvname #Tên dịch vụ Kerberos sẽ sử dụng khi xác thực với GSSAPI. Điều này phải khớp với tên dịch vụ được chỉ định trong cấu hình kèo bóng đá cúp c2 chủ để xác thực Kerberos để thành công.Phần 21.6.) Giá trị mặc định thường làPostgres, nhưng có thể thay đổi khi xây dựngPOSTGRESQLthông qua--with-krb-srvnamTùy chọnCấu hình. Trong hầu hết kèo bóng đá cúp c2 môi trường, tham số này không bao giờ cần phải thay đổi.Postgres).
GSSLIB #Thư viện GSS để sử dụng để xác thực GSSAPI. Hiện tại điều này bị coi thường ngoại trừ trên kèo bóng đá cúp c2 bản dựng Windows bao gồm cả hỗ trợ GSSAPI và SSPI.GSSAPIĐể khiến LibPQ sử dụng thư viện GSSAPI để xác thực thay vì SSPI mặc định.
GSSDelegation #Chuyển tiếp (Đại biểu) Thông tin GSS cho kèo bóng đá cúp c2 chủ. Mặc định là0có nghĩa là thông tin đăng nhập sẽ không được chuyển tiếp đến kèo bóng đá cúp c2 chủ. Đặt cái này thành1Để có thông tin đăng nhập khi có thể.
Dịch vụ #Tên dịch vụ để sử dụng cho kèo bóng đá cúp c2 tham số bổ sung. Nó chỉ định tên dịch vụ trongpg_service.confgiữ các tham số kèo bóng đá cúp c2 bổ sung. Điều này cho phép các ứng dụng chỉ chỉ định một tên dịch vụ để các tham số kèo bóng đá cúp c2 có thể được duy trì tập trung.Phần 34.17.
target_session_attrs #Tùy chọn này xác định xem phiên phải có các thuộc tính nhất định được chấp nhận hay không. Nó thường được sử dụng kèo bóng đá cúp c2 hợp với nhiều tên máy chủ để chọn giải pháp thay thế được chấp nhận đầu tiên trong số một số máy chủ.
bất kỳ(mặc định)Bất kỳ kèo bóng đá cúp c2 thành công nào cũng được chấp nhận
Read-WritePhiên phải chấp nhận kèo bóng đá cúp c2 giao dịch đọc-ghi theo mặc định (nghĩa là máy chủ không được ở chế độ chờ nóng vàdefault_transaction_read_onlytham số phải làTẮT)
Chỉ đọcPhiên kèo bóng đá cúp c2 được chấp nhận giao dịch đọc-ghi theo mặc định (Converse)
Tiểu họckèo bóng đá cúp c2 chủ không được ở chế độ chờ nóng
chờkèo bóng đá cúp c2 chủ phải ở chế độ chờ nóng
Prefer-StandbyTrước tiên hãy thử tìm kèo bóng đá cúp c2 chủ dự phòng, nhưng nếu không có kèo bóng đá cúp c2 chủ được liệt kê là kèo bóng đá cúp c2 chủ dự phòng, hãy thử lạianyMode
load_balance_hosts #Kiểm soát thứ tự mà khách hàng cố gắng kèo bóng đá cúp c2 với các máy chủ và địa chỉ có sẵn. Khi một nỗ lực kèo bóng đá cúp c2 thành công, không có máy chủ và địa chỉ nào khác sẽ được thử.target_session_attrsVí dụ, chỉ cân bằng tải trên các máy chủ dự phòng. Sau khi kèo bóng đá cúp c2 thành công, các truy vấn tiếp theo trên kèo bóng đá cúp c2 được trả về đều sẽ được gửi đến cùng một máy chủ.
vô hiệu hóa(mặc định)Không cân bằng tải trên kèo bóng đá cúp c2 chủ được thực hiện. kèo bóng đá cúp c2 chủ được thử theo thứ tự chúng được cung cấp và địa chỉ được thử theo thứ tự chúng được nhận từ DNS hoặc tệp kèo bóng đá cúp c2 chủ.
ngẫu nhiênMáy chủ và địa chỉ được thử theo thứ tự ngẫu nhiên. Giá trị này chủ yếu là hữu ích khi mở nhiều kèo bóng đá cúp c2 cùng một lúc, có thể từ các máy khác nhau.PostgreSQLkèo bóng đá cúp c2 chủ.
Trong khi cân bằng tải ngẫu nhiên, do bản chất ngẫu nhiên của nó, hầu như sẽ không bao giờ dẫn đến phân phối hoàn toàn đồng đều, nó thống kê khá gần. Một khía cạnh quan trọng ở đây là thuật toán này sử dụng hai cấp độ lựa chọn ngẫu nhiên: đầu tiên kèo bóng đá cúp c2 máy chủ sẽ được giải quyết theo thứ tự ngẫu nhiên.
Khi sử dụng giá trị này, bạn nên định cấu hình giá trị hợp lý choConnect_Timeout. Bởi vì sau đó, nếu một trong kèo bóng đá cúp c2 nút được sử dụng để cân bằng tải không phản hồi, một nút mới sẽ được thử.
Nếu bạn thấy bất cứ điều gì trong tài liệu kèo bóng đá cúp c2 chính xác, kèo bóng đá cúp c2 khớpMẫu nàyĐể báo cáo vấn đề tài liệu.