tỷ lệ kèo bóng đá, cảnh báo và tin nhắn nhật ký được tạo trong mã máy chủ phải được tạo bằngEREPORThoặc anh em họ cũ của nóELOG11194_11269
Có hai yếu tố bắt buộc cho mỗi thông điệp: mức độ nghiêm trọng (từDebugđếnPanic, được xác định tỷ lệ kèo bóng đáSRC/bao gồm/UTILS/ELOG.H) và một văn bản tin nhắn chính. Ngoài ra, có các yếu tố tùy chọn, trong số đó phổ biến nhất là mã định danh tỷ lệ kèo bóng đá tuân theo các quy ước SQLState của SQL Spec.EREPORTBản thân nó chỉ là một macro shell tồn tại chủ yếu để thuận tiện cho cú pháp để tạo ra thông báo trông giống như một cuộc gọi chức năng duy nhất tỷ lệ kèo bóng đá mã nguồn C. Tham số duy nhất được chấp nhận trực tiếp bởiEREPORTlà mức độ nghiêm trọng. Văn bản tin nhắn chính và bất kỳ yếu tố tin nhắn tùy chọn nào được tạo bằng cách gọi các chức năng phụ trợ, chẳng hạn nhưerrmsg, tỷ lệ kèo bóng đáEREPORTcuộc gọi.
Một cuộc gọi điển hình đếnEREPORTCó thể trông như thế này:
EREPORT (tỷ lệ kèo bóng đá,
errcode (errcode_division_by_zero),
errmsg ("Division by Zero"));
Điều này chỉ định mức độ nghiêm trọng của tỷ lệ kèo bóng đáERROR(tỷ lệ kèo bóng đá chạy của nhà máy). Theerrcodecuộc gọi Chỉ định mã tỷ lệ kèo bóng đá SQLSTATE bằng cách sử dụng macro được xác định trong12635_12665. Theerrmsgcuộc gọi cung cấp văn bản tin nhắn chính.
Bạn cũng sẽ thường xuyên thấy kiểu cũ hơn này, với một bộ dấu ngoặc đơn xung quanh các cuộc gọi chức năng phụ trợ:
EREPORT (tỷ lệ kèo bóng đá,
(errcode (errcode_division_by_zero),
errmsg ("Division by Zero")));
dấu ngoặc đơn được yêu cầu trướcPostgreSQLPhiên bản 12, nhưng bây giờ là tùy chọn.
Đây là một ví dụ phức tạp hơn:
EREPORT (tỷ lệ kèo bóng đá,
errcode (errcode_ambiguter_function),
errmsg ("hàm %s không phải là duy nhất",
func_signature_string (funcname, nargs,
Nil, thực tế_arg_types)),
Errhint ("Không thể chọn chức năng ứng cử viên tốt nhất."
"Bạn có thể cần thêm typecasts rõ ràng."));
Điều này minh họa việc sử dụng mã định dạng để nhúng các giá trị thời gian chạy vào một văn bản tin nhắn. Ngoài ra, một tùy chọnMạnhGợi ýHồiTin nhắn được cung cấp. Các cuộc gọi chức năng phụ trợ có thể được viết theo bất kỳ thứ tự nào, nhưng thông thườngerrcodevàerrmsgxuất hiện đầu tiên.
Nếu mức độ nghiêm trọng làERRORhoặc cao hơn,EREPORTHủy bỏ thực thi truy vấn hiện tại và không trả lại cho người gọi. Nếu mức độ nghiêm trọng thấp hơnERROR, EREPORTTrả về bình thường.
Các thói quen phụ trợ có sẵn choEREPORTlà:
errcode (sqlerrcode)Chỉ định mã định danh tỷ lệ kèo bóng đá SQLSTATE cho điều kiện. Nếu thói quen này không được gọi, định danh tỷ lệ kèo bóng đá mặc định làerrCode_Internal_errorKhi mức độ nghiêm trọng của tỷ lệ kèo bóng đá làERROR14779_14793errcode_warningKhi mức tỷ lệ kèo bóng đá làcảnh báo, nếu không (choThông báovà bên dưới)errCode_successful_completion. Mặc dù các mặc định này thường thuận tiện, luôn luôn nghĩ liệu chúng có phù hợp hay không trước khi bỏ quaerrcode ()cuộc gọi.
errmsg (const char *msg, ...)Chỉ định văn bản thông báo tỷ lệ kèo bóng đá chính và có thể các giá trị thời gian chạy để chèn vào nó. Chèn được chỉ định bởiSprintf15440_15516Sprintf, Mã định dạng%mCó thể được sử dụng để chèn thông báo tỷ lệ kèo bóng đá được trả về bởiStrerrorĐối với giá trị hiện tại củaerrno. [16] %mKhông yêu cầu bất kỳ mục nhập tương ứng nào tỷ lệ kèo bóng đá danh sách tham số choerrmsg16008_16061GetTextĐể bản địa hóa có thể trước khi mã định dạng được xử lý.
errmsg_Internal (const char *msg, ...)giống nhưerrmsg, ngoại trừ chuỗi tin nhắn sẽ không được dịch cũng như không được bao gồm tỷ lệ kèo bóng đá từ điển thông điệp quốc tế hóa. Điều này nên được sử dụng chokhông thể xảy raCác trường hợp có lẽ không đáng để sử dụng nỗ lực dịch thuật trên.
16688_16775giống nhưerrmsg, nhưng với sự hỗ trợ cho các dạng số nhiều khác nhau của thông điệp.fmt_singularlà định dạng số ít tiếng Anh,fmt_plurallà định dạng số nhiều tiếng Anh,nlà giá trị số nguyên xác định dạng số nhiều là cần thiết và các đối số còn lại được định dạng theo chuỗi định dạng đã chọn. Để biết thêm thông tin, xemPhần 55.2.2.
errdetail (const char *msg, ...)cung cấp tùy chọnHồichi tiếtTin nhắn; Điều này sẽ được sử dụng khi có thêm thông tin có vẻ không phù hợp để đưa vào thông điệp chính. Chuỗi thông báo được xử lý theo cách tương tự như đối vớierrmsg.
errdetail_Internal (const char *msg, ...)giống nhưerrdetail, ngoại trừ chuỗi tin nhắn sẽ không được dịch cũng như không được bao gồm tỷ lệ kèo bóng đá từ điển thông điệp quốc tế hóa. Điều này nên được sử dụng cho các thông điệp chi tiết không đáng để sử dụng nỗ lực dịch thuật, vì chúng quá kỹ thuật để có ích cho hầu hết người dùng.
18363_18453giống nhưerrdetail, nhưng với sự hỗ trợ cho các hình thức số nhiều khác nhau của thông điệp. Để biết thêm thông tin, xemPhần 55.2.2.
errdetail_log (const char *msg, ...)giống nhưerrdetailNgoại trừ chuỗi này chỉ đi đến nhật ký tỷ lệ kèo bóng đá chủ, không bao giờ với tỷ lệ kèo bóng đá khách. Nếu cả haierrdetail(hoặc một tỷ lệ kèo bóng đá những tương đương của nó ở trên) vàerrdetail_logđược sử dụng sau đó một chuỗi đi đến máy khách và chuỗi kia vào nhật ký. Điều này rất hữu ích cho các chi tiết tỷ lệ kèo bóng đá quá nhạy cảm với bảo mật hoặc quá cồng kềnh để đưa vào báo cáo được gửi đến máy khách.
19373_19467giống nhưerrdetail_log, nhưng với sự hỗ trợ cho các hình thức số nhiều khác nhau của thông điệp. Để biết thêm thông tin, xemPhần 55.2.2.
errhint (const char *msg, ...)Cung cấp tùy chọngợi ýxôngTin nhắn; Điều này sẽ được sử dụng khi đưa ra các đề xuất về cách khắc phục vấn đề, trái ngược với các chi tiết thực tế về những gì đã sai. Chuỗi thông báo được xử lý theo cách tương tự như đối vớierrmsg.
20250_20338giống nhưerrhint, nhưng với sự hỗ trợ cho các hình thức số nhiều khác nhau của thông điệp. Để biết thêm thông tin, xemPhần 55.2.2.
errcontext (const char *msg, ...)Thông thường không được gọi trực tiếp từEREPORTTrang web tin nhắn; đúng hơn là nó được sử dụng tỷ lệ kèo bóng đáERROR_CONTEXT_STACKCác chức năng gọi lại để cung cấp thông tin về bối cảnh xảy ra tỷ lệ kèo bóng đá, chẳng hạn như vị trí hiện tại trong hàm PL. Chuỗi thông báo được xử lý theo cách tương tự như đối vớierrmsg. Không giống như các chức năng phụ trợ khác, điều này có thể được gọi nhiều hơn một lần mỗiEREPORTcuộc gọi; Do đó, các chuỗi liên tiếp được cung cấp được kết hợp với việc tách các dòng mới.
errPocation (int cursorpos)21429_21611
errtable (quan hệ rel)Chỉ định một mối quan hệ có tên và tên lược đồ nên được đưa vào dưới dạng các trường phụ trong báo cáo tỷ lệ kèo bóng đá.
21904_21943Chỉ định một cột có tên, tên bảng và tên lược đồ nên được đưa vào dưới dạng các trường phụ trợ trong báo cáo tỷ lệ kèo bóng đá.
errTableConstraint (quan hệ rel, const char *Conname)Chỉ định một ràng buộc bảng có tên, tên bảng và tên lược đồ nên được đưa vào làm các trường phụ trong báo cáo tỷ lệ kèo bóng đá. Các chỉ mục nên được coi là ràng buộc cho mục đích này, cho dù chúng có liên quan hay khôngPG_Constraintmục nhập. Cẩn thận vượt qua mối quan hệ heap cơ bản, không phải chính chỉ mục, nhưrel.
errdatatype (oid datatypeoid)Chỉ định loại dữ liệu có tên và tên lược đồ nên được đưa vào dưới dạng các trường phụ trong báo cáo tỷ lệ kèo bóng đá.
22902_2296122966_23099
errcode_for_file_access ()là một hàm tiện lợi chọn một định danh lỗi SQLState thích hợp cho tỷ lệ kèo bóng đá cuộc gọi hệ thống liên quan đến truy cập tệp. Nó sử dụng đã lưuerrnoĐể xác định mã tỷ lệ kèo bóng đá nào sẽ tạo. Thông thường, điều này nên được sử dụng kết hợp với%MTrong văn bản thông báo tỷ lệ kèo bóng đá chính.
errcode_for_socket_access ()23664_23793
errHidestMt (bool hid_stmt)Có thể được gọi để chỉ định việc đàn ápTuyên bố:Phần của một tin nhắn tỷ lệ kèo bóng đá nhật ký Postmaster. Nói chung, điều này là phù hợp nếu văn bản tin nhắn bao gồm câu lệnh hiện tại.
errHidecontext (bool hid_ctx)Có thể được gọi để chỉ định sự đàn ápbối cảnh:Phần của một tin nhắn trong nhật ký Postmaster. Điều này chỉ nên được sử dụng cho các thông báo gỡ tỷ lệ kèo bóng đá dài dòng trong đó việc bao gồm ngữ cảnh lặp đi lặp lại sẽ làm mờ nhật ký quá nhiều.
nhiều nhất là một tỷ lệ kèo bóng đá các chức năngerrTable, errTableCol, errTableConstraint, errdatatypehoặcErrdomainConstraintnên được sử dụng tỷ lệ kèo bóng đá mộtEREPORT24901_25242PostgreSQL9.3, phạm vi bảo hiểm hoàn chỉnh chỉ tồn tại đối với các tỷ lệ kèo bóng đá lớp 23 (vi phạm ràng buộc toàn vẹn), nhưng điều này có thể được mở rộng trong tương lai.
Có một hàm cũELOGĐiều đó vẫn được sử dụng rất nhiều. MỘTELOGcuộc gọi:
ELOG (cấp, "Chuỗi định dạng", ...);
hoàn toàn tương đương với:
25724_25782
Lưu ý rằng mã tỷ lệ kèo bóng đá SQLSTATE luôn được mặc định và chuỗi tin nhắn không phải là dịch. Vì thế,ELOGChỉ nên được sử dụng cho các tỷ lệ kèo bóng đá nội bộ và ghi nhật ký gỡ tỷ lệ kèo bóng đá cấp thấp. Bất kỳ thông điệp nào có khả năng được người dùng thông thường quan tâm nên đi quaEREPORT. Tuy nhiên, có đủ nội bộkhông thể xảy raKiểm tra tỷ lệ kèo bóng đá hệ thốngELOGvẫn được sử dụng rộng rãi; nó được ưa thích cho những tin nhắn đó vì sự đơn giản của nó.
Lời khuyên về việc viết các thông báo tỷ lệ kèo bóng đá tốt có thể được tìm thấy trongPhần 54.3.
[16]nghĩa là giá trị hiện tại khiEREPORTCuộc gọi đã đạt được; thay đổi củaerrnotỷ lệ kèo bóng đá các thói quen báo cáo phụ trợ sẽ không ảnh hưởng đến nó. Điều đó sẽ không đúng nếu bạn viếtStrerror (errno)rõ ràng tỷ lệ kèo bóng đáerrmsgdanh sách tham số; Theo đó, không làm như vậy.
Nếu bạn thấy bất cứ điều gì tỷ lệ kèo bóng đá 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 năng cụ thể hoặc yêu cầu làm rõ thêm, Vui lòng sử dụngMẫu này28557_28621