Tạo [hoặc thay thế] chức cách đọc kèo bóng đátên([[argmode] [argname]argtype[Mặc định | =default_expr] [, ...]]))
[ReturnRettype| Trả về bảng (Cột_name Cột_Type[, ...])]]
NGÔN NGỮLang_Name| CỬA SỔ
| Bất biến | Ổn định | BAY HƠI
| Được gọi trên NULL đầu vào | Trả về NULL trên đầu vào null | NGHIÊM NGẶT
| [Bên ngoài] Invoker bảo mật | [Bên ngoài] Bảo mật Definer
| TRỊ GIÁexec_cost| Hàngresult_rows11852_11865Cấu hình_parametertogiá trị| =giá trị| Từ hiện tại
| BẰNG 'Định nghĩa'
| BẰNG 'obj_file','link_symbol'
...
[ VỚI (thuộc tính[, ...])]
Tạo chức cách đọc kèo bóng đáXác định mới chức cách đọc kèo bóng đá.Tạo hoặc thay thế chức cách đọc kèo bóng đáSẽ tạo chức cách đọc kèo bóng đá mới hoặc thay thế một sự định nghĩa. Để có thể xác định chức cách đọc kèo bóng đá, người dùng phải có Thesử dụngĐặc quyền về ngôn ngữ.
12727_13071quá tải).
Để thay thế định nghĩa hiện tại của cách đọc kèo bóng đá hàm hiện có, sử dụngTạo hoặc thay thế chức cách đọc kèo bóng đá. Nó không phải là có thể thay đổi tên hoặc loại đối số của một hàm này cách (nếu bạn đã thử, bạn thực sự sẽ tạo ra một mới, khác biệt chức cách đọc kèo bóng đá). Cũng,cách đọc kèo bóng đá hoặc thay thế CHỨC NĂNGsẽ không cho phép bạn thay đổi loại trả lại của một chức cách đọc kèo bóng đá hiện có. Để làm điều đó, bạn phải bỏ và tái tạo chức cách đọc kèo bóng đá. (Khi sử dụngouttham số, Điều đó có nghĩa là bạn không thể thay đổi các loại của bất kỳouttham số ngoại trừ bằng cách bỏ chức cách đọc kèo bóng đá.)
KhiTạo hoặc thay thế chức cách đọc kèo bóng đáIS được sử dụng để thay thế một chức cách đọc kèo bóng đá hiện có, quyền sở hữu và Quyền của chức cách đọc kèo bóng đá không thay đổi. Tất cả các chức cách đọc kèo bóng đá khác các thuộc tính được gán các giá trị được chỉ định hoặc ngụ ý trong yêu cầu. Bạn phải sở hữu chức cách đọc kèo bóng đá để thay thế nó (bao gồm là thành viên của vai trò sở hữu).
Nếu bạn bỏ và sau đó tạo lại một hàm, chức cách đọc kèo bóng đá mới là không giống nhau như cũ; Bạn sẽ phải bỏ hiện tại Các quy tắc, quan điểm, kích hoạt, vv đề cập đến hàm cũ. Sử dụng14343_14371Để thay đổi a định nghĩa chức cách đọc kèo bóng đá mà không phá vỡ các đối tượng đề cập đến chức cách đọc kèo bóng đá. Cũng,Chức cách đọc kèo bóng đá thay đổicó thể được sử dụng để thay đổi hầu hết các thuộc tính phụ trợ của một chức cách đọc kèo bóng đá.
14604_14677
Tên (Tùy chọn Lược đồ theo trình độ) của chức cách đọc kèo bóng đá để tạo.
Chế độ của cách đọc kèo bóng đá đối số:in, out, InouthoặcVariadic. Nếu bị bỏ qua, mặc định làin. Chỉ cách đọc kèo bóng đáoutĐối số có thể theo dõiVariadiccách đọc kèo bóng đá. Cũng,outvàInout15482_15536BẢNG TRẢ LẠIký hiệu.
Tên của một đối số. Một số ngôn ngữ (bao gồm PL/PGSQL, nhưng hiện tại không phải SQL) cho phép bạn sử dụng tên trong các chức cách đọc kèo bóng đá cơ thể. Đối với các ngôn ngữ khác, tên của một đầu vào Đối số chỉ là tài liệu bổ sung, cho đến nay chức cách đọc kèo bóng đá tự quan tâm; Nhưng bạn có thể sử dụng đầu vào Tên đối số khi gọi một hàm để cải thiện Khả cách đọc kèo bóng đá đọc (xemPhần 4.3). Trong bất kỳ trường hợp, tên của cách đọc kèo bóng đá đối số đầu ra là đáng kể, Bởi vì nó xác định tên cột trong loại hàng kết quả. (Nếu bạn bỏ qua tên cho cách đọc kèo bóng đá đối số đầu ra, hệ thống sẽ chọn tên cột mặc định.)
Loại dữ liệu của các đối số của hàm (tùy chọn Lược đồ-đủ điều kiện), nếu có. Các loại đối số có thể là cơ sở, tổng hợp hoặc các loại miền hoặc có thể tham chiếu loại cột bảng.
Tùy thuộc vào ngôn ngữ triển khai, nó cũng có thể được phép chỉ định"Pseudotypes"chẳng hạn nhưCSTRING. Pseudotypes chỉ ra rằng thực tế Loại đối số được chỉ định không đầy đủ hoặc bên ngoài tập hợp các loại dữ liệu SQL thông thường.
Loại cột được tham chiếu bằng cách viếtTable_Name.17219_17232%loại. Sử dụng điều này tính cách đọc kèo bóng đá đôi khi có thể giúp tạo ra một chức cách đọc kèo bóng đá độc lập với thay đổi định nghĩa của bảng.
cách đọc kèo bóng đá biểu thức được sử dụng làm giá trị mặc định nếu Tham số không được chỉ định. Biểu thức phải là cưỡng chế loại đối số của tham số. Chỉ đầu vào (bao gồmInout) Các tham số có thể có cách đọc kèo bóng đá giá trị mặc định. Tất cả các tham số đầu vào sau cách đọc kèo bóng đá tham số có giá trị mặc định phải có giá trị mặc định là Tốt.
Loại dữ liệu trả về (tùy chọn trình độ sơ đồ theo trình độ). Các Loại trả về có thể là loại cơ sở, tổng hợp hoặc miền hoặc có thể tham chiếu loại của cách đọc kèo bóng đá cột bảng. Tùy thuộc vào Ngôn ngữ triển khai Nó cũng có thể được phép chỉ định"Pseudotypes"chẳng hạn nhưcstring. Nếu chức cách đọc kèo bóng đá không được phép Trả về một giá trị, chỉ địnhvoidnhư Loại trả về.
Khi cóouthoặcInouttham số,returnĐiều khoản có thể được bỏ qua. Nếu có mặt, nó phải đồng ý với loại kết quả được ngụ ý bởi đầu ra tham số:RecordNếu có nhiều tham số đầu ra hoặc cùng loại với đơn tham số đầu ra.
ThesetofCông cụ sửa đổi cho biết rằng chức cách đọc kèo bóng đá sẽ trả về một tập hợp các mục, thay vì mục đơn.
Loại cột được tham chiếu bằng cách viếtTable_Name.Cột_name%loại.
Tên của cột đầu ra trongBẢNG TRẢ LẠICú pháp. Điều này là hiệu quả cách đọc kèo bóng đá cách khác để tuyên bố cách đọc kèo bóng đá tênouttham số, ngoại trừBẢNG TRẢ LẠIcũng ngụ ýreturn setof.
Kiểu dữ liệu của cột đầu ra trongBảng trả vềCú pháp.
Tên của ngôn ngữ mà hàm là được triển khai. Có thể làSQL, C, Nội bộhoặc tên của người dùng do người dùng định nghĩa Ngôn ngữ thủ tục. Để tương thích ngược, tên có thể được đặt trong các trích dẫn đơn.
Windowchỉ ra rằng chức cách đọc kèo bóng đá làHàm cửa sổchứ không phải là một hàm đơn giản. Điều này hiện chỉ hữu ích cho các chức cách đọc kèo bóng đá được viết bằng C. TheWindowthuộc tính không thể thay đổi khi thay thế một định nghĩa chức cách đọc kèo bóng đá hiện có.
20867_21027Disrilelà giả định mặc định.
21131_21142chỉ ra rằng chức cách đọc kèo bóng đá không thể sửa đổi cơ sở dữ liệu và luôn trả về Kết quả tương tự khi được đưa ra cùng một giá trị đối số; đó là, nó không thực hiện tra cứu cơ sở dữ liệu hoặc sử dụng Thông tin không trực tiếp trình bày trong danh sách đối số của nó. Nếu như Tùy chọn này được đưa ra, mọi cuộc gọi của chức cách đọc kèo bóng đá với Các đối số liên tục có thể được thay thế ngay lập tức bằng giá trị chức cách đọc kèo bóng đá.
ổn địnhchỉ ra rằng
chức cách đọc kèo bóng đá không thể sửa đổi cơ sở dữ liệu và trong một
Quét bảng đơn, nó sẽ liên tục trả về giống nhau
kết quả cho cùng một giá trị đối số, nhưng kết quả của nó
có thể thay đổi trên các câu lệnh SQL. Đây là thích hợp
Lựa chọn cho các chức cách đọc kèo bóng đá có kết quả phụ thuộc vào cơ sở dữ liệu
Tra cứu, các biến tham số (chẳng hạn như thời gian hiện tại
vùng), v.v. (nó không phù hợp chosauTrình kích hoạt muốn truy vấn hàng
được sửa đổi bởi lệnh hiện tại.) Cũng lưu ý rằngcurrent_timestampGia đình của
các chức cách đọc kèo bóng đá đủ điều kiện là ổn định, vì giá trị của chúng không
thay đổi trong một giao dịch.
Disrilychỉ ra rằng Giá trị chức cách đọc kèo bóng đá có thể thay đổi ngay cả trong một lần quét bảng, Vì vậy, không có tối ưu hóa có thể được thực hiện. Tương đối ít cơ sở dữ liệu Các chức cách đọc kèo bóng đá dễ bay hơi theo nghĩa này; Một số ví dụ làngẫu nhiên (), currval (), Timeofday (). Nhưng lưu ý rằng bất kỳ chức cách đọc kèo bóng đá nào có tác dụng phụ phải được phân loại biến động, ngay cả khi nó Kết quả là khá dễ đoán, để ngăn chặn các cuộc gọi không tối ưu hóa đi; Một ví dụ làsetVal ().
Để biết thêm chi tiết, xemPhần 35.6.
được gọi là đầu vào null(The mặc định) chỉ ra rằng hàm sẽ được gọi Thông thường khi một số lập luận của nó là vô giá trị. Đó là lúc đó chức cách đọc kèo bóng đá của tác giả có trách nhiệm kiểm tra NULL các giá trị nếu cần thiết và trả lời một cách thích hợp.
Trả về NULL trên đầu vào nullhoặcnghiêm ngặtcho biết chức cách đọc kèo bóng đá Luôn trả lại NULL bất cứ khi nào bất kỳ đối số nào của nó là NULL. Nếu tham số này được chỉ định, hàm không được thực hiện khi có các đối số null; thay vào đó là một null Kết quả được giả định tự động.
Bảo mật Invokerchỉ ra rằng chức cách đọc kèo bóng đá sẽ được thực thi với các đặc quyền của người dùng gọi nó. Đó là mặc định.bảo mật xác địnhChỉ định rằng chức cách đọc kèo bóng đá sẽ được thực thi với các đặc quyền của người dùng đã tạo nó.
Từ khóabên ngoàiIS được phép cho sự phù hợp SQL, nhưng nó là tùy chọn kể từ đó, Không giống như trong SQL, tính cách đọc kèo bóng đá này áp dụng cho tất cả các chức cách đọc kèo bóng đá không Chỉ những cái bên ngoài.
Một số dương đưa ra chi phí thực hiện ước tính cho chức cách đọc kèo bóng đá, theo đơn vịCPU_OPERATOR_COST. Nếu hàm trả về một bộ, đây là chi phí cho mỗi trở lại hàng. Nếu chi phí không được chỉ định, 1 đơn vị là giả sử cho các chức cách đọc kèo bóng đá ngôn ngữ C và nội bộ, và 100 Các đơn vị cho các chức cách đọc kèo bóng đá trong tất cả các ngôn ngữ khác. Giá trị lớn hơn khiến người lập kế hoạch cố gắng tránh đánh giá chức cách đọc kèo bóng đá Thường xuyên hơn mức cần thiết.
Một số dương cho số lượng hàng ước tính Rằng người lập kế hoạch nên mong đợi chức cách đọc kèo bóng đá trở lại. Cái này chỉ được phép khi hàm được khai báo trả về bộ. Giả định mặc định là 1000 hàng.
Thesetmệnh đề gây ra tham số cấu hình được chỉ định được đặt thành giá trị được chỉ định khi nhập hàm, và sau đó được khôi phục về giá trị trước của nó khi hàm thoát ra.Đặt từ hiện tạiLưu Giá trị hiện tại của phiên của tham số là giá trị được áp dụng khi chức cách đọc kèo bóng đá được nhập.
Nếu Asetmệnh đề được gắn vào một chức cách đọc kèo bóng đá, sau đó các hiệu ứng của mộtĐặt ĐỊA PHƯƠNGlệnh được thực thi bên trong hàm cho cùng một biến bị giới hạn trong hàm: Giá trị trước của tham số cấu hình vẫn được khôi phục tại Thoát chức cách đọc kèo bóng đá. Tuy nhiên, một bình thườngsetlệnh (không cócục bộ) ghi đèsetmệnh đề, nhiều như nó sẽ làm cho cách đọc kèo bóng đá trướcĐặt cục bộLệnh: The Hiệu ứng của một lệnh như vậy sẽ tồn tại sau khi thoát chức cách đọc kèo bóng đá, Trừ khi giao dịch hiện tại được cuộn trở lại.
xemsetvàChương 18Để biết thêm thông tin về tên và giá trị tham số được phép.
Một hằng số chuỗi xác định hàm; ý nghĩa phụ thuộc vào ngôn ngữ. Nó có thể là một chức cách đọc kèo bóng đá nội bộ Tên, đường dẫn đến tệp đối tượng, lệnh SQL hoặc văn bản bằng ngôn ngữ thủ tục.
Thường rất hữu ích khi sử dụng trích dẫn đô la (xemPhần 4.1.2.4) để ghi chuỗi định nghĩa chức cách đọc kèo bóng đá, thay vì cú pháp trích dẫn đơn bình thường. Không có đô la trích dẫn, bất kỳ trích dẫn đơn hoặc dấu gạch chéo ngược trong hàm Định nghĩa phải được thoát ra bằng cách nhân đôi chúng.
Hình thức này củaASmệnh đề là được sử dụng cho các hàm ngôn ngữ C có thể tải động khi Tên chức cách đọc kèo bóng đá trong mã nguồn ngôn ngữ C không giống nhau là tên của hàm SQL. Chuỗiobj_file28440_28523link_symbollà liên kết của chức cách đọc kèo bóng đá Biểu tượng, nghĩa là tên của hàm trong ngôn ngữ C. Mã nguồn. Nếu ký hiệu liên kết bị bỏ qua, nó được giả định giống như tên của chức cách đọc kèo bóng đá SQL được xác định.
Khi lặp lạiTạo chức cách đọc kèo bóng đáCác cuộc gọi tham khảo cùng cách đọc kèo bóng đá tệp đối tượng, tệp chỉ là được tải cách đọc kèo bóng đá lần mỗi phiên. Để dỡ và tải lại tệp (có lẽ trong quá trình phát triển), bắt đầu cách đọc kèo bóng đá phiên mới.
Cách lịch sử để chỉ định các phần tùy chọn của thông tin về chức cách đọc kèo bóng đá. Các thuộc tính sau đây có thể xuất hiện ở đây:
tương đương vớinghiêm ngặthoặcTrả về null trên null Đầu vào.
isCachablelà cách đọc kèo bóng đá lỗi thời Tương đương vớibất biến; nó vẫn được chấp nhận để tương thích ngược lý do.
Tên thuộc tính không nhạy cảm với trường hợp.
Tham khảoPhần 35.3Để biết thêm thông tin về chức cách đọc kèo bóng đá viết.
PostgreSQLcho phép chức cách đọc kèo bóng đáquá tải; nghĩa là, cùng một tên có thể được sử dụng cho một số chức cách đọc kèo bóng đá khác nhau miễn là chúng có Các loại đối số đầu vào khác biệt. Tuy nhiên, tên C của tất cả Các chức cách đọc kèo bóng đá phải khác nhau, vì vậy bạn phải cho C quá tải C Chức cách đọc kèo bóng đá các tên C khác nhau (ví dụ: sử dụng các loại đối số như một phần của tên C).
Hai chức cách đọc kèo bóng đá được coi là giống nhau nếu chúng có giống nhau Tên vàINPUTCác loại đối số, bỏ qua bất kỳouttham số. Do đó, ví dụ như những tuyên bố xung đột:
Tạo chức cách đọc kèo bóng đá foo (int) ... Tạo chức cách đọc kèo bóng đá foo (int, out text) ...
Các chức cách đọc kèo bóng đá có danh sách loại đối số khác nhau sẽ không được được coi là xung đột vào thời điểm sáng tạo, nhưng nếu mặc định là miễn là họ có thể xung đột trong việc sử dụng. Ví dụ, xem xét
Tạo chức cách đọc kèo bóng đá foo (int) ... Tạo hàm foo (int, int mặc định 42) ...
cách đọc kèo bóng đá cuộc gọifoo (10)sẽ thất bại do sự mơ hồ về chức cách đọc kèo bóng đá nào nên được gọi.
toàn bộSQLLoại cú pháp là được phép khai báo các đối số của hàm và giá trị trả về. Tuy nhiên, các bộ điều chỉnh loại dấu ngoặc đơn (ví dụ: trường chính xác cho loạiSố) bị loại bỏ bởiTạo chức cách đọc kèo bóng đá. Do đó, ví dụTạo chức cách đọc kèo bóng đá foo (varchar (10)) ...IS Chính xác giống nhưTạo chức cách đọc kèo bóng đá foo (varchar) ....
Khi thay thế chức cách đọc kèo bóng đá hiện có bằngTạo hoặc thay thế chức cách đọc kèo bóng đá32181_32710
Nếu cách đọc kèo bóng đá hàm được khai báonghiêm ngặtVới cách đọc kèo bóng đáVariadicĐối số, sự nghiêm ngặt Kiểm tra các kiểm tra rằng mảng variadictoàn bộkhông phải là null. Các chức cách đọc kèo bóng đá vẫn sẽ được gọi nếu mảng có các phần tử null.
Dưới đây là cách đọc kèo bóng đá số ví dụ tầm thường để giúp bạn bắt đầu. Vì Thêm thông tin và ví dụ, xemPostgreSQL:.
Tạo chức cách đọc kèo bóng đá Thêm (Số nguyên, Số nguyên) Trả về Integer
Như 'Chọn $ 1 + $ 2;'
Ngôn ngữ SQL
Bất biến
Trả về null trên đầu vào null;
Tăng số nguyên, sử dụng tên đối số, trongPL/PGSQL:
Tạo hoặc thay thế chức cách đọc kèo bóng đá tăng (I Integer) Trả về số nguyên dưới dạng $$
BẮT ĐẦU
Trả về i + 1;
KẾT THÚC;
$$ ngôn ngữ plpgsql;
Trả về bản ghi chứa nhiều tham số đầu ra:
Tạo chức cách đọc kèo bóng đá DUP (trong int, out f1 int, out f2 văn bản)
Như $$ Chọn $ 1, diễn viên ($ 1 dưới dạng văn bản) || 'là văn bản' $$
Ngôn ngữ SQL;
Chọn * từ DUP (42);
Bạn có thể làm điều tương tự hơn cách đọc kèo bóng đá cách rõ ràng với cách đọc kèo bóng đá loại tổng hợp được đặt tên:
34160_34350
cách đọc kèo bóng đá cách khác để trả về nhiều cột là sử dụngBảngchức cách đọc kèo bóng đá:
34490_34646
Tuy nhiên, ABảngHàm là khác với các ví dụ trước, bởi vì nó thực sự trả về asetcủa bản ghi, không chỉ cách đọc kèo bóng đá bản ghi.
vì abảo mật xác địnhHàm được thực thi với các đặc quyền của người dùng đã tạo nó, quan tâm là cần thiết để đảm bảo rằng chức cách đọc kèo bóng đá không thể bị lạm dụng. Vì bảo vệ,search_pathnên được đặt để loại trừ bất kỳ lược đồ nào có thể ghi được bởi người dùng không tin cậy. Điều này ngăn người dùng độc hại tạo ra các đối tượng che giấu các đối tượng được sử dụng bởi chức cách đọc kèo bóng đá. Đặc biệt quan trọng trong việc này quan tâm là lược đồ bàn tạm thời, được tìm kiếm đầu tiên bởi Mặc định, và thường có thể ghi bởi bất kỳ ai. Một sự sắp xếp an toàn có thể có bằng cách buộc lược đồ tạm thời được tìm kiếm cuối cùng. Để làm điều này, viếtPG_TEMPNhư lần cuối cùng mục trongsearch_path. Hàm này Minh họa cách sử dụng an toàn:
Tạo chức cách đọc kèo bóng đá Check_password (văn bản Uname, Pass Text)
Trả lại boolean là $$
Tuyên bố đã thông qua Boolean;
BẮT ĐẦU
Chọn (PWD = $ 2)
Từ NKT
Trong đó tên người dùng = $ 1;
Trở lại qua;
KẾT THÚC;
$$ Ngôn ngữ plpgsql
Bảo mật xác định
- Đặt một search_path an toàn: lược đồ đáng tin cậy, sau đó 'pg_temp'.
Đặt search_path = admin, pg_temp;
trướcPostgreSQLPhiên bản 8.3,setTùy chọn không khả dụng, và vì vậy các chức cách đọc kèo bóng đá cũ hơn có thể chứa logic khá phức tạp đối với lưu, đặt và khôi phục36551_36564. Thesettùy chọn dễ sử dụng hơn cho việc này mục đích.
cách đọc kèo bóng đá điểm khác cần lưu ý là theo mặc định, thực thi Đặc quyền được cấp chocông khaicho mới đã tạo các chức cách đọc kèo bóng đá (xemGrantcho thêm thông tin). Thường xuyên bạn sẽ muốn hạn chế sử dụng Chức cách đọc kèo bóng đá xác định bảo mật chỉ có một số người dùng. Để làm điều đó, bạn Phải thu hồi mặc địnhcông khaiĐặc quyền và sau đó cấp đặc quyền thực thi một cách chọn lọc. Để tránh Có một cửa sổ có chức cách đọc kèo bóng đá mới có thể truy cập được cho tất cả, Tạo nó và đặt các đặc quyền trong một giao dịch. Vì ví dụ:
Bắt đầu; Tạo chức cách đọc kèo bóng đá kiểm tra_password (văn bản uname, pass văn bản) ... bảo mật xác định; Thu hồi tất cả trên chức cách đọc kèo bóng đá kiểm tra_password (văn bản uname, pass văn bản) từ công khai; Cấp thực thi trên chức cách đọc kèo bóng đá kiểm tra_password (văn bản uname, truyền văn bản) cho quản trị viên; LÀM;
ATạo chức cách đọc kèo bóng đáLệnh được xác định trong SQL: 1999 và sau đó. ThePOSTGRESQLPhiên bản tương tự nhưng không hoàn toàn tương thích. Các thuộc tính không thể di động, cũng không phải là các ngôn ngữ có sẵn khác nhau.
Để tương thích với cách đọc kèo bóng đá số hệ thống cơ sở dữ liệu khác,argmodecó thể được viết trước hoặc trước hoặc sau đóargname. Nhưng chỉ đầu tiên cách tuân thủ tiêu chuẩn.
38184_38262mặc định38292_38435=được sử dụng trong T-SQL và Firebird.
| prev | 39295_39301 | Tiếp theo |
| cách đọc kèo bóng đá dữ liệu nước ngoài Trình bao bọc | UP | cách đọc kèo bóng đá nhóm |