Oracle自定義函式(function)
函式用於返回特定資料。執行時得找一個變數接收函式的返回值;
語法如下: create or replace function function_name
(
argu1 [mode1] datatype1,
argu2 [mode2] datatype2, ........
)
return datatype
is
begin
end;
執行 var v1 varchar2(100)
exec :v1:=function_name
不帶任何引數
create or replace function get_user return varchar2 is
Result varchar2(50);
begin
select username into Result from user_users;
return(Result);
end get_user;
執行:
帶in引數的
create or replace function get_sal(empname in varchar2) return number is
Result number;
begin
select sal into Result from emp where ename=empname;
return(Result);
end get_sal;
執行: SQL> var sal number
SQL> exec :sal:=get_sal('scott');
帶out引數的函式
create or replace function get_info(e_name varchar2,job out varchar2) return number is
Result number;
begin
select sal,job into Result,job from emp where ename=e_name;
return(Result);
end get_info;
執行: SQL> var job varchar2(20)
SQL> var dname varchar2(20)
SQL> exec :dname:=get_info('SCOTT',:job)
帶in out引數的函式
create or replace function result(num1 number,num2 in out number) return number is
v_result number(6);
v_remainder number;
begin
v_result :=num1/num2;
v_remainder :=mod(num1,num2);
num2 :=v_remainder;
return(v_result);
Exception
when zero_divide then
raise_application_error(-20000,'不能除0');
end result;
執行: var result1 number;
var result2 number;
exec :result2:=30
exec :result1:=result(100,:result2)
eg:
1 、一個最簡單的自定義函式Fun_test1的定義。
create or replace function Fun_test1(p_1 number)--Fun_test1是函式名，有一個輸入引數p_1，是number型的。返回值也是number型的
return number
IS
begin
if p_1>0 then
return 1;
elsif p_1=0 then
return 0;
else
return -1;
end if;
end;
--這個函式只是可以知道自定義函式的定義和格式。其實沒什麼用途。
2、Fun_test1自定義函式的呼叫的儲存過程Pro_Fun_test1_1示例：
create or replace procedure Pro_Fun_test1_1(
p1_in in number,
p2_out out number
)
AS
begin
p2_out:=Fun_test1(p1_in);
end Pro_Fun_test1_1;
--一個輸入引數，一個輸出引數
3、Fun_test1自定義函式的呼叫的儲存過程Pro_Fun_test1_2示例：
create or replace procedure Pro_Fun_test1_2(
p1_in in number,
p2_out out number
)
AS
t_1 number;
begin
select Fun_test1(p1_in)+100 INTO p2_out
from bill_org where org_ID=1;
end Pro_Fun_test1_2;
--自定義函式的呼叫方法和Oracle的其它內部函式是一樣的。
二、包的定義和使用入門
包一般是過程和函式的集合,對過程和函式進行更好的封裝,一般不針對欄位。
包的構成包括包頭和包體。
1、包頭的定義：
包頭僅僅只是對包中的方法進行說明,而沒有實現
語法：
create or replace package myPackage_1
is
procedure syaHello(vname varchar2);--申明瞭該包中的一個過程
end;
2、包體的定義：
包體是對包頭中定義的過程、函式的具體實現。
create or replace package body myPackage_1
is
procedure syaHello(vname varchar2)--對包中定義的過程的實現
is
begin
dbms_output.put_line('Hello '||vname);
end;
end;
要注意的是：
create or replace package後面的名稱必須和create or replace package body後面的名稱一致，
如果將create or replace package body後面的名稱改為，'MYPACKAGE'
否則將會出現諸如下面的錯誤：
必須說明識別符號 'MYPACKAGE'
3、呼叫包用的自定義方法：
create or replace procedure Pro_test_package(
p1_in string
)
AS
begin
myPackage_1.syaHello(p1_in);
end Pro_test_package;
eg2:
--沒有引數的函式
create or replace function get_user return varchar2 is v_user varchar2(50);
begin
select username into v_user from user_users;
return v_user;
return v_user;
--測試
方法一
select get_user from dual;
方法二
SQL> var v_name varchar2(50)
SQL> exec :v_name:=get_user;
--帶有IN引數的函式
create or replace function get_empname(v_id in number) return varchar2 as v_name varchar2(50);
begin
select name into v_name from employee where id = v_id;
return v_name;
exception
when no_data_found then raise_application_error(-20001, '你輸入的ID無效!');
end get_empname;
附：
函式呼叫限制
1、SQL語句中只能呼叫儲存函式(伺服器端),而不能呼叫客戶端的函式
2、SQL只能呼叫帶有輸入引數,不能帶有輸出,輸入輸出函式
3、SQL不能使用PL/SQL的特有資料型別(boolean,table,record等)
4、SQL語句中呼叫的函式不能包含INSERT,UPDATE和DELETE語句
檢視函式院原始碼
oracle會將函式名及其原始碼資訊存放到資料字典中user_source
select text from user_source where name='GET_EMPNAME';
刪除函式
drop function get_empname;
判斷任務過期時間：
create or replace function GetUrgentState(m_TaskID varchar2,
m_SendTime date,
m_flag varchar2)
return varchar2 IS
myDate date;
ExpireTime date;
strsql varchar2(200);
begin
myDate := m_SendTime;
strsql := 'select max(EXPIRETIME) from t_wf_supervise where TASKID =''' ||
m_TaskID || '''';
execute immediate strsql
into ExpireTime;
--沒有到期時間 就是正常狀態
if ExpireTime is null then
if m_flag = 'String' then
return '正常';
end if;
if m_flag = 'Img' then
return 'cb_execute.gif';
end if;
end if;
--未傳送任務，就是判斷當前時間
if m_SendTime is null then
myDate := sysdate;
end if;
if ExpireTime < myDate then
if m_flag = 'String' then
return '超期';
end if;
if m_flag = 'Img' then
return 'cb_limit.gif';
end if;
end if;
--小於3天的任務預警
if ExpireTime - myDate < 3 then
if m_flag = 'String' then
return '預警';
end if;
if m_flag = 'Img' then
return 'cb_warning.gif';
end if;
else
if m_flag = 'String' then
return '正常';
end if;
if m_flag = 'Img' then
return 'cb_execute.gif';
end if;
end if;
end;
查詢其它表資料：
create or replace function GetPreNode(m_PreTaskID varchar2) return varchar2 IS
nodename varchar2(50);
strsql varchar2(200);
begin
if m_PreTaskID is null then
return '';
end if;
strsql := 'select max(nodename) from t_Wf_Tasklist where TaskID =''' ||
m_PreTaskID|| '''';
execute immediate strsql
into nodename;
return nodename;
end;
格式化標題輸出：
create or replace function FormatTitle(m_title varchar2,
m_length number,
m_FillChar varchar2) return varchar2 IS
begin
if lengthb(m_title) > m_length*2 then
return substr(m_title, 0,m_length) || m_FillChar;
else
return m_title;
end if;
end;