1. 程式人生 > >SQLServer之修改標量值函式

SQLServer之修改標量值函式

修改標量值函式注意事項

更改先前通過執行 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
--使用者定義函式的名稱。 函式名稱必須符合識別符號規則,並且在資料庫中以及對其架構來說是唯一的,即使未指定引數,函式名稱後也需要加上括號。

[email protected]

_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 @[email protected][email protected];
else if @num1 is not null
set @[email protected];
else if @num2 is not null
set @[email protected];
else
set @sum=0;
return @sum;
end;
go

示例結果:依次顯示修改結果和呼叫結果。