修改標量值函數註意事項 更改先前通過執行 CREATE FUNCTION 語句創建的現有 Transact-SQL 或 CLR 函數,但不更改許可權,也不影響任何相關的函數、存儲過程或觸發器。 不能用 ALTER FUNCTION 將標量值函數更改為表值函數。反之亦然。 不能使用 ALTER FUNC ...
修改標量值函數註意事項
更改先前通過執行 CREATE FUNCTION 語句創建的現有 Transact-SQL 或 CLR 函數,但不更改許可權,也不影響任何相關的函數、存儲過程或觸發器。
不能用 ALTER FUNCTION 將標量值函數更改為表值函數。反之亦然。
不能使用 ALTER FUNCTION 將 Transact-SQL 函數更改為 CLR 函數。反之亦然。
需要對函數或架構具有 ALTER 許可權。 如果函數指定用戶定義類型,則需要對該類型具有 EXECUTE 許可權。
SSMS資料庫管理工具修改標量值函數語法和T-SQL腳本修改標量值函數語法相同。
下列 Service Broker 語句不能包含在 Transact-SQL 用戶定義函數的定義中:
- BEGIN DIALOG CONVERSATION
- END CONVERSATION
- GET CONVERSATION GROUP
- MOVE CONVERSATION
- RECEIVE
- SEND
使用T-SQL腳本修改標量值函數
語法:
--聲明資料庫引用
use 資料庫名;
go
--修改標量值函數
alter function [schema_name.] function_name
(@parameter_name [as] [type_schema_name.] parameter_data_type [ = default ] [ readonly],..n)
returns return_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 AUTHORITY\LocalService、NT AUTHORITY\NetworkService 或 NT AUTHORITY\LocalSystem。
--執行上下文的用戶 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 AUTHORITY\LocalService、NT AUTHORITY\NetworkService 或 NT AUTHORITY\LocalSystem。
--function_body
--指定一系列定義函數值的 Transact-SQL 語句,這些語句在一起使用不會產生負面影響(例如修改表)。 function_body 僅用於標量函數和多語句表值函數。
--在標量函數中,function_body 是一系列 Transact-SQL 語句,這些語句一起使用可計算出標量值。
--在多語句表值函數中,function_body 是一系列 Transact-SQL 語句,這些語句將填充 TABLE 返回變數。
--scalar_expression
--指定標量函數返回的標量值。
語法調用:
select [架構名].[函數名稱](參數值,...n);
示例:
--聲明資料庫引用
use testss;
go
--修改資料庫
alter function [dbo].[noreferencepro1](@num1 int,@num2 int)
returns int
with encryption,schemabinding,called on null input,execute as self
as
begin
declare @sum int;
if @num1 is not null and @num2 is not null
set @sum=@num1+@num2;
else if @num1 is not null
set @sum=@num1;
else if @num2 is not null
set @sum=@num2;
else
set @sum=0;
return @sum;
end;
go
示例結果:依次顯示修改結果和調用結果。