創建標量函數注意事項

在SQL Server和Azure SQL Database中創建用戶定義函數。用戶定義函數是接受參數、執行操作（例如復雜計算）并將操作結果以值的形式返回的Transact-SQL或公共語言運行時 (CLR) 例程。返回值可以是標量（單個）值或表。使用此語句可以創建可通過以下方式使用的重復使用的例程：

在Transact-SQL語句（如 SELECT）中

在調用該函數的應用程序中

在另一個用戶定義函數的定義中

用于參數化視圖或改進索引視圖的功能

用于在表中定義列

用于為列定義 CHECK 約束

用于替換存儲過程

使用內聯函數作為安全策略的篩選器謂詞

可在使用標量表達式的位置調用標量值函數。這包括計算列和 CHECK 約束定義。也可以使用EXECUTE語句執行標量值函數。必須使用至少由兩部分組成名稱的函數來調用標量值函數。

需要在數據庫中具有 CREATE FUNCTION 權限，并對創建函數時所在的架構具有 ALTER 權限。如果函數指定用戶定義類型，則需要對該類型具有 EXECUTE 權限。

使用SSMS數據庫管理工具和T-SQL腳本創建標量函數語法相同，本示例演示使用T-SQL腳本創建標量函數。

使用T-SQL腳本創建標量函數

語法：

--聲明數據庫引用

use 數據庫名;

go

--判斷是否存在需要創建的函數，如果存在則刪除

if exists(select * from sys.objects where name=函數名稱)

drop function 函數名稱;

go

--創建用戶自定義函數

create function[schema_name.] function_name

(@parameter_name [as] [type_schema_name.] parameter_data_type [ = default ] [ readonly],..n)

returnsreturn_data_type

[with] [encryption][,][schemabinding][,][returns null on null input | called on null input][,][execute as Clause]

as

begin

function_body;

return scalar_expression;

end

go

語法解析：

--schema_name
--用戶定義函數所屬的架構的名稱。

--function_name
--用戶定義函數的名稱。 函數名稱必須符合標識符規則，并且在數據庫中以及對其架構來說是唯一的,即使未指定參數，函數名稱后也需要加上括號。

--@parameter_name
--用戶定義函數中的參數。 可聲明一個或多個參數。
--一個函數最多可以有 2,100 個參數。 執行函數時，如果未定義參數的默認值，則用戶必須提供每個已聲明參數的值。
--通過將 at 符號 (@) 用作第一個字符來指定參數名稱。 參數名稱必須符合標識符規則。 參數是對應于函數的局部參數；其他函數中可使用相同的參數名稱。
--參數只能代替常量，而不能用于代替表名、列名或其他數據庫對象的名稱。

--[ type_schema_name. ] parameter_data_type
--參數的數據類型及其所屬的架構，后者為可選項。 對于 Transact-SQL 函數，允許使用除 timestamp 數據類型之外的所有數據類型（包括 CLR 用戶定義類型和用戶定義表類型）。
--對于 CLR 函數，允許使用除 text、ntext、image、用戶定義表類型和 timestamp 數據類型之外的所有數據類型（包括 CLR 用戶定義類型）。 在 Transact-SQL 函數或 CLR 函數中，
--不能將非標量類型 cursor 和 table 指定為參數數據類型。
--如果未指定 type_schema_name， 數據庫引擎會按以下順序查找 scalar_parameter_data_type：
--包含 SQL Server 系統數據類型名稱的架構。
--當前數據庫中當前用戶的默認架構。
--當前數據庫中的 dbo 架構。

--[ =default ]
--參數的默認值。 如果定義了 default 值，則無需指定此參數的值即可執行函數。
--如果函數的參數有默認值，則調用該函數以檢索默認值時，必須指定關鍵字 DEFAULT。 此行為與在存儲過程中使用具有默認值的參數不同，在后一種情況下，不提供參數同樣意味著使用默認值。
--但在通過使用 EXECUTE 語句調用標量函數時，DEFAULT 關鍵字不是必需的。

--readonly
--指示不能在函數定義中更新或修改參數。 如果參數類型為用戶定義的表類型，則應指定 READONLY。

--return_data_type
--標量用戶定義函數的返回值。 對于 Transact-SQL 函數，可以使用除 timestamp 數據類型之外的所有數據類型（包括 CLR 用戶定義類型）。
--對于 CLR 函數，允許使用除 text、ntext、image 和 timestamp 數據類型之外的所有數據類型（包括 CLR 用戶定義類型）。 在 Transact-SQL 函數或 CLR 函數中，不能將非標量類型 cursor 和 table 指定為返回數據類型。

