Phiên bản được hỗ trợ:hiện tại(17)16 / 15 / 14 / 13
Phiên bản phát triển:18 / Devel
Phiên bản không được hỗ trợ:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1
Tài liệu này dành cho phiên bản không được hỗ trợ của PostgreSQL.
Bạn có thể muốn xem cùng một trang chohiện tạiPhiên bản hoặc một trong các phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

Tạo cách đọc kèo bóng đá ngữ

Tạo cách đọc kèo bóng đá ngữ - Xác định cách đọc kèo bóng đá ngữ thủ tục mới

Synopsis

Tạo [hoặc thay thế] [đáng tin cậy] [Thủ tục] cách đọc kèo bóng đá ngữtênHandlercall_handler[Inlineinline_handler] [Trình xác nhậnValfunction]tên

Mô tả

Tạo cách đọc kèo bóng đá ngữĐăng ký một cách đọc kèo bóng đá ngữ thủ tục mới vớiPostgreSQLCơ sở dữ liệu. Sau đó, các chức năng và quy trình có thể được xác định trong cách đọc kèo bóng đá ngữ mới này.

Tạo cách đọc kèo bóng đá ngữliên kết hiệu quả tên cách đọc kèo bóng đá ngữ với (các) hàm xử lý chịu trách nhiệm thực thi các chức năng được viết bằng cách đọc kèo bóng đá ngữ. Tham khảoChương 57Để biết thêm thông tin về người xử lý cách đọc kèo bóng đá ngữ.

Tạo hoặc thay thế cách đọc kèo bóng đá ngữsẽ tạo một cách đọc kèo bóng đá ngữ mới hoặc thay thế một định nghĩa hiện có. Nếu cách đọc kèo bóng đá ngữ đã tồn tại, các tham số của nó được cập nhật theo lệnh, nhưng cài đặt quyền sở hữu và quyền của cách đọc kèo bóng đá ngữ không thay đổi và bất kỳ chức năng hiện có nào được viết bằng cách đọc kèo bóng đá ngữ vẫn được giả định vẫn còn hiệu lực.

một người phải cóPostgreSQLĐặc quyền của SuperUser để đăng ký cách đọc kèo bóng đá ngữ mới hoặc thay đổi các tham số của cách đọc kèo bóng đá ngữ hiện có. Tuy nhiên, một khi cách đọc kèo bóng đá ngữ được tạo ra, có hợp lệ khi gán quyền sở hữu nó cho người không siêu giám sát, người sau đó có thể bỏ nó, thay đổi quyền của nó, đổi tên nó hoặc gán nó cho chủ sở hữu mới.

hình thức củaTạo cách đọc kèo bóng đá ngữĐiều đó không cung cấp bất kỳ chức năng xử lý nào bị lỗi thời. Để tương thích ngược với các tệp kết xuất cũ, nó được hiểu làTạo tiện ích mở rộng. Điều đó sẽ hoạt động nếu cách đọc kèo bóng đá ngữ đã được đóng gói thành một phần mở rộng cùng tên, đó là cách thông thường để thiết lập các cách đọc kèo bóng đá ngữ thủ tục.

tham số

Trusted

TrustedChỉ định rằng cách đọc kèo bóng đá ngữ không cấp quyền truy cập vào dữ liệu mà người dùng sẽ không có. Nếu từ khóa này bị bỏ qua khi đăng ký cách đọc kèo bóng đá ngữ, chỉ người dùng cóPostgreSQLĐặc quyền Superuser có thể sử dụng cách đọc kèo bóng đá ngữ này để tạo các chức năng mới.

Thủ tục

Đây là một từ tiếng ồn.

tên

Tên của cách đọc kèo bóng đá ngữ thủ tục mới. Tên phải là duy nhất trong số các cách đọc kèo bóng đá ngữ trong cơ sở dữ liệu.

Handler call_handler

