SQL Server 自定義函數（Function）——參數默認值

sql server 自定義函數分為三種類型：標量函數（Scalar Function）、內嵌表值函數（Inline Function）、多聲明表值函數（Multi-Statement Function）

標量函數：標量函數是對單一值操作，返回單一值。

內嵌表值函數：內嵌表值函數的功能相當於一個參數化的視圖。它返回的是一個表，內聯表值型函數沒有由BEGIN-END 語句括起來的函數體。

多聲明表值函數：它的返回值是一個表，但它和標量型函數一樣有一個用BEGIN-END 語句括起來的函數體，返回值的表中的數據是由函數體中的語句插入的。

它可以進行多次查詢，對數據進行多次篩選與合並，彌補了內聯表值型函數的不足。

 

創建標量函數的語法：

create function [函數的所有者].函數名(標量參數 [as] 標量參數類型 [=默認值])
returns 標量返回值類型
[with {Encryption | Schemabinding }]
[as]
begin
    函數體(即 Transact-SQL 語句)
    return 變量/標量表達式
end

下面自定義一個根據傳入參數（即學生性別）來計算學生平均身高的 Function，示例如下：

use Test
go

create function dbo.AvgHeight(@Sex varchar(10)='男')    --在這里是給參數默認值，即可以不傳參數調用這個函數
returns decimal
as
begin
    declare @AvgHeight decimal(10,2)
    select @AvgHeight=AVG(Convert(decimal(10,2),S_Height)) from Student where S_Sex=@Sex
    return @AvgHeight
end
go

執行用戶自定義標量函數：

select [函數的所有者].函數名 as 字段別名

select dbo.AvgHeight(default) as AvgHeight;    --返回 179
select dbo.AvgHeight('男');     --返回 179
select dbo.AvgHeight('女');     --返回 176

PS:創建函數時指定了函數所有者，那么調用的時候也必須指定函數的所有者。（一般都為 dbo）

調用自定義函數時如果想不傳入參數而使用默認值，那么必須使用 default 關鍵字。如果自定義函數的參數沒有默認值，那么會返回 null。

 

創建內嵌表值函數語法：

create function [函數的所有者].函數名(標量參數 [as] 標量參數類型 [=默認值])
returns table
[with {Encryption | Schemabinding }]
[as]
return(單個 SELECT 語句，確定返回的表的數據。)

下面自定義一個根據傳入參數（即學生學號）來查詢學生信息的 Function，示例如下：

use Test
go

create function dbo.SearchStuInfo(@Stu_No varchar(50)='001')
returns table
as
return(
select S_StuNo,S_Name,S_Sex,S_Height,S_BirthDate 
from Student where S_StuNo=@Stu_No)
go

執行用戶自定義內嵌表值函數：

select * from dbo.SearchStuInfo(default);    --返回學號為 001 的學生信息

select * from dbo.SearchStuInfo('008');        --返回學號為 008 的學生信息

 

創建多聲明表值函數的語法：

create function [函數的所有者].函數名(標量參數 [as] 標量參數類型 [=默認值])
returns @表變量 table 表的定義(即列的定義和約束)
[with {Encryption | Schemabinding }]
[as]
begin
    函數體(即 Transact-SQL 語句)
    return
end

下面自定義一個根據傳入參數（即學生學號）來查詢學生信息和課程，並計算出該學生的身高是否大於所有學生的平均身高的 Function，示例如下：

use Test
go

create function dbo.SearchStuCou(@StuN varchar(10)='001')
returns @StuInfo table (
    StuNo varchar(50) not null primary key,
    StuName varchar(10) not null,
    StuSex  varchar(10) not null,
    StuHeight varchar(10) null,
    StuAvgHeight decimal(10,2) null,
    StuConAvgHeight varchar(30) null,
    StuCou varchar(10) null
)
as
begin
    declare @Height decimal(10,2)
    declare @AvgHeight decimal(10,2)
    declare @ConAvgHeight varchar(30)

    select @AvgHeight=AVG(Convert(decimal(10,2),S_Height))        --查詢所有同學的平均身高
    from Student 

    select @Height=Convert(decimal(10,2),S_Height)        --查詢指定學號的學生身高
    from Student 
    where S_StuNo=@StuN

    if((@Height-@AvgHeight) > Convert(decimal(10,2),0))
    begin
        set @ConAvgHeight='大於平均身高'
    end
    else if((@Height-@AvgHeight) = Convert(decimal(10,2),0))
    begin
        set @ConAvgHeight='等於平均身高'
    end
    else
    begin
        set @ConAvgHeight='小於平均身高'
    end

    insert into @StuInfo(StuNo,StuName,StuSex,StuHeight,StuAvgHeight,StuConAvgHeight,StuCou)
    select s.S_StuNo,s.S_Name,s.S_Sex,s.S_Height,@AvgHeight,@ConAvgHeight,c.C_Name from Student s 
    left join Course c on s.C_S_Id=c.C_Id
    where S_StuNo=@StuN 

    return
end
go

執行用戶自定義多聲明表值函數：

select * from dbo.SearchStuCou(default);

select * from dbo.SearchStuCou('015');

select * from dbo.SearchStuCou('009');

適用范圍

1.      只查詢，不修改數據庫的狀態（修改、刪除表中記錄等）

2.      結果集需要通過遞歸等方法得到時，可以使用函數，函數比較靈活

3.      結果集需要直接被引用時，可以使用函數。需要對結果集進行再加工（指放在select語句中等），可以使用函數，函數可以嵌在select等sql語句中。

注意事項：

用戶自定義函數不能用於執行一系列改變數據庫狀態的操作

在編寫自定義函數時需要注意的：

對於標量函數：

1.      所有的入參前都必須加@

2.      create后的返回，單詞是returns，而不是return

3.      returns后面的跟的不是變量，而是返回值的類型，如：int，char等。

4.      在begin/end語句塊中，是return。

內嵌表值函數：

1.      只能返回table，所以returns后面一定是TABLE

2.      AS后沒有begin/end，只有一個return語句來返回特定的記錄。

多語句表值函數：

1.      returns后面直接定義返回的表類型，首先是定義表名，表明前面要加@，然后是關鍵字TABLE，最后是表的結構。

2.      在begin/end語句塊中，直接將需要返回的結果insert到returns定義的表中就可以了，在最后return時，會將結果返回。

3.      最后只需要return，return后面不跟任何變量。

參考：

http://www.cnblogs.com/xueyuangudiao/archive/2011/08/03/2126580.html