--encryption
--適用范圍： SQL Server 2008 到 SQL Server 2017。
--指示 數據庫引擎會將 CREATE FUNCTION 語句的原始文本轉換為模糊格式。 模糊代碼的輸出在任何目錄視圖中都不能直接顯示。 對系統表或數據庫文件沒有訪問權限的用戶不能檢索模糊文本。
--但是，可以通過 DAC 端口訪問系統表的特權用戶或直接訪問數據庫文件的特權用戶可以使用此文本。 此外，能夠向服務器進程附加調試器的用戶可在運行時從內存中檢索原始過程。
--使用此選項可防止將函數作為 SQL Server 復制的一部分發布。 不能為 CLR 函數指定此選項。

--schemabinding
--指定將函數綁定到其引用的數據庫對象。 如果指定了 SCHEMABINDING，則不能按照將影響函數定義的方式修改基對象。 必須首先修改或刪除函數定義本身，才能刪除將要修改的對象的依賴關系。

--returns null on null input | called on null input
--指定標量值函數的 OnNULLCall 屬性。 如果未指定，則默認為 CALLED ON NULL INPUT。 這意味著即使傳遞的參數為 NULL，也將執行函數體。
--如果在 CLR 函數中指定了 RETURNS NULL ON NULL INPUT，它指示當 SQL Server 接收到的任何一個參數為 NULL 時，它可以返回 NULL，而無需實際調用函數體。 如果 <method_specifier> 中指定的 CLR 函數的方法已具有指示 RETURNS NULL ON NULL INPUT 的自定義屬性，
--但 CREATE FUNCTION 語句指示 CALLED ON NULL INPUT，則優先采用 CREATE FUNCTION 語句指示的屬性。 不能為 CLR 表值函數指定 OnNULLCall 屬性。

--execute as 子句
--對于本機編譯的標量用戶定義函數，EXECUTE AS 是必需的。
--SELF
--EXECUTE AS SELF 與 EXECUTE AS user_name 等價，其中指定用戶是創建或更改模塊的用戶。 創建或更改模塊的用戶的實際用戶 ID 存儲在 sys.sql_modules 或 sys.service_queues 目錄視圖的 execute_as_principal_id 列中。
--OWNER
--指定模塊內的語句在模塊的當前所有者上下文中執行。 如果模塊沒有指定的所有者，則使用模塊架構的所有者。 不能為 DDL 或登錄觸發器指定 OWNER。
--' user_name '
--指定模塊內的語句在 user_name 指定的用戶的上下文中執行。 將根據 user_name 來驗證對模塊內任意對象的權限。 不能為具有服務器作用域的 DDL 觸發器或登錄觸發器指定 user_name。 請改用 login_name。
--user_name 必須存在于當前數據庫中，并且必須是單一實例帳戶。 user_name 不能為組、角色、證書、密鑰或內置帳戶，如 NT AUTHORITYLocalService、NT AUTHORITYNetworkService 或 NT AUTHORITYLocalSystem。
--執行上下文的用戶 ID 存儲在元數據中，可以在 sys.sql_modules 或 sys.assembly_modules 目錄視圖的 execute_as_principal_id 列查看。
--' login_name '
--指定模塊內的語句在 login_name 指定的 SQL Server 登錄的上下文中執行。 將根據 login_name 來驗證對模塊內任意對象的權限。 只能為具有服務器作用域的 DDL 觸發器或登錄觸發器指定 login_name。
--login_name 不能為組、角色、證書、密鑰或內置帳戶，如 NT AUTHORITYLocalService、NT AUTHORITYNetworkService 或 NT AUTHORITYLocalSystem。

--function_body
--指定一系列定義函數值的 Transact-SQL 語句，這些語句在一起使用不會產生負面影響（例如修改表）。 function_body 僅用于標量函數和多語句表值函數。
--在標量函數中，function_body 是一系列 Transact-SQL 語句，這些語句一起使用可計算出標量值。
--在多語句表值函數中，function_body 是一系列 Transact-SQL 語句，這些語句將填充 TABLE 返回變量。

--scalar_expression
--指定標量函數返回的標量值。

示例：

--聲明數據庫引用
use testss;
go

--判斷是否存在需要創建的函數，如果存在則刪除
if exists(select * from sys.objects where name='scalarfun')
drop function scalarfun;
go

--創建用戶自定義函數
create function dbo.scalarfun
(@num1 int,@num2 int,@num3 int =null)
returns int
--with encryption,schemabinding,returns null on null input,execute as owner
as
begin
declare @sum1 int=null;
if (@num1 is not null) and (@num2 is not null)
set @sum1=@num1+@num2;
else if (@num1 is not null)
set @sum1=@num1;
else if (@num2 is not null)
set @sum1=@num2;
else
set @sum1=0;
return @sum1;
end
go

示例結果：依次顯示創建結果和調用結果。

總結

以上是生活随笔為你收集整理的SQLServer之创建标量函数的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。