Thay vì thực hiện toàn bộ truy vấn cùng kèo chấp bóng đá hôm nay lúc, có thể thiết lập kèo chấp bóng đá hôm naykèo chấp bóng đá hôm nay trỏĐóng gói truy vấn, và sau đó đọc kết quả truy vấn kèo chấp bóng đá hôm nay vài hàng cùng kèo chấp bóng đá hôm nay lúc. kèo chấp bóng đá hôm nay lý do để làm điều này là để tránh ghi đè bộ nhớ khi kết quả chứa kèo chấp bóng đá hôm nay số lượng lớn các hàng. (Tuy nhiên,PL/PGSQLNgười dùng thường không cần phải lo lắng về điều đó, vìcho
Loops tự động sử dụng kèo chấp bóng đá hôm nay trỏ bên trong để tránh các vấn đề về bộ nhớ.) Cách sử dụng thú vị hơn là trả về một tham chiếu đến kèo chấp bóng đá hôm nay trỏ mà hàm đã tạo, cho phép người gọi đọc các hàng. Điều này cung cấp một cách hiệu quả để trả về các bộ hàng lớn từ các chức năng.
Tất cả quyền truy cập vào kèo chấp bóng đá hôm nay trỏ trongPL/PGSQLĐi qua các biến kèo chấp bóng đá hôm nay trỏ, luôn thuộc loại dữ liệu đặc biệtrefcursor
. Một cách để tạo biến kèo chấp bóng đá hôm nay trỏ chỉ là khai báo nó là một biến của loạirefcursor
. Một cách khác là sử dụng cú pháp khai báo kèo chấp bóng đá hôm nay trỏ, nói chung là:
tên
[[Không] cuộn] kèo chấp bóng đá hôm nay trỏ [(Đối số
)] choTruy vấn
;
(cho
có thể được thay thế bằnglà
choOracleKhả năng tương thích.) Nếucuộn
được chỉ định, kèo chấp bóng đá hôm nay trỏ sẽ có khả năng cuộn ngược; nếu nhưKhông có cuộn
được chỉ định, tìm nạp ngược sẽ bị từ chối; Nếu không có thông số kỹ thuật nào xuất hiện, nó phụ thuộc vào truy vấn liệu có được phép tìm kiếm ngược không.Đối số
, nếu được chỉ định, là danh sách các cặp được phân tách bằng dấu phẩy
Xác định tên sẽ được thay thế bằng các giá trị tham số trong truy vấn đã cho. Các giá trị thực tế để thay thế cho các tên này sẽ được chỉ định sau, khi kèo chấp bóng đá hôm nay trỏ được mở.tên
DataType
kèo chấp bóng đá hôm nay số ví dụ:
Khai báo Curs1 refcursor; kèo chấp bóng đá hôm nay trỏ curs2 cho chọn * từ tenk1; kèo chấp bóng đá hôm nay trỏ curs3 (số nguyên khóa) cho chọn * từ tenk1 trong đó độc đáo1 = key;
Cả ba biến này đều có kiểu dữ liệurefcursor
, nhưng lần đầu tiên có thể được sử dụng với bất kỳ truy vấn nào, trong khi thứ hai có truy vấn được chỉ định đầy đủ đã được chỉ địnhBoundĐối với nó và cuối cùng có kèo chấp bóng đá hôm nay truy vấn được tham số hóa liên kết với nó. (Key
sẽ được thay thế bằng giá trị tham số số nguyên khi kèo chấp bóng đá hôm nay trỏ được mở.) Biếncurs1
được cho làkhông bị ràng buộcVì nó không bị ràng buộc với bất kỳ truy vấn cụ thể nào.
Trước khi kèo chấp bóng đá hôm nay trỏ có thể được sử dụng để lấy hàng, nó phải làMở. (Đây là hành động tương đương với lệnh SQLTuyên bố kèo chấp bóng đá hôm nay trỏ
.)PL/PGSQLCó ba dạng củaMở
Câu lệnh, hai trong số đó sử dụng các biến kèo chấp bóng đá hôm nay trỏ không liên kết trong khi loại thứ ba sử dụng biến kèo chấp bóng đá hôm nay trỏ ràng buộc.
Các biến kèo chấp bóng đá hôm nay trỏ bị ràng buộc cũng có thể được sử dụng mà không cần mở một cách rõ ràng kèo chấp bóng đá hôm nay trỏ, thông quacho
Câu lệnh được mô tả trongPhần 42.7.4.
Mở cho
Truy vấn
MởUNBOUND_CURSORVAR
[[Không] cuộn] choTruy vấn
;
Biến kèo chấp bóng đá hôm nay trỏ được mở và cung cấp truy vấn được chỉ định để thực thi. kèo chấp bóng đá hôm nay trỏ không thể mở và nó phải được khai báo là một biến kèo chấp bóng đá hôm nay trỏ không liên kết (nghĩa là, như một đơn giảnrefcursor
Biến). Truy vấn phải làChọn
hoặc kèo chấp bóng đá hôm nay cái gì đó khác trả về hàng (chẳng hạn nhưGiải thích
). Truy vấn được xử lý theo cách tương tự như các lệnh SQL khác trongPL/PGSQL: PL/PGSQLTên biến được thay thế và gói truy vấn được lưu trong bộ nhớ cache để tái sử dụng có thể. Khi APL/PGSQL16486_16603Mở
; Những thay đổi tiếp theo đối với biến sẽ không ảnh hưởng đến hành vi của kèo chấp bóng đá hôm nay trỏ. Thecuộn
vàKhông có cuộn
Tùy chọn có ý nghĩa tương tự như đối với kèo chấp bóng đá hôm nay trỏ bị ràng buộc.
kèo chấp bóng đá hôm nay ví dụ:
Mở Curs1 để chọn * từ foo trong đó key = myKey;
Mở để thực thi
MởUNBOUND_CURSORVAR
[[Không] cuộn] để thực thiquery_string
[Sử dụngBiểu thức
[, ...]];
Biến kèo chấp bóng đá hôm nay trỏ được mở và cung cấp truy vấn được chỉ định để thực thi. kèo chấp bóng đá hôm nay trỏ không thể mở và nó phải được khai báo là một biến kèo chấp bóng đá hôm nay trỏ không liên kết (nghĩa là, như một đơn giảnRefcursor
Biến). Truy vấn được chỉ định làm biểu thức chuỗi, giống như trongthực thi
Lệnh. Như thường lệ, điều này mang lại sự linh hoạt để gói truy vấn có thể thay đổi từ lần chạy này sang lần chạy tiếp theo (xemPhần 42.10.2), và nó cũng có nghĩa là thay thế biến không được thực hiện trên chuỗi lệnh. Như vớithực thi
, giá trị tham số có thể được chèn vào lệnh động thông quađịnh dạng ()
vàsử dụng
. Thecuộn
vàKhông có cuộn
Tùy chọn có ý nghĩa tương tự như đối với kèo chấp bóng đá hôm nay trỏ bị ràng buộc.
kèo chấp bóng đá hôm nay ví dụ:
18588_18679
Trong ví dụ này, tên bảng được chèn vào truy vấn thông quađịnh dạng ()
. Giá trị so sánh chocol1
được chèn qua Asử dụng
tham số, vì vậy nó không cần trích dẫn.
MởBound_cursorvar
[([arging_name
: =]arging_value
[, ...])];
Hình thức nàyMở
được sử dụng để mở một biến kèo chấp bóng đá hôm nay trỏ mà truy vấn bị ràng buộc với nó khi nó được khai báo. kèo chấp bóng đá hôm nay trỏ không thể mở. Một danh sách các biểu thức giá trị đối số thực tế phải xuất hiện khi và chỉ khi kèo chấp bóng đá hôm nay trỏ được tuyên bố lấy các đối số. Các giá trị này sẽ được thay thế trong truy vấn.
Kế hoạch truy vấn cho một kèo chấp bóng đá hôm nay trỏ ràng buộc luôn được coi là có thể lưu trữ được; không có tương đươngthực thi
Trong trường hợp này. Lưu ý rằngcuộn
vàKhông có cuộn
Không thể được chỉ định trongMở
, vì hành vi cuộn của kèo chấp bóng đá hôm nay trỏ đã được xác định.
Giá trị đối số có thể được truyền bằng cách sử dụngvị tríhoặcĐược đặt tênKý hiệu. Trong ký hiệu vị trí, tất cả các đối số được chỉ định theo thứ tự. Trong ký hiệu được đặt tên, tên của mỗi đối số được chỉ định bằng: =
Để tách nó khỏi biểu thức đối số. Tương tự như các chức năng gọi, được mô tả trongPhần 4.3, Nó cũng được phép trộn ký hiệu vị trí và ký hiệu.
Ví dụ (những ví dụ này sử dụng các ví dụ khai báo kèo chấp bóng đá hôm nay trỏ ở trên):
Mở Call2; Mở Curs3 (42); Mở Curs3 (khóa: = 42);
Vì sự thay thế biến được thực hiện trên truy vấn của kèo chấp bóng đá hôm nay trỏ bị ràng buộc, thực sự có hai cách để truyền các giá trị vào kèo chấp bóng đá hôm nay trỏ: với một đối số rõ ràng choMở
hoặc ngầm bằng cách tham chiếu APL/PGSQLBiến trong truy vấn. Tuy nhiên, chỉ các biến được khai báo trước khi kèo chấp bóng đá hôm nay trỏ bị ràng buộc được khai báo sẽ được thay thế vào nó. Trong cả hai trường hợp, giá trị được thông qua được xác định tại thời điểmMở
. Ví dụ: kèo chấp bóng đá hôm nay cách khác để có được hiệu ứng tương tự nhưcurs3
Ví dụ ở trên là
Khai báo số nguyên chính; kèo chấp bóng đá hôm nay trỏ curs4 cho chọn * từ tenk1 trong đó duy nhất1 = phím; BẮT ĐẦU khóa: = 42; Mở curs4;
Một khi kèo chấp bóng đá hôm nay trỏ đã được mở, nó có thể được thao tác với các câu lệnh được mô tả ở đây.
Những thao tác này không cần phải xảy ra trong cùng một chức năng mở kèo chấp bóng đá hôm nay trỏ để bắt đầu. Bạn có thể trả lại mộtrefcursor
Giá trị từ một hàm và để người gọi hoạt động trên kèo chấp bóng đá hôm nay trỏ. (Bên trong, Arefcursor
Giá trị chỉ đơn giản là tên chuỗi của một cổng thông tin được gọi là truy vấn hoạt động cho kèo chấp bóng đá hôm nay trỏ. Tên này có thể được truyền xung quanh, được gán cho khácRefcursor
Biến, v.v.
Tất cả các cổng được đóng hoàn toàn ở cuối giao dịch. Do đó Arefcursor
Giá trị có thể sử dụng để tham khảo một kèo chấp bóng đá hôm nay trỏ mở cho đến khi kết thúc giao dịch.
Fetch
Fetch [Hướng
từ | TRONG]kèo chấp bóng đá hôm nay trỏ
thànhTarget
;
Fetch
Lấy hàng tiếp theo từ kèo chấp bóng đá hôm nay trỏ thành mục tiêu, có thể là một biến hàng, biến bản ghi hoặc danh sách các biến đơn giản được phân tách bằng dấu phẩy, giống nhưChọn vào
. Nếu không có hàng tiếp theo, mục tiêu sẽ được đặt thành NULL (S). Như vớiChọn vào
, biến đặc biệttìm thấy
Có thể kiểm tra xem có lấy được kèo chấp bóng đá hôm nay hàng hay không.
TheHướng
mệnh đề có thể là bất kỳ biến thể nào được phép trong SQLFetchLệnh ngoại trừ các lệnh có thể tìm nạp nhiều hơn kèo chấp bóng đá hôm nay hàng; cụ thể là, nó có thể làNEXT
, Trước
, Đầu tiên
, cuối cùng
, Tuyệt đối
Đếm
, tương đối
Đếm
, Chuyển tiếp
hoặcBackward
. Bỏ quaHướng
giống như chỉ địnhTiếp theo
. Trong các biểu mẫu bằng cách sử dụngĐếm
, TheĐếm
Có thể là bất kỳ biểu thức có giá trị số nguyên nào (không giống như SQLFetch
lệnh, chỉ cho phép kèo chấp bóng đá hôm nay hằng số nguyên).Hướng
Các giá trị yêu cầu di chuyển về phía sau có khả năng bị hỏng trừ khi kèo chấp bóng đá hôm nay trỏ được khai báo hoặc mở vớicuộn
Tùy chọn.
kèo chấp bóng đá hôm nay trỏ
phải là tên của Arefcursor
Biến tham chiếu một cổng kèo chấp bóng đá hôm nay trỏ mở.
ví dụ:
Tìm nạp curs1 vào rowvar; Tìm nạp curs2 vào foo, bar, baz; Lấy cuối cùng từ Curs3 vào X, Y; Tìm nạp tương đối -2 từ call4 vào x;
Di chuyển
Di chuyển [Hướng
từ | TRONG]kèo chấp bóng đá hôm nay trỏ
;
Di chuyển
Định vị lại một kèo chấp bóng đá hôm nay trỏ mà không cần truy xuất bất kỳ dữ liệu nào.Di chuyển
hoạt động giống hệtFetch
Lệnh, ngoại trừ nó chỉ định vị lại kèo chấp bóng đá hôm nay trỏ và không trả lại hàng chuyển đến. Như vớiChọn vào
, Biến đặc biệttìm thấy
Có thể kiểm tra xem liệu có hàng tiếp theo để di chuyển đến.
ví dụ:
di chuyển call1; Di chuyển cuối cùng từ curs3; Di chuyển tương đối -2 từ call4; Di chuyển về phía trước 2 từ CULS4;
Cập nhật/xóa nơi hiện tại của
Cập nhậtBảng
Đặt ... trong đó hiện tại củakèo chấp bóng đá hôm nay trỏ
; Xóa khỏiBảng
trong đó hiện tại củakèo chấp bóng đá hôm nay trỏ
;
Khi một kèo chấp bóng đá hôm nay trỏ được định vị trên một hàng bảng, hàng đó có thể được cập nhật hoặc xóa bằng cách sử dụng kèo chấp bóng đá hôm nay trỏ để xác định hàng. Có những hạn chế về truy vấn của kèo chấp bóng đá hôm nay trỏ có thể là gì (đặc biệt là không nhóm) và tốt nhất là sử dụngđể cập nhật
Trong kèo chấp bóng đá hôm nay trỏ. Để biết thêm thông tin, xemkhai báotrang tham chiếu.
kèo chấp bóng đá hôm nay ví dụ:
Cập nhật foo set dataval = myVal trong đó dòng điện của curs1;
Đóng
Đóngkèo chấp bóng đá hôm nay trỏ
;
Đóng
Đóng cổng thông tin bên dưới một kèo chấp bóng đá hôm nay trỏ mở. Điều này có thể được sử dụng để phát hành tài nguyên sớm hơn cuối giao dịch hoặc để giải phóng biến kèo chấp bóng đá hôm nay trỏ để được mở lại.
kèo chấp bóng đá hôm nay ví dụ:
Đóng Call1;
PL/PGSQLCác chức năng có thể trả lại kèo chấp bóng đá hôm nay trỏ cho người gọi. Điều này rất hữu ích để trả về nhiều hàng hoặc cột, đặc biệt là với các bộ kết quả rất lớn. Để làm điều này, chức năng mở kèo chấp bóng đá hôm nay trỏ và trả lại tên kèo chấp bóng đá hôm nay trỏ cho người gọi (hoặc chỉ đơn giản là mở kèo chấp bóng đá hôm nay trỏ bằng tên cổng thông tin được chỉ định bởi hoặc được người gọi biết. Người gọi sau đó có thể lấy hàng từ kèo chấp bóng đá hôm nay trỏ. kèo chấp bóng đá hôm nay trỏ có thể được đóng bởi người gọi hoặc nó sẽ được đóng tự động khi giao dịch đóng.
Tên cổng thông tin được sử dụng cho kèo chấp bóng đá hôm nay trỏ có thể được chỉ định bởi lập trình viên hoặc tự động tạo. Để chỉ định tên cổng thông tin, chỉ cần gán một chuỗi chorefcursor
Biến trước khi mở nó. Giá trị chuỗi củaRefcursor
Biến sẽ được sử dụng bởiMở
là tên của cổng thông tin cơ bản. Tuy nhiên, nếurefcursor
Biến là NULL,Mở
tự động tạo tên không xung đột với bất kỳ cổng thông tin hiện có nào và gán nó chorefcursor
Biến.
Một biến kèo chấp bóng đá hôm nay trỏ bị ràng buộc được khởi tạo thành giá trị chuỗi đại diện cho tên của nó, do đó tên cổng thông tin giống như tên biến kèo chấp bóng đá hôm nay trỏ, trừ khi lập trình viên ghi đè lên nó bằng cách gán trước khi mở kèo chấp bóng đá hôm nay trỏ. Nhưng một biến số kèo chấp bóng đá hôm nay trỏ không liên kết mặc định ban đầu cho giá trị null, do đó nó sẽ nhận được một tên duy nhất được tạo tự động, trừ khi được ghi đè.
Ví dụ sau đây hiển thị một cách một tên kèo chấp bóng đá hôm nay trỏ có thể được cung cấp bởi người gọi:
Tạo thử nghiệm bảng (văn bản col); Chèn vào các giá trị kiểm tra ('123'); Tạo chức năng Reffunc (refcursor) Trả về refcursor là ' BẮT ĐẦU Mở $ 1 cho chọn col từ bài kiểm tra; Trả lại $ 1; KẾT THÚC; 'Ngôn ngữ plpgsql; BẮT ĐẦU; Chọn reffunc ('funccursor'); Tìm nạp tất cả trong funccursor; LÀM;
Ví dụ sau sử dụng tạo tên kèo chấp bóng đá hôm nay trỏ tự động:
Tạo hàm reffunc2 () trả về refcursor là ' TUYÊN BỐ ref refcursor; BẮT ĐẦU Mở REF cho chọn Col từ thử nghiệm; Trả lại ref; KẾT THÚC; 'Ngôn ngữ plpgsql; - Cần phải trong một giao dịch để sử dụng kèo chấp bóng đá hôm nay trỏ. BẮT ĐẦU; Chọn reffunc2 (); Reffunc2 -------------------- <kèo chấp bóng đá hôm nay trỏ không tên 1 (1 hàng) Tìm nạp tất cả trong "<kèo chấp bóng đá hôm nay trỏ không tên 1"; LÀM;
Ví dụ sau đây hiển thị một cách để trả về nhiều kèo chấp bóng đá hôm nay trỏ từ một hàm duy nhất:
Tạo hàm myfunc (refcursor, refcursor) Trả về setof refcur BẮT ĐẦU Mở $ 1 cho chọn * từ TABLE_1; Trả lại tiếp theo $ 1; Mở $ 2 cho chọn * từ bảng_2; Trả lại tiếp theo $ 2; KẾT THÚC; $$ Ngôn ngữ plpgsql; - Cần phải trong một giao dịch để sử dụng kèo chấp bóng đá hôm nay trỏ. BẮT ĐẦU; Chọn * từ myfunc ('a', 'b'); Tìm nạp tất cả từ a; Tìm nạp tất cả từ b; LÀM;
Có kèo chấp bóng đá hôm nay biến thể củacho
Câu lệnh cho phép lặp qua các hàng được trả về bởi một kèo chấp bóng đá hôm nay trỏ. Cú pháp là:
[<<nhãn
] VÌRecordVar
inBound_cursorvar
[([argion_name
: =]argarn_value
[, ...])] vòng lặpCâu
vòng lặp cuối [nhãn
];
Biến kèo chấp bóng đá hôm nay trỏ phải bị ràng buộc với một số truy vấn khi nó được khai báo và nókhông thểĐã mở. Thecho
Câu lệnh tự động mở kèo chấp bóng đá hôm nay trỏ và nó đóng lại kèo chấp bóng đá hôm nay trỏ khi vòng lặp thoát ra. Một danh sách các biểu thức giá trị đối số thực tế phải xuất hiện khi và chỉ khi kèo chấp bóng đá hôm nay trỏ được tuyên bố lấy các đối số. Các giá trị này sẽ được thay thế trong truy vấn, theo cách tương tự như trong mộtMở
(xemPhần 42.7.2.3).
BiếnRecordVar
được định nghĩa tự động là loạiRecord
và 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). Mỗi hàng được trả về bởi kèo chấp bóng đá hôm nay trỏ được gán liên tiếp cho biến bản ghi này và phần thân vòng được thực thi.