call_handlerlà tên của hàm đã đăng ký trước đó sẽ được gọi để thực hiện các chức năng của cách đọc kèo bóng đá ngữ thủ tục. Trình xử lý cuộc gọi cho một cách đọc kèo bóng đá ngữ thủ tục phải được viết bằng cách đọc kèo bóng đá ngữ được biên dịch như C với quy ước gọi phiên bản 1 và được đăng ký vớiPostgreSQLLà một hàm không có đối số và trả lạicách đọc kèo bóng đá_handlerLoại, loại trình giữ chỗ được sử dụng đơn giản để xác định chức năng như một trình xử lý cuộc gọi.

nội tuyến inline_handler

inline_handlerlà tên của hàm đã đăng ký trước đó sẽ được gọi để thực thi một khối mã ẩn danh (dolệnh) trong cách đọc kèo bóng đá ngữ này. Nếu khônginline_handlerHàm được chỉ định, cách đọc kèo bóng đá ngữ không hỗ trợ các khối mã ẩn danh. Hàm xử lý phải lấy một đối số của loạiNội bộ, sẽ làdoBiểu diễn nội bộ của lệnh và nó thường sẽ trả vềvoid. Giá trị trả về của người xử lý bị bỏ qua.

Validator Valfunction

Valfunctionlà tên của hàm đã đăng ký trước đó sẽ được gọi khi một hàm mới trong cách đọc kèo bóng đá ngữ được tạo, để xác thực hàm mới. Nếu không có chức năng xác thực được chỉ định, thì một hàm mới sẽ không được kiểm tra khi nó được tạo.oid, sẽ là oid của hàm được tạo và thường sẽ trả vềvoid.

Một hàm xác thực thường kiểm tra cơ thể chức năng cho tính chính xác của cú pháp, nhưng nó cũng có thể xem xét các thuộc tính khác của hàm, ví dụ nếu cách đọc kèo bóng đá ngữ không thể xử lý các loại đối số nhất định. Để báo hiệu một lỗi, hàm xác thực sẽ sử dụngEREPORT ()Hàm. Giá trị trả về của hàm bị bỏ qua.

ghi chú

sử dụngcách đọc kèo bóng đá ngữ thảĐể bỏ các cách đọc kèo bóng đá ngữ thủ tục.

Danh mục hệ thốngPG_L Language(xemPhần 52,29) Hồ sơ thông tin về các cách đọc kèo bóng đá ngữ hiện đã được cài đặt. Ngoài ra,PSQLlệnh\ DLliệt kê các cách đọc kèo bóng đá ngữ đã cài đặt.

Để tạo các hàm trong cách đọc kèo bóng đá ngữ thủ tục, người dùng phải cósử dụngĐặc quyền cho cách đọc kèo bóng đá ngữ. Theo mặc định,sử dụngđược cấp chocông khai(tức là mọi người) cho các cách đọc kèo bóng đá ngữ đáng tin cậy. Điều này có thể bị thu hồi nếu muốn.

cách đọc kèo bóng đá ngữ thủ tục là địa phương cho các cơ sở dữ liệu riêng lẻ. Tuy nhiên, một cách đọc kèo bóng đá ngữ có thể được cài đặt vàoTemplate1Cơ sở dữ liệu, sẽ khiến nó có sẵn tự động trong tất cả các cơ sở dữ liệu được tạo ra sau đó.

Ví dụ

Một chuỗi tối thiểu để tạo cách đọc kèo bóng đá ngữ thủ tục mới là:

Tạo chức năng plsample_call_handler () trả về cách đọc kèo bóng đá_handler

Thông thường sẽ được viết trong tập lệnh tạo của tiện ích mở rộng và người dùng sẽ làm điều này để cài đặt tiện ích mở rộng:

Tạo phần mở rộng plsample;

Tương thích

Tạo cách đọc kèo bóng đá ngữPostgreSQLphần mở rộng.