Mysql自定義函式(CREATE FUNCTION)
在使用 MySQL 的過程中,MySQL 自帶的函式可能完成不了我們的業務需求,這時候就需要自定義函式。
自定義函式是一種與儲存過程十分相似的過程式資料庫物件。它與儲存過程一樣,都是由 SQL 語句和過程式語句組成的程式碼片段,並且可以被應用程式和其他 SQL 語句呼叫。
自定義函式與儲存過程之間存在幾點區別:
- 自定義函式不能擁有輸出引數,這是因為自定義函式自身就是輸出引數;而儲存過程可以擁有輸出引數。
- 自定義函式中必須包含一條 RETURN 語句,而這條特殊的 SQL 語句不允許包含於儲存過程中。
- 可以直接對自定義函式進行呼叫而不需要使用 CALL 語句,而對儲存過程的呼叫需要使用 CALL 語句。
一、建立與使用自定義函式
可以使用 CREATE FUNCTION 語句建立自定義函式。
語法格式如下:
CREATE FUNCTION <函式名> ( [ <引數1> <型別1> [ , <引數2> <型別2>] ] … ) RETURNS <型別> <函式主體>
語法說明如下:
-
<函式名>
:指定自定義函式的名稱。注意,自定義函式不能與儲存過程具有相同的名稱。 -
<引數><型別>
:用於指定自定義函式的引數。這裡的引數只有名稱和型別,不能指定關鍵字 IN、OUT 和 INOUT。 -
RETURNS<型別>
:用於宣告自定義函式返回值的資料型別。其中,<型別>
用於指定返回值的資料型別。 -
<函式主體>
:自定義函式的主體部分,也稱函式體。所有在儲存過程中使用的 SQL 語句在自定義函式中同樣適用,包括前面所介紹的區域性變數、SET 語句、流程控制語句、遊標等。除此之外,自定義函式體還必須包含一個RETURN<值>
語句,其中<值>
用於指定自定義函式的返回值。
在 RETURN VALUE 語句中包含 SELECT 語句時,SELECT 語句的返回結果只能是一行且只能有一列值。
若要檢視資料庫中存在哪些自定義函式,可以使用 SHOW FUNCTION STATUS
<函式名>
用於指定該自定義函式的名稱。
【例項 1】建立儲存函式,名稱為 StuNameById,該函式返回 SELECT 語句的查詢結果,數值型別為字串型別,輸入的 SQL 語句和執行結果如下所示。
mysql> CREATE FUNCTION StuNameById() -> RETURNS VARCHAR(45) -> RETURN -> (SELECT name FROM tb_students_info -> WHERE id=1); Query OK, 0 rows affected (0.09 sec)
注意:當使用 DELIMITER 命令時,應該避免使用反斜槓“\”字元,因為反斜槓是 MySQL 的轉義字元。
成功建立自定義函式後,就可以如同呼叫系統內建函式一樣,使用關鍵字 SELECT 呼叫使用者自定義的函式,語法格式為:
SELECT <自定義函式名> ([<引數> [,...]])
【例項 2】呼叫自定義函式 StuNameById,檢視函式的執行結果,如下所示。
mysql> SELECT StuNameById(); +---------------+ | StuNameById() | +---------------+ | Dany | +---------------+ 1 row in set (0.24 sec)
二、修改自定義函式
可以使用 ALTER FUNCTION 語句來修改自定義函式的某些相關特徵。若要修改自定義函式的內容,則需要先刪除該自定義函式,然後重新建立。
三、刪除自定義函式
自定義函式被建立後,一直儲存在資料庫伺服器上以供使用,直至被刪除。刪除自定義函式的方法與刪除儲存過程的方法基本一樣,可以使用 DROP FUNCTION 語句來實現。
語法格式如下:
DROP FUNCTION [ IF EXISTS ] <自定義函式名>
語法說明如下。<自定義函式名>
:指定要刪除的自定義函式的名稱。IF EXISTS
:指定關鍵字,用於防止因誤刪除不存在的自定義函式而引發錯誤。
【例項 3】刪除自定義函式 StuNameById,檢視函式的執行結果,如下所示。
mysql> DROP FUNCTION StuNameById; Query OK, 0 rows affected (0.09 sec) mysql> SELECT StuNameById(); ERROR 1305 (42000): FUNCTION test_db.StuNameById does not exist