46.2. Báo cáo tỷ lệ kèo bóng đá trong Máy chủ

11029_11123EREPORThoặc anh em họ cũ của nóELOG. Việc sử dụng chức năng này rất phức tạp đủ để yêu cầu một số giải thích.

Có hai yếu tố bắt buộc cho mỗi thông báo: Mức độ nghiêm trọng Cấp độ (từDebugđếnPanic) 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, phổ biến nhất là tỷ lệ kèo bóng đá Mã định danh tuân theo các quy ước SQLState của SQL Spec.EREPORTBản thân nó chỉ là một vỏ chức năng, tồn tại chủ yếu để thuận tiện cho cú pháp của Làm cho việc tạo tin nhắn trông giống như một cuộc gọi chức năng tỷ lệ kèo bóng đá c Mã nguồn. Tham số duy nhất được chấp nhận trực tiếp bởiEREPORTlà mức độ nghiêm trọng. Chính văn bản tin nhắn và bất kỳ yếu tố tin nhắn tùy chọn nào được tạo bởi Gọi các chức năng phụ trợ, chẳng hạn nhưerrmsg, tỷ lệ kèo bóng đáEREPORTCALL.

Một cuộc gọi điển hình đếnEREPORTcó thể trông giố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(một tỷ lệ kèo bóng đá chạy bộ). Theerrcodecuộc gọi Chỉ định mã tỷ lệ kèo bóng đá SQLSTATE Sử dụng một macro được xác định trongsrc/bao gồm/utils/errcodes.h. Theerrmsgcuộc gọi cung cấp văn bản tin nhắn chính. Chú ý tập hợp thêm các dấu ngoặc đơn xung quanh phụ trợ Các cuộc gọi chức năng - Đây là những khó chịu nhưng về mặt cú pháp cần thiết.

Đâ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,
                                      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 thời gian chạy giá trị thành một văn bản tin nhắn. Ngoài ra, một tùy chọn"Gợi ý"Tin nhắn được cung cấp.

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 tình trạng. Nếu thói quen này không được gọi, tỷ lệ kèo bóng đá định danh mặc định làerrCode_Internal_errorKhi mức độ nghiêm trọng của tỷ lệ kèo bóng đá Cấp độERRORhoặc cao hơn,errcode_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. tỷ lệ kèo bóng đá khi những điều này mặc định thường thuận tiện, luôn luôn nghĩ rằng họ có phải là thích hợp 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ể giá trị thời gian chạy để chèn vào nó. Chèn được chỉ định quaSprintf-Style Mã định dạng. Ngoài các mã định dạng tiêu chuẩn được chấp nhận bởiSprintf, Mã định dạng%Mcó thể được sử dụng để chèn tỷ lệ kèo bóng đá Tin nhắn được trả về bởiStrerrorĐối với giá trị hiện tại củaerrno. [1] %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ố choerrmsg. Lưu ý rằng chuỗi tin nhắn sẽ được chạy quaGetTextĐể bản địa hóa có thể Mã định dạng được xử lý.

• ...)giống nhưerrmsg, ngoại trừ chuỗi tin nhắn sẽ không được dịch cũng không được bao gồm tỷ lệ kèo bóng đá quốc tế hóa Từ điển tin nhắn. Điều này nên được sử dụng cho"Không thể xảy ra"trường hợp có lẽ không Đáng giá để sử dụng nỗ lực dịch trên.

• errdetail (const char *msg, ...)Cung cấp tùy chọn"Chi tiết"Tin 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 với đặt vào thông điệp chính. Chuỗi tin nhắn được xử lý theo cách tương tự như choerrmsg.

• errhint (const char *msg, ...)cung cấp tùy chọn"Gợi ý"Tin nhắn; Điều này sẽ được sử dụng khi đưa ra đề xuất về cách khắc phục sự cố, trái ngược để chi tiết thực tế về những gì đã sai. Chuỗi tin nhắn được xử lý theo cách tương tự nhưerrmsg.

• 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ề ngữ cảnh trong đó xảy ra tỷ lệ kèo bóng đá, chẳng hạn như vị trí hiện tại trong một Hàm PL. Chuỗi tin nhắn được xử lý chỉ giống nhau Cách như choerrmsg. 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; các do đó các chuỗi liên tiếp được cung cấp được kết hợp với Tách Newline.

• errPocation (int cursorpos)Chỉ định vị trí văn bản của tỷ lệ kèo bóng đá trong truy vấn sợi dây. Hiện tại nó chỉ hữu ích cho các tỷ lệ kèo bóng đá được phát hiện trong các giai đoạn phân tích từ vựng và cú pháp của truy vấn xử lý.

• errcode_for_file_access ()IS một chức năng thuận tiện chọn một sqlstate thích hợp Mã định danh tỷ lệ kèo bóng đá cho tỷ lệ kèo bóng đá trong truy cập tệp liên quan đến truy cập tệp cuộc gọi hệ thống. Nó sử dụng đã lưuerrnoĐể xác định mã tỷ lệ kèo bóng đá nào sẽ tạo. Thường là đ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 ()là một hàm tiện lợi để chọn một Định danh tỷ lệ kèo bóng đá SQLSTATE cho tỷ lệ kèo bóng đá liên quan đến ổ cắm cuộc gọi hệ thống.

• errHidestMt (bool hid_stmt)18471_18524tuyên bố:phần của 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 tin nhắn văn bản bao gồm câu lệnh hiện tại.

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:

19020_19080

19091_19219ELOGChỉ nên sử dụng 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 báo nào là có khả năng được người dùng thông thường quan tâmEREPORT. Tuy nhiên, có đủ nội bộ"Không thể xảy ra"tỷ lệ kèo bóng đá kiểm tra trong hệ thống19588_1959419599_19693

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 46.3.