Phần này mô tả cách bạn có thể xử lý các điều kiện và cảnh báo đặc biệt trong chương trình kèo bóng đá c1 nhúng. Có hai cơ sở không có kết luận cho việc này.
Bất cứ khi nàolệnh.SQLCABiến.Một phương pháp đơn giản để bắt kèo bóng đá c1 và cảnh báo là đặt một hành động cụ thể được thực thi bất cứ khi nào một điều kiện cụ thể xảy ra. Nói chung:
EXEC kèo bóng đá c1 bất cứ khi nàođiều kiệnHành động;
điều kiệncó thể là kèo bóng đá c1 trong những điều sau:
SQLERROR #Hành động được chỉ định được gọi bất cứ khi nào xảy ra kèo bóng đá c1 trong quá trình thực hiện câu lệnh SQL.
sqlwarning #Hành động được chỉ định được gọi bất cứ khi nào cảnh báo xảy ra trong quá trình thực hiện câu lệnh kèo bóng đá c1.
Không tìm thấy #Hành động được chỉ định được gọi bất cứ khi nào một câu lệnh SQL truy xuất hoặc ảnh hưởng đến các hàng bằng không. (Điều kiện này không phải là kèo bóng đá c1, nhưng bạn có thể quan tâm đến việc xử lý nó đặc biệt.)
Hành độngcó thể là kèo bóng đá c1 trong những điều sau:
Tiếp tục #Điều này có nghĩa là điều kiện bị bỏ qua. Đây là mặc định.
Gotonhãnđi đếnnhãn #Nhảy vào nhãn được chỉ định (sử dụng CGotocâu lệnh).
SQLPrint #In một thông báo ra kèo bóng đá c1 tiêu chuẩn. Điều này rất hữu ích cho các chương trình đơn giản hoặc trong quá trình tạo mẫu.
Dừng #gọiThoát (1), sẽ chấm dứt chương trình.
do break #Thực hiện câu lệnh CBreak. Điều này chỉ nên được sử dụng trong các vòng hoặcSwitchcâu lệnh.
DO Tiếp tục #Thực hiện câu lệnh CTiếp tục. Điều này chỉ nên được sử dụng trong các câu lệnh Loops.
gọitên(args)dotên(args) #Gọi các hàm C được chỉ định với các đối số được chỉ định. (Việc sử dụng này khác với ý nghĩa củagọivàdoTrong ngữ pháp PostgreSQL bình thường.)
Tiêu chuẩn kèo bóng đá c1 chỉ cung cấp cho các hành độngTiếp tụcvàGoto(vàđi đến).
Đây là một ví dụ mà bạn có thể muốn sử dụng trong một chương trình đơn giản. Nó in một thông báo đơn giản khi cảnh báo xảy ra và hủy bỏ chương trình khi xảy ra kèo bóng đá c1:
EXEC kèo bóng đá c1 bất cứ khi nào sqlwarning sqlPrint;
câu lệnhEXEC kèo bóng đá c1 bất cứ khi nàolà một chỉ thị của bộ tiền xử lý SQL, không phải là một tuyên bố C. Các hành động cảnh báo hoặc kèo bóng đá c1 mà nó đặt ra áp dụng cho tất cả các câu lệnh SQL được nhúng xuất hiện bên dưới điểm đặt trình xử lý, trừ khi một hành động khác được đặt cho cùng một điều kiện giữa lần đầu tiênEXEC kèo bóng đá c1 bất cứ khi nàovà câu lệnh kèo bóng đá c1 gây ra điều kiện, bất kể dòng điều khiển trong chương trình C. Vì vậy, cả hai trong hai trích đoạn chương trình C sau đây sẽ có hiệu ứng mong muốn:
/*
/*
Để xử lý kèo bóng đá c1 mạnh hơn, giao diện SQL được nhúng cung cấp một biến toàn cầu với tênSQLCA(khu vực giao tiếp kèo bóng đá c1) có cấu trúc sau:
Cấu trúc
(Trong kèo bóng đá c1 chương trình đa luồng, mỗi luồng tự động có được bản sao của riêng mìnhSQLCA. Điều này hoạt động tương tự như việc xử lý biến C toàn cầu C tiêu chuẩnerrno.)
SQLCABao gồm cả cảnh báo và kèo bóng đá c1. Nếu nhiều cảnh báo hoặc kèo bóng đá c1 xảy ra trong quá trình thực hiện một câu lệnh, thìSQLCAsẽ chỉ chứa thông tin về thông tin cuối cùng.
Nếu không có kèo bóng đá c1 xảy ra trong lần cuốikèo bóng đá c1tuyên bố,sqlca.sqlcodesẽ là 0 vàSQLCA.SQLSTATEsẽ là"00000". Nếu cảnh báo hoặc kèo bóng đá c1 xảy ra, thìsqlca.sqlcodesẽ âm vàSQLCA.SQLSTATEsẽ khác với"00000". kèo bóng đá c1 tích cựcsqlca.sqlcodeCho biết kèo bóng đá c1 điều kiện vô hại, chẳng hạn như truy vấn cuối cùng được trả về hàng không.SQLCodevàSQLSTATElà hai sơ đồ mã kèo bóng đá c1 khác nhau; Chi tiết xuất hiện bên dưới.
Nếu câu lệnh kèo bóng đá c1 cuối cùng thành công, thìsqlca.sqlerrd [1]Chứa OID của hàng đã xử lý, nếu có vàsqlca.sqlerrd [2]Chứa số lượng hàng được xử lý hoặc trả lại, nếu có thể áp dụng cho lệnh.
Trong trường hợp có kèo bóng đá c1 hoặc cảnh báo,sqlca.sqlerrm.sqlerrmcsẽ chứa một chuỗi mô tả kèo bóng đá c1. Trườngsqlca.sqlerrm.sqlerrmlchứa độ dài của thông báo kèo bóng đá c1 được lưu trữ trongsqlca.sqlerrm.sqlerrmc(kết quả củastrlen (), không thực sự thú vị cho kèo bóng đá c1 lập trình viên C). Lưu ý rằng kèo bóng đá c1 số tin nhắn quá dài để phù hợp với kích thước cố địnhSQLERRMCmảng; Họ sẽ bị cắt ngắn.
Trong trường hợp cảnh báo,sqlca.sqlwarn [2]được đặt thànhW. (Trong tất cả các trường hợp khác, nó được đặt thành kèo bóng đá c1 cái gì đó khác vớiW.) Nếusqlca.sqlwarn [1]được đặt thànhW, thì kèo bóng đá c1 giá trị đã bị cắt ngắn khi nó được lưu trữ trong kèo bóng đá c1 biến máy chủ.sqlca.sqlwarn [0]được đặt thànhWNếu bất kỳ yếu tố nào khác được đặt để chỉ ra cảnh báo.
Các trườngSQLCAID, SQLABC, SQLERRPvà các yếu tố còn lại củaSQLERRDvàSQLWARNHiện không chứa thông tin hữu ích.
Cấu trúcSQLCAkhông được xác định trong tiêu chuẩn SQL, nhưng được triển khai trong kèo bóng đá c1 số hệ thống cơ sở dữ liệu SQL khác. Các định nghĩa tương tự như cốt lõi, nhưng nếu bạn muốn viết các ứng dụng di động, thì bạn nên điều tra các triển khai khác nhau kèo bóng đá c1 cách cẩn thận.
Đây là kèo bóng đá c1 ví dụ kết hợp việc sử dụngBất cứ khi nàovàSQLCA, In nội dung củaSQLCAKhi xảy ra kèo bóng đá c1. Điều này có lẽ hữu ích cho các ứng dụng gỡ kèo bóng đá c1 hoặc tạo mẫu, trước khi cài đặt thêmHồithân thiện với người dùngxử lý kèo bóng đá c1.
EXEC kèo bóng đá c1 bất cứ khi nào sqlerror gọi print_sqlca ();
Kết quả có thể trông như sau (ở đây là kèo bóng đá c1 do tên bảng sai):
==== SQLCA ====
SQLSTATEvs.SQLCode #Các trườngSQLCA.SQLSTATEvàsqlca.sqlcodelà hai sơ đồ khác nhau cung cấp mã kèo bóng đá c1. Cả hai đều có nguồn gốc từ tiêu chuẩn SQL, nhưngSQLCodeđã được đánh dấu không dùng nữa trong Phiên bản kèo bóng đá c1-92 của tiêu chuẩn và đã bị loại bỏ trong các phiên bản sau. Do đó, các ứng dụng mới được khuyến khích sử dụngSQLSTATE.
SQLSTATElà một mảng năm ký tự. Năm ký tự chứa các chữ số hoặc các chữ cái trong trường hợp biểu diễn các mã của các điều kiện cảnh báo và kèo bóng đá c1 khác nhau.SQLSTATECó sơ đồ phân cấp: Hai ký tự đầu tiên chỉ ra lớp chung của điều kiện, ba ký tự cuối cùng chỉ ra kèo bóng đá c1 lớp con của điều kiện chung. Trạng thái thành công được biểu thị bằng mã00000. TheSQLSTATEMã dành cho hầu hết các phần được xác định trong tiêu chuẩn kèo bóng đá c1. ThePostgreSQLMáy chủ tự nhiênSQLSTATEMã kèo bóng đá c1; Do đó, mức độ nhất quán cao có thể đạt được bằng cách sử dụng sơ đồ mã kèo bóng đá c1 này trong tất cả các ứng dụng.Phụ lục A.
SQLCode, Sơ đồ mã kèo bóng đá c1 không dùng nữa, là một số nguyên đơn giản. Giá trị 0 biểu thị thành công, giá trị dương cho thấy thành công với thông tin bổ sung, giá trị âm cho biết kèo bóng đá c1.PostgreSQLđã gán kèo bóng đá c1 số cụ thểSQLCodeGiá trị cho việc sử dụng của nó, được liệt kê dưới đây với giá trị số và tên biểu tượng của chúng. Hãy nhớ rằng đây không phải là di động cho các triển khai kèo bóng đá c1 khác.SQLSTATESơ đồ, tương ứngSQLSTATEcũng được liệt kê. Tuy nhiên, không có bản đồ kèo bóng đá c1-kèo bóng đá c1 hoặc kèo bóng đá c1-nhiều giữa hai sơ đồ (thực sự là nhiều-nhiều), vì vậy bạn nên tham khảo toàn cầuSQLSTATELiệt kê trongPhụ lục ATrong mỗi trường hợp.
Đây là những người được chỉ địnhSQLCodeGiá trị:
ECPG_NO_ERROR) #Cho biết không có kèo bóng đá c1. (SQLSTATE 00000)
ECPG_NOT_FOUND) #Đây là kèo bóng đá c1 điều kiện vô hại chỉ ra rằng lệnh cuối cùng được truy xuất hoặc xử lý các hàng bằng không, hoặc bạn đang ở cuối con trỏ. (SQLSTATE 02000)
Khi xử lý con trỏ trong vòng lặp, bạn có thể sử dụng mã này như kèo bóng đá c1 cách để phát hiện khi nào để hủy bỏ vòng lặp, như thế này:
WHER (1)
nhưngBất cứ khi nào không tìm thấy, hãy phá vỡThực hiện hiệu quả điều này trong nội bộ, vì vậy thường không có lợi thế trong việc viết điều này kèo bóng đá c1 cách rõ ràng.
ECPG_OUT_OF_MEMORY) #Cho biết bộ nhớ ảo của bạn đã cạn kiệt. Giá trị số được xác định là-enomem. (Sqlstate ye001)
ECPG_UNSUPPORTED) #Cho biết bộ tiền xử lý đã tạo ra kèo bóng đá c1 cái gì đó mà thư viện không biết. Có lẽ bạn đang chạy các phiên bản không tương thích của bộ tiền xử lý và thư viện.
ECPG_TOO_MANY_ARGUMENT) #Điều này có nghĩa là lệnh chỉ định nhiều biến máy chủ hơn lệnh dự kiến. (SQLSTATE 07001 hoặc 07002)
ECPG_TOO_FEW_ARGUMENT) #Điều này có nghĩa là lệnh chỉ định ít biến máy chủ hơn so với lệnh dự kiến. (SQLSTATE 07001 hoặc 07002)
ECPG_TOO_MANY_MATCHES) #Điều này có nghĩa là kèo bóng đá c1 truy vấn đã trả về nhiều hàng nhưng câu lệnh chỉ được chuẩn bị để lưu trữ kèo bóng đá c1 hàng kết quả (ví dụ: vì các biến được chỉ định không phải là mảng). (SQLSTATE 21000)
ECPG_INT_FORMAT) #Biến máy chủ thuộc loạiintvà mốc thời gian trong cơ sở dữ liệu thuộc loại khác và chứa kèo bóng đá c1 giá trị không thể được hiểu làint. Thư viện sử dụngstrtol ()Đối với chuyển đổi này. (SQLSTATE 42804)
ECPG_UINT_FORMAT) #Biến máy chủ thuộc loạiunsign intvà mốc thời gian trong cơ sở dữ liệu thuộc loại khác và chứa kèo bóng đá c1 giá trị không thể được hiểu làunsign int. Thư viện sử dụngstrtoul ()Đối với chuyển đổi này. (SQLSTATE 42804)
ECPG_FLOAT_FORMAT) #Biến máy chủ thuộc loạifloatvà mốc dữ liệu trong cơ sở dữ liệu thuộc loại khác và chứa kèo bóng đá c1 giá trị không thể được hiểu làfloat. Thư viện sử dụngstrtod ()Đối với chuyển đổi này. (SQLSTATE 42804)
ECPG_NUMERIC_FORMAT) #Biến máy chủ thuộc loạiSốvà mốc dữ liệu trong cơ sở dữ liệu thuộc loại khác và chứa kèo bóng đá c1 giá trị không thể được hiểu làSốGiá trị. (SQLSTATE 42804)
ECPG_interval_format) #Biến máy chủ thuộc loạiKhoảngvà mốc dữ liệu trong cơ sở dữ liệu thuộc loại khác và chứa kèo bóng đá c1 giá trị không thể được hiểu làKhoảngGiá trị. (SQLSTATE 42804)
ECPG_DATE_FORMAT) #Biến máy chủ thuộc loạingàyvà mốc thời gian trong cơ sở dữ liệu thuộc loại khác và chứa kèo bóng đá c1 giá trị không thể được hiểu làngàyGiá trị. (SQLSTATE 42804)
ECPG_TIMESTAMP_FORMAT) #Biến máy chủ thuộc loạiTimestampvà mốc dữ liệu trong cơ sở dữ liệu thuộc loại khác và chứa kèo bóng đá c1 giá trị không thể được hiểu làDấu thời gianGiá trị. (SQLSTATE 42804)
ECPG_CONVERT_BOOL) #Điều này có nghĩa là biến máy chủ thuộc loạiboolvà mốc thời gian trong cơ sở dữ liệu không phải là'T'Nor'F'. (SQLSTATE 42804)
ECPG_EMPTY) #Câu lệnh được gửi đếnPostgreSQLMáy chủ trống. (Điều này thường không thể xảy ra trong một chương trình SQL nhúng, vì vậy nó có thể chỉ ra một kèo bóng đá c1 nội bộ.)
ECPG_MISSING_INDICATOR) #Giá trị null đã được trả về và không có biến chỉ báo null nào được cung cấp. (SQLSTATE 22002)
ECPG_NO_ARRAY) #kèo bóng đá c1 biến thông thường đã được sử dụng ở kèo bóng đá c1 nơi yêu cầu kèo bóng đá c1 mảng. (SQLSTATE 42804)
ECPG_DATA_NOT_ARRAY) #Cơ sở dữ liệu đã trả về kèo bóng đá c1 biến thông thường ở kèo bóng đá c1 nơi yêu cầu giá trị mảng. (SQLSTATE 42804)
ECPG_ARRAY_INSERT) #Giá trị không thể được chèn vào mảng. (SQLSTATE 42804)
ECPG_NO_CONN) #Chương trình đã cố gắng truy cập kèo bóng đá c1 kết nối không tồn tại. (SQLSTATE 08003)
ECPG_NOT_CONN) #Chương trình đã cố gắng truy cập một kết nối tồn tại nhưng không mở. (Đây là một kèo bóng đá c1 nội bộ.) (SQLSTATE YE002)
ECPG_INVALID_STMT) #Câu lệnh bạn đang cố gắng sử dụng chưa được chuẩn bị. (SQLSTATE 26000)
ECPG_Informix_Duplicate_Key) #kèo bóng đá c1 chính trùng lặp, vi phạm các ràng buộc duy nhất (chế độ tương thích thông tin). (SQLSTATE 23505)
ecpg_unknown_descriptor) #Mô tả được chỉ định không được tìm thấy. Tuyên bố bạn đang cố gắng sử dụng chưa được chuẩn bị.
ECPG_INVALID_DESCRIPTOR_INDEX) #Chỉ số mô tả được chỉ định nằm ngoài phạm vi. (SQLSTATE 07009)
ECPG_UNKNOWN_DESCRIPTOR_ITEM) #Một mục mô tả không hợp lệ đã được yêu cầu. (Đây là một kèo bóng đá c1 nội bộ.) (SQLSTATE YE002)
ECPG_VAR_NOT_NUMERIC) #Trong quá trình thực hiện kèo bóng đá c1 câu lệnh động, cơ sở dữ liệu đã trả về kèo bóng đá c1 giá trị số và biến máy chủ không phải là số. (SQLSTATE 07006)
ECPG_VAR_NOT_CHAR) #Trong quá trình thực hiện kèo bóng đá c1 câu lệnh động, cơ sở dữ liệu đã trả về kèo bóng đá c1 giá trị không phải là số và biến máy chủ là số. (SQLSTATE 07006)
ECPG_INFORMIX_SUBSELECT_NOT_ONE) #Kết quả của trình điều khiển con không phải là kèo bóng đá c1 hàng duy nhất (chế độ tương thích thông tin). (SQLSTATE 21000)
ECPG_PGSQL) #Một số kèo bóng đá c1 gây ra bởiPOSTGRESQLMáy chủ. Thông báo chứa thông báo kèo bóng đá c1 từPOSTGRESQLMáy chủ.
ECPG_TRANS) #ThePOSTGRESQLMáy chủ báo hiệu rằng chúng tôi không thể bắt đầu, cam kết hoặc cuộn lại giao dịch. (SQLSTATE 08007)
ECPG_CONNECT) #Kết nối cố gắng đến cơ sở dữ liệu không thành công. (SQLSTATE 08001)
ECPG_Duplicate_Key) #kèo bóng đá c1 chính trùng lặp, vi phạm ràng buộc duy nhất. (SQLSTATE 23505)
ECPG_SUBSELECT_NOT_ONE) #Kết quả cho trình điều khiển con không phải là hàng đơn. (SQLSTATE 21000)
ECPG_WARNING_UNKNOWN_PORTAL) #Tên con trỏ không hợp lệ đã được chỉ định. (SQLSTATE 34000)
ECPG_WARNING_IN_TRANSACTION) #Giao dịch đang được tiến hành. (SQLSTATE 25001)
ecpg_warning_no_transaction) #Không có giao dịch hoạt động (đang tiến hành). (SQLSTATE 25P01)
ECPG_WARNING_PORTAL_EXISTS) #Tên con trỏ hiện có đã được chỉ định. (SQLSTATE 42P03)
Nếu bạn thấy bất cứ điều gì trong tài liệu không chính xác, không khớpMẫu nàyĐể báo cáo vấn đề tài liệu.