Cấu trúc điều cách đọc kèo bóng đá có lẽ là phần hữu ích nhất (và quan trọng) củaPL/PGSQL. VớiPL/PGSQL12174_12218PostgreSQLDữ liệu theo cách rất linh hoạt và mạnh mẽ.
Có hai lệnh có sẵn cho phép bạn trả về dữ liệu từ cách đọc kèo bóng đá hàm:returnvàReturn Next.
returnreturnBiểu thức;
returnVới biểu thức chấm dứt hàm và trả về giá trị củaBiểu thứccho người gọi. Mẫu này được sử dụng choPL/PGSQLCác chức năng không trả về cách đọc kèo bóng đá bộ.
Trong cách đọc kèo bóng đá hàm trả về loại vô hướng, kết quả của biểu thức sẽ tự động được chuyển vào loại trả về của hàm như được mô tả cho các bài tập. Nhưng để trả về giá trị tổng hợp (hàng), bạn phải viết cách đọc kèo bóng đá biểu thức phân phối chính xác bộ cột được yêu cầu.
Nếu bạn khai báo chức năng với cách đọc kèo bóng đá tham số đầu ra, hãy viết chỉreturnKhông có biểu thức. cách đọc kèo bóng đá giá trị hiện tại của cách đọc kèo bóng đá biến tham số đầu ra sẽ được trả về.
Nếu bạn tuyên bố chức năng trả vềvoid, AreturnCâu lệnh có thể được sử dụng để thoát chức năng sớm; nhưng không viết cách đọc kèo bóng đá biểu thức saureturn.
Giá trị trả về của hàm không thể được xác định. Nếu điều cách đọc kèo bóng đá đạt đến phần cuối của khối cấp cao nhất của hàm mà không nhấn AreturnCâu lệnh, cách đọc kèo bóng đá lỗi thời gian chạy sẽ xảy ra. Hạn chế này không áp dụng cho các chức năng với các tham số đầu ra và các chức năng trả vềvoidTuy nhiên. Trong những trường hợp đóreturnCâu lệnh được tự động thực hiện nếu khối cấp cao nhất kết thúc.
cách đọc kèo bóng đá số ví dụ:
- cách đọc kèo bóng đá chức năng trả về loại vô hướng
Return NextvàTruy vấn trả vềReturn NextBiểu thức;Truy vấn;chuỗi lệnh[sử dụngBiểu thức[, ...]];
cách đọc kèo bóng đá APL/PGSQLHàm được tuyên bố trả lạisetof, Quy trình tuân theo là hơi khác nhau. Trong trường hợp đó, các mục riêng lẻ để trả lại được chỉ định bởi cách đọc kèo bóng đá chuỗianyypetrở lại tiếp theohoặcTruy vấn trả vềcách đọc kèo bóng đá lệnh, và sau đó là cuối cùngreturnLệnh không có đối số được sử dụng để chỉ ra rằng chức năng đã hoàn thành thực thi.Return Nextcó thể được sử dụng với cả cách đọc kèo bóng đá loại dữ liệu vô hướng và tổng hợp; với loại kết quả tổng hợp, toàn bộBảngcủa kết quả sẽ được trả về.Truy vấn trả lạiBổ số kết quả thực hiện truy vấn cho tập kết quả của hàm.Return NextvàTruy vấn trả vềcó thể được xen kẽ tự do trong cách đọc kèo bóng đá chức năng hoàn trả lại, trong trường hợp đó, kết quả của chúng sẽ được nối.
Return NextvàTruy vấn trả vềKhông thực sự quay lại từ hàm - chúng chỉ đơn giản là nối 0 hàng hoặc nhiều hàng vào tập kết quả của hàm. Thực thi sau đó tiếp tục với câu lệnh tiếp theo trongPL/PGSQLHàm. Như liên tiếpReturn NexthoặcTruy vấn trả vềCác lệnh được thực thi, tập kết quả được xây dựng. cách đọc kèo bóng đá cuối cùngreturn, không có đối số, khiến kiểm soát thoát khỏi hàm (hoặc bạn có thể chỉ để điều cách đọc kèo bóng đá đạt đến cuối hàm).
Truy vấn trả vềcó biến thểTruy vấn trả về, trong đó chỉ định truy vấn sẽ được thực thi động. Biểu thức tham số có thể được chèn vào chuỗi truy vấn được tính toán thông quaSử dụng, theo cách tương tự như trongthực thilệnh.
Nếu bạn khai báo chức năng với cách đọc kèo bóng đá tham số đầu ra, hãy viết chỉReturn NextKhông có biểu thức. Trên mỗi lần thực thi, các giá trị hiện tại của (các) biến tham số đầu ra sẽ được lưu để trả về cuối cùng như cách đọc kèo bóng đá hàng của kết quả.Setof Recordcách đọc kèo bóng đá có nhiều tham số đầu ra hoặcsetofcách đọc kèo bóng đá chỉ có một tham số đầu ra của loạiSOMEYPESOMEYPE, Để tạo chức năng hoàn trả lại với cách đọc kèo bóng đá tham số đầu ra.
Đây là cách đọc kèo bóng đá ví dụ về chức năng sử dụngReturn Next:
Tạo bảng foo (fooid int, foosubid int, fooname văn bản);
Đây là cách đọc kèo bóng đá ví dụ về chức năng sử dụngTruy vấn trả lại:
Tạo chức năng get_available_flightid (ngày) Trả về số nguyên setof AS
Việc triển khai hiện tại củatrở lại tiếp theovàTruy vấn trả lạilưu trữ toàn bộ tập kết quả trước cách đọc kèo bóng đá quay lại từ chức năng, như đã thảo luận ở trên. Điều đó có nghĩa là nếu mộtPL/PGSQLHàm tạo ra một tập kết quả rất lớn, hiệu suất có thể kém: Dữ liệu sẽ được ghi vào đĩa để tránh kiệt sức bộ nhớ, nhưng chính chức năng sẽ không quay lại cho đến cách đọc kèo bóng đá toàn bộ tập kết quả được tạo ra. Một phiên bản tương lai củaPL/PGSQLcó thể cho phép người dùng xác định các chức năng trả lại đặt không có giới hạn này. Hiện tại, điểm mà dữ liệu bắt đầu được ghi vào đĩa được điều cách đọc kèo bóng đá bởiwork_memBiến cấu hình. Quản trị viên có đủ bộ nhớ để lưu trữ cách đọc kèo bóng đá bộ kết quả lớn hơn trong bộ nhớ nên xem xét tăng tham số này.
cách đọc kèo bóng đá thủ tục không có giá trị trả về. Do đó, cách đọc kèo bóng đá thủ tục có thể kết thúc mà không córeturnTuyên bố. Nếu bạn muốn sử dụngreturnCâu lệnh để thoát mã sớm, chỉ viếtreturnkhông có biểu thức.
Nếu thủ tục có tham số đầu ra, cách đọc kèo bóng đá giá trị cuối cùng của cách đọc kèo bóng đá biến tham số đầu ra sẽ được trả về cho trình gọi.
APL/PGSQLchức năng, thủ tục hoặcdoBlock có thể gọi thủ tục bằng cách sử dụnggọi. cách đọc kèo bóng đá tham số đầu ra được xử lý khác với cáchgọihoạt động trong SQL đơn giản. MỗiouthoặcInoutTham số của thủ tục phải tương ứng với cách đọc kèo bóng đá biến trongGọiCâu lệnh và bất cứ điều gì mà thủ tục trả về được gán lại cho biến đó sau cách đọc kèo bóng đá nó trả về. Ví dụ:
Tạo quy trình Triple (Inout X Int)
Biến tương ứng với tham số đầu ra có thể là cách đọc kèo bóng đá biến đơn giản hoặc cách đọc kèo bóng đá trường của biến loại tổng hợp. Hiện tại, nó không thể là cách đọc kèo bóng đá yếu tố của cách đọc kèo bóng đá mảng.
nếuvàcasecách đọc kèo bóng đá câu lệnh cho phép bạn thực thi cách đọc kèo bóng đá lệnh thay thế dựa trên cách đọc kèo bóng đá điều kiện nhất định.PL/PGSQLCó ba dạngnếu:
Nếu ... thì ... kết thúc nếu
Nếu ... thì ... khác ... kết thúc nếu
Nếu ... thì ... elsif ... sau đó ... khác ... kết thúc nếu
và hai dạng củacase:
trường hợp ... cách đọc kèo bóng đá ... sau đó ... khác ... trường hợp kết thúc
trường hợp cách đọc kèo bóng đá ... sau đó ... khác ... trường hợp kết thúc
if-thennếuBoolean-biểu hiệnsau đócâu lệnhkết thúc if;
if-thenCâu lệnh là dạng đơn giản nhất củanếu. cách đọc kèo bóng đá câu giữasau đóvàkết thúc nếusẽ được thực thi nếu điều kiện là đúng. Nếu không, chúng bị bỏ qua.
Ví dụ:
Nếu v_user_id < 0 sau đó
if-then-elsenếuBoolean-biểu hiệnsau đóCâukhácCâukết thúc if;
if-then-elseBáo cáo thêm vàoif-thenBằng cách cho phép bạn chỉ định cách đọc kèo bóng đá tập hợp các câu lệnh thay thế nên được thực thi nếu điều kiện không đúng. (Lưu ý điều này bao gồm trường hợp điều kiện đánh giá là null.)
Ví dụ:
Nếu ParentID là null hoặc ParentID = ''
Nếu V_Count 0 sau đó
if-then-elelnếuBoolean-biểu hiệnsau đóCâu[elsifBoolean-biểu hiệnsau đóCâu[elsifBoolean-biểu hiệnsau đócâu...]]kháccâu]
Đôi cách đọc kèo bóng đá có nhiều hơn chỉ hai lựa chọn thay thế.if-then-elelCung cấp cách đọc kèo bóng đá phương pháp thuận tiện để kiểm tra cách đọc kèo bóng đá số lựa chọn thay thế lần lượt. ThenếuĐiều kiện được kiểm tra liên tiếp cho đến khi cái đầu tiên được tìm thấy đúng. Sau đó, (các) câu lệnh liên quan được thực thi, sau đó điều cách đọc kèo bóng đá chuyển sang câu lệnh tiếp theo saukết thúc nếu. (Bất kỳ sau đónếuĐiều kiện làkhôngĐã kiểm tra.) Nếu không cónếuĐiều kiện là đúng, sau đó làkháckhối (nếu có) được thực thi.
Đây là cách đọc kèo bóng đá ví dụ:
Nếu số = 0 thì sau đó
Từ khóaelsifcũng có thể được đánh vầnotherif.
cách đọc kèo bóng đá cách khác để hoàn thành cùng cách đọc kèo bóng đá nhiệm vụ là làm tổif-then-elseCâu lệnh, như trong ví dụ sau:
Nếu demo_row.sex = 'M' sau đó
Tuy nhiên, phương pháp này yêu cầu viết cách đọc kèo bóng đá phù hợpkết thúc nếucho mỗinếu, vì vậy nó cồng kềnh hơn nhiều so với sử dụngelsifcách đọc kèo bóng đá có nhiều lựa chọn thay thế.
casecasebiểu hiện tìm kiếmcách đọc kèo bóng đáBiểu thức[,Biểu thức[...]] sau đóCâu[cách đọc kèo bóng đáBiểu thức[,Biểu thức[...]] sau đócâu...]khácCâu]
Hình thức đơn giản củacaseCung cấp thực thi có điều kiện dựa trên sự bình đẳng của cách đọc kèo bóng đá toán hạng. TheTìm kiếm-biểu hiệnđược đánh giá (cách đọc kèo bóng đá lần) và liên tiếp so với mỗiBiểu thứctrongcách đọc kèo bóng đámệnh đề. Nếu cách đọc kèo bóng đá trận đấu được tìm thấy, thì tương ứngcâu lệnhđược thực thi và sau đó điều cách đọc kèo bóng đá chuyển sang câu lệnh tiếp theo sautrường hợp kết thúc. (Tiếp theocách đọc kèo bóng đáBiểu thức không được đánh giá.) Nếu không tìm thấy khớp nào,khác Câuđược thực thi; Nhưng nếukháckhông có mặt, sau đó làcase_not_foundNgoại lệ được nâng lên.
Đây là cách đọc kèo bóng đá ví dụ đơn giản:
trường hợp x
casetrường hợpBoolean-biểu hiệnsau đócâu lệnh[cách đọc kèo bóng đáBoolean-biểu hiệnsau đóCâu...]khácCâu]
Hình thức được tìm kiếm củacaseCung cấp thực thi có điều kiện dựa trên sự thật của cách đọc kèo bóng đá biểu thức Boolean. Mỗicách đọc kèo bóng đámệnh đềBoolean-biểu hiệnđược đánh giá lần lượt, cho đến cách đọc kèo bóng đá phát hiện ra sản lượngTRUE. Sau đó tương ứngCâuđược thực thi và sau đó điều cách đọc kèo bóng đá chuyển sang câu lệnh tiếp theo sautrường hợp kết thúc. (Tiếp theocách đọc kèo bóng đáBiểu thức không được đánh giá.) Nếu không tìm thấy kết quả đúng nào,khác câuđược thực thi; Nhưng nếukháckhông có mặt, sau đó Acase_not_foundNgoại lệ được nâng lên.
Đây là cách đọc kèo bóng đá ví dụ:
trường hợp
Hình thức này củacasehoàn toàn tương đương vớiif-then-elel, Ngoại trừ quy tắc đạt được sự bỏ quakhácmệnh đề dẫn đến lỗi thay vì không làm gì cả.
vớivòng lặp,Thoát,Tiếp tục,trong cách đọc kèo bóng đá,chovàforeachCâu lệnh, bạn có thể sắp xếp choPL/PGSQLhàm để lặp lại cách đọc kèo bóng đá loạt các lệnh.
vòng lặp[<<nhãn]Câuvòng lặp cuối [nhãn];
vòng lặpXác định một vòng lặp vô điều kiện được lặp lại vô thời hạn cho đến cách đọc kèo bóng đá bị chấm dứt bởi mộtThoáthoặcreturnTuyên bố. Tùy chọnnhãncó thể được sử dụng bởiThoátvàTiếp tụccách đọc kèo bóng đá câu trong cách đọc kèo bóng đá vòng lặp lồng nhau để chỉ định cách đọc kèo bóng đá câu lệnh nào được đề cập đến.
ThoátThoát [nhãn] [cách đọc kèo bóng đáBoolean-biểu hiện];
nếu khôngnhãnđược đưa ra, vòng lặp trong cùng được chấm dứt và câu lệnh sauKết thúc vòngđược thực hiện tiếp theo. Nếu nhưnhãnđược đưa ra, nó phải là nhãn của hiện tại hoặc một số cấp độ bên ngoài của vòng lặp hoặc khối. Sau đó, vòng lặp hoặc khối được đặt tên bị chấm dứt và điều cách đọc kèo bóng đá tiếp tục với câu lệnh sau khi vòng lặp/khối tương ứngkết thúc.
nếucách đọc kèo bóng đáđược chỉ định, lối thoát vòng chỉ xảy ra nếuBoolean-biểu hiệnlà đúng. Nếu không, kiểm soát chuyển sang câu lệnh sauThoát.
Thoátcó thể được sử dụng với tất cả cách đọc kèo bóng đá loại vòng lặp; nó không giới hạn sử dụng với cách đọc kèo bóng đá vòng vô điều kiện.
cách đọc kèo bóng đá được sử dụng vớiBắt đầuBlock,ThoátChuyển điều cách đọc kèo bóng đá sang câu lệnh tiếp theo sau khi kết thúc khối. Lưu ý rằng một nhãn phải được sử dụng cho mục đích này;ThoátKhông bao giờ được coi là phù hợp vớibắt đầukhối. (Đây là cách đọc kèo bóng đá sự thay đổi từ các bản phát hành trước 8.4 củaPostgreSQL, sẽ cho phép không nhãnThoátĐể phù hợp với ABắt đầukhối.)
Ví dụ:
Vòng lặp
Tiếp tụcTiếp tục [nhãn] [cách đọc kèo bóng đáBoolean-biểu hiện];
nếu khôngnhãnđược đưa ra, lần lặp tiếp theo của vòng lặp trong cùng được bắt đầu. Đó là, tất cả các câu lệnh còn lại trong thân vòng được bỏ qua và điều cách đọc kèo bóng đá trả về biểu thức điều cách đọc kèo bóng đá vòng (nếu có) để xác định xem có cần lặp lại vòng lặp khác hay không.nhãnCó mặt, nó chỉ định nhãn của vòng lặp mà thực thi sẽ được tiếp tục.
nếucách đọc kèo bóng đáđược chỉ định, lần lặp tiếp theo của vòng lặp chỉ được bắt đầu nếuBoolean-biểu hiệnlà đúng. Nếu không, kiểm soát chuyển sang câu lệnh sauTiếp tục.
Tiếp tụccó thể được sử dụng với tất cả cách đọc kèo bóng đá loại vòng lặp; nó không giới hạn sử dụng với cách đọc kèo bóng đá vòng vô điều kiện.
Ví dụ:
Vòng lặp
trong cách đọc kèo bóng đá[<<nhãn]Boolean-biểu hiệnvòng lặpcâuvòng lặp cuối [nhãn];
Thetrong cách đọc kèo bóng đáCâu lệnh lặp lại cách đọc kèo bóng đá chuỗi các câu lệnh miễn làBoolean-biểu hiệnĐánh giá là đúng. Biểu thức được kiểm tra ngay trước mỗi mục vào phần thân vòng.
Ví dụ:
Trong cách đọc kèo bóng đá số lượng_owed 0 và gift_certicate_balance 0 vòng lặp
cho(biến thể số nguyên)[<<nhãn]têntrong [đảo ngược]expression..Biểu thức[bởiBiểu thức] vòng lặpCâuvòng lặp cuối [nhãn];
Hình thức này củachoTạo cách đọc kèo bóng đá vòng lặp lặp đi lặp lại trên cách đọc kèo bóng đá loạt các giá trị số nguyên. Biếntênđược định nghĩa tự động là loạiSố nguyênvà chỉ tồn tại bên trong vòng lặp (bất kỳ định nghĩa hiện có nào của tên biến đều bị bỏ qua trong vòng lặp). Hai biểu thức cho giới hạn dưới và trên của phạm vi được đánh giá một lần cách đọc kèo bóng đá vào vòng lặp.bởimệnh đề không được chỉ định Bước lặp là 1, nếu không thì đó là giá trị được chỉ định trongbởimệnh đề, cách đọc kèo bóng đá lần nữa được đánh giá cách đọc kèo bóng đá lần trên mục nhập vòng lặp. Nếu nhưđảo ngượcđược chỉ định thì giá trị bước được trừ, thay vì thêm, sau mỗi lần lặp.
cách đọc kèo bóng đá số ví dụ về số nguyênchovòng lặp:
cho tôi trong 1..10 vòng lặp
Nếu giới hạn dưới lớn hơn giới hạn trên (hoặc nhỏ hơn, trongđảo ngượctrường hợp), phần thân vòng không được thực thi. Không có lỗi được nêu ra.
Nếu Anhãnđược gắn vàochoVòng lặp sau đó biến vòng số nguyên có thể được tham chiếu bằng cách đọc kèo bóng đá tên đủ điều kiện, sử dụng đónhãn.
Sử dụng cách đọc kèo bóng đá loại khácchoVòng lặp, bạn có thể lặp lại thông qua kết quả của cách đọc kèo bóng đá truy vấn và thao tác dữ liệu đó phù hợp. Cú pháp là:
[<<nhãn]TargetinTruy vấnvòng lặpcâuvòng lặp cuối [nhãn];
TheTargetlà biến bản ghi, biến hàng hoặc danh sách cách đọc kèo bóng đá biến vô hướng được phân tách bằng dấu phẩy. TheTargetđược gán liên tiếp cho mỗi hàng doTruy vấnvà thân vòng được thực thi cho mỗi hàng. Đây là cách đọc kèo bóng đá ví dụ:
Tạo hàm refresh_mviews () trả về số nguyên dưới dạng $$
Nếu vòng lặp bị chấm dứt bởiThoátCâu lệnh, giá trị hàng được gán cuối cùng vẫn có thể truy cập được sau vòng lặp.
TheTruy vấnĐược sử dụng trong loại nàychoCâu lệnh có thể là bất kỳ lệnh SQL nào trả về hàng cho người gọi:Chọnlà trường hợp phổ biến nhất, nhưng bạn cũng có thể sử dụngChèn,Cập nhậthoặcXóavới ATrở vềmệnh đề. cách đọc kèo bóng đá số lệnh tiện ích nhưGiải thíchcũng sẽ hoạt động.
PL/PGSQLBiến được thay thế bằng cách đọc kèo bóng đá tham số truy vấn và gói truy vấn được lưu trữ để sử dụng lại có thể, như đã thảo luận chi tiết trongPhần 43.11.1vàPhần 43.11.2.
Thefor-in-ExecuteCâu lệnh là cách đọc kèo bóng đá cách khác để lặp lại trên các hàng:
[<<nhãn]Targettrong thực thitext_expression[sử dụngBiểu thức[, ...]] vòng lặpcâuvòng lặp cuối [nhãn];
Đây giống như biểu mẫu trước đó, ngoại trừ truy vấn nguồn được chỉ định làm biểu thức chuỗi, được đánh giá và trả lời trên mỗi mục nhập vàochoVòng lặp. Điều này cho phép lập trình viên chọn tốc độ của cách đọc kèo bóng đá truy vấn được định sẵn hoặc tính linh hoạt của truy vấn động, giống như với cách đọc kèo bóng đá đơn giảnthực thiTuyên bố. Như vớithực thi, giá trị tham số có thể được chèn vào lệnh động thông quaSử dụng.
cách đọc kèo bóng đá cách khác để chỉ định truy vấn có kết quả nên được lặp đi lặp lại là tuyên bố đó là con trỏ. Điều này được mô tả trongPhần 43.7.4.
TheforeachVòng lặp giống nhưchoVòng lặp, nhưng thay vì lặp qua các hàng được trả về bởi cách đọc kèo bóng đá truy vấn SQL, nó lặp lại thông qua các phần tử của cách đọc kèo bóng đá giá trị mảng. (Nói chung,foreachcó nghĩa là để lặp qua cách đọc kèo bóng đá thành phần của biểu thức có giá trị tổng hợp; cách đọc kèo bóng đá biến thể để lặp qua vật liệu tổng hợp bên cạnh cách đọc kèo bóng đá mảng có thể được thêm vào trong tương lai.)foreachCâu lệnh để lặp qua cách đọc kèo bóng đá mảng là:
[<<nhãn]Target[SliceSố] trong mảngBiểu thứcvòng lặpcâuvòng lặp cuối [nhãn];
khôngSlicehoặc nếuSlice 0được chỉ định, vòng lặp lặp qua cách đọc kèo bóng đá phần tử riêng lẻ của mảng được tạo ra bằng cách đánh giáBiểu thức. TheTargetBiến được gán cho mỗi giá trị phần tử theo trình tự và phần thân vòng được thực thi cho mỗi phần tử. Dưới đây là cách đọc kèo bóng đá ví dụ về việc lặp qua các phần tử của mảng số nguyên:
Tạo hàm sum (int []) trả về int8 dưới dạng $$
cách đọc kèo bóng đá yếu tố được truy cập theo thứ tự lưu trữ, bất kể số lượng kích thước mảng. Mặc dùTargetthường chỉ là một biến duy nhất, nó có thể là một danh sách các biến cách đọc kèo bóng đá lặp qua một mảng các giá trị tổng hợp (bản ghi). Trong trường hợp đó, với mỗi phần tử mảng, các biến được gán từ các cột liên tiếp của giá trị tổng hợp.
với tích cựcSliceGiá trị,foreachlặp lại thông qua cách đọc kèo bóng đá lát của mảng thay vì cách đọc kèo bóng đá phần tử đơn. TheSliceGiá trị phải là hằng số nguyên không lớn hơn số lượng kích thước của mảng. TheTargetBiến phải là cách đọc kèo bóng đá mảng và nó nhận được các lát liên tiếp của giá trị mảng, trong đó mỗi lát có số lượng kích thước được chỉ định bởiSlice. Dưới đây là cách đọc kèo bóng đá ví dụ về việc lặp lại thông qua các lát cách đọc kèo bóng đá chiều:
Tạo chức năng scan_rows (int []) trả về void dưới dạng $$
Theo mặc định, mọi lỗi xảy ra trong APL/PGSQLHàm phá thai thực thi chức năng và giao dịch xung quanh. Bạn có thể bẫy lỗi và khôi phục từ chúng bằng cách sử dụngBắt đầukhối vớingoại lệmệnh đề. Cú pháp là cách đọc kèo bóng đá phần mở rộng của cú pháp bình thường cho cách đọc kèo bóng đábắt đầukhối:
[<<nhãn]khai báoKhai báo]câuNgoại lệđiều kiện[hoặcđiều kiện...] Sau đóHandler_statements[cách đọc kèo bóng đáđiều kiện[hoặcđiều kiện...] Sau đóHandler_statements...]
Nếu không xảy ra lỗi, hình thức khối này chỉ đơn giản là thực thi tất cảcâu, và sau đó điều cách đọc kèo bóng đá chuyển sang câu lệnh tiếp theo saukết thúc. Nhưng nếu xảy ra lỗi trongcâu, Xử lý thêmCâubị bỏ rơi và điều cách đọc kèo bóng đá truyền choNgoại lệDanh sách. Danh sách được tìm kiếm cho đầu tiênđiều kiệnKết hợp lỗi xảy ra. Nếu tìm thấy cách đọc kèo bóng đá trận đấu, tương ứngHandler_statementsđược thực thi và sau đó điều cách đọc kèo bóng đá chuyển sang câu lệnh tiếp theo saukết thúc. Nếu không tìm thấy khớp nào, lỗi sẽ truyền ra như thểNgoại lệmệnh đề hoàn toàn không có: lỗi có thể bị bắt bởi cách đọc kèo bóng đá khối kèm theo vớiNgoại lệhoặc nếu không có ai phá hủy việc xử lý chức năng.
Theđiều kiệnTên có thể là bất kỳ tên nào được hiển thị trongPhụ lục A. cách đọc kèo bóng đá tên danh mục phù hợp với bất kỳ lỗi trong danh mục của nó.kháckhớp với mọi loại lỗi ngoại trừquery_canceledvàAssert_Failure. (Có thể, nhưng thường không khôn ngoan, để bẫy hai loại lỗi đó theo tên.) Tên điều kiện không nhạy cảm với trường hợp.SQLSTATEMã; Ví dụ: đây là tương đương:
cách đọc kèo bóng đá Division_by_zero sau đó ...
Nếu xảy ra lỗi mới trong phạm vi đã chọnHandler_statements, nó không thể bị bắt bởi điều nàyNgoại lệmệnh đề, nhưng được truyền ra. cách đọc kèo bóng đá xung quanhNgoại lệmệnh đề có thể bắt được nó.
cách đọc kèo bóng đá lỗi bị bắt bởiNgoại lệmệnh đề, cách đọc kèo bóng đá biến cục bộ củaPL/PGSQLChức năng vẫn còn như cách đọc kèo bóng đá lỗi xảy ra, nhưng tất cả các thay đổi đối với trạng thái cơ sở dữ liệu liên tục trong khối được quay lại. Ví dụ, hãy xem xét đoạn này:
Chèn vào cách đọc kèo bóng đá giá trị mytab (firstName, lastName) ('tom', 'jones');
Khi điều cách đọc kèo bóng đá đạt được gán choY, nó sẽ thất bại với ADivision_by_zeroLỗi. Điều này sẽ bị bắt bởiNgoại lệmệnh đề. Giá trị được trả về trongreturnCâu lệnh sẽ là giá trị gia tăng củax, nhưng cách đọc kèo bóng đá hiệu ứng củaCập nhậtLệnh sẽ được quay lại. TheChènTuy nhiên, lệnh trước khối không được quay lại, do đó, kết quả cuối cùng là cơ sở dữ liệu chứaTom JoneskhôngJoe Jones.
cách đọc kèo bóng đá khối chứaNgoại lệmệnh đề đắt hơn đáng kể cách đọc kèo bóng đá nhập và thoát so với một khối mà không có một. Do đó, không sử dụngNgoại lệKhông cần.
Ví dụ 43.2.Ngoại lệ vớiCập nhật/Chèn
Ví dụ này sử dụng xử lý ngoại lệ để thực hiệnCập nhậthoặcChèn, cách đọc kèo bóng đá thích hợp. Khuyến nghị rằng các ứng dụng sử dụngChènvớitrên xung đột do cập nhậtthay vì thực sự sử dụng mẫu này. Ví dụ này chủ yếu phục vụ để minh họa việc sử dụngPL/PGSQLCấu trúc luồng điều cách đọc kèo bóng đá:
Tạo bảng DB (khóa chính int, văn bản B);
Mã hóa này giả địnhđộc đáo_violationLỗi là doChèn, và không phải, nói, cách đọc kèo bóng đáChènTrong cách đọc kèo bóng đá hàm kích hoạt trên bảng. Nó cũng có thể sai nếu có nhiều hơn cách đọc kèo bóng đá chỉ mục duy nhất trên bảng, vì nó sẽ thử lại hoạt động bất kể chỉ số nào gây ra lỗi.
Người xử lý ngoại lệ thường cần xác định lỗi cụ thể xảy ra. Có hai cách để có được thông tin về ngoại lệ hiện tại trongPL/PGSQL: cách đọc kèo bóng đá biến đặc biệt vàNhận chẩn đoán xếp chồnglệnh.
Trong cách đọc kèo bóng đá trình xử lý ngoại lệ, biến đặc biệtSQLSTATEChứa mã lỗi tương ứng với ngoại lệ được nêu ra (tham khảoBảng A.1Để biết danh sách cách đọc kèo bóng đá mã lỗi có thể). Biến đặc biệtSQLERRMChứa thông báo lỗi được liên kết với ngoại lệ. cách đọc kèo bóng đá biến này không được xác định bên ngoài bộ xử lý ngoại lệ.
Trong cách đọc kèo bóng đá trình xử lý ngoại lệ, người ta cũng có thể truy xuất thông tin về ngoại lệ hiện tại bằng cách sử dụngNhận chẩn đoán xếp chồngLệnh, có biểu mẫu:
Nhận chẩn đoán xếp chồngbiến= | : =Mục[, ...];
mỗiMụclà cách đọc kèo bóng đá từ khóa xác định giá trị trạng thái được gán cho được chỉ địnhBiến(nên thuộc loại dữ liệu phù hợp để nhận nó). cách đọc kèo bóng đá mục trạng thái hiện có được hiển thị trongBảng 43.2.
Bảng 43.2.cách đọc kèo bóng đá mục chẩn đoán lỗi
| tên | loại | Mô tả |
|---|---|---|
return_sqlstate |
Text |
Mã lỗi SQLSTATE của ngoại lệ |
Cột_name |
Text |
Tên của cột liên quan đến ngoại lệ |
|
Text |
Tên của ràng buộc liên quan đến ngoại lệ |
pg_datatype_name |
Text |
Tên của kiểu dữ liệu liên quan đến ngoại lệ |
message_text |
Text |
Văn bản của thông báo chính của ngoại lệ |
Table_Name |
Text |
Tên của bảng liên quan đến ngoại lệ |
Schema_name |
Text |
Tên của lược đồ liên quan đến ngoại lệ |
pg_exception_detail |
Text |
Văn bản của thông báo chi tiết ngoại lệ, nếu có |
pg_exception_hint |
Text |
Văn bản của thông báo gợi ý ngoại lệ, nếu có |
pg_exception_context |
Text |
dòng văn bản mô tả ngăn xếp cuộc gọi tại thời điểm ngoại lệ (xemPhần 43.6.9) |
Nếu ngoại lệ không đặt giá trị cho cách đọc kèo bóng đá mục, cách đọc kèo bóng đá chuỗi trống sẽ được trả về.
Đây là cách đọc kèo bóng đá ví dụ:
Khai báo
TheNhận chẩn đoánLệnh, được mô tả trước đây trongPhần 43.5.5, Lấy thông tin về trạng thái thực thi hiện tại (trong cách đọc kèo bóng đáNhận chẩn đoán xếp chồngLệnh đã thảo luận trên báo cáo thông tin về trạng thái thực thi kể từ lỗi trước đó). Của nópg_contextMục trạng thái hữu ích để xác định vị trí thực thi hiện tại.pg_contextTrả về cách đọc kèo bóng đá chuỗi văn bản với dòng văn bản mô tả ngăn xếp cuộc gọi. Dòng đầu tiên đề cập đến chức năng hiện tại và hiện đang thực thiNhận chẩn đoánLệnh. cách đọc kèo bóng đá dòng thứ hai và bất kỳ dòng tiếp theo nào cũng đề cập đến cách đọc kèo bóng đá chức năng gọi lên thêm ngăn xếp cuộc gọi.
Tạo hoặc thay thế hàm outer_func () trả về số nguyên dưới dạng $$
Nhận Chẩn đoán xếp chồng ... PG_EXception_ContextTrả về cùng cách đọc kèo bóng đá loại dấu vết ngăn xếp, nhưng mô tả vị trí mà tại đó cách đọc kèo bóng đá lỗi được phát hiện, thay vì vị trí hiện tại.
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.