共用方式為

ALTER FUNCTION (Transact-SQL)

  • 發行項

改變先前執行 CREATE FUNCTION 陳述式所建立的現有 Transact-SQL 或 CLR 函數，而不變更權限及不影響任何相依的函數、預存程序或觸發程序。

主題連結圖示Transact-SQL 語法慣例

語法

Scalar Functions
ALTER FUNCTION [ schema_name. ] function_name 
( [ { @parameter_name [ AS ][ type_schema_name. ] parameter_data_type 
    [ = default ] } 
    [ ,...n ]
  ]
)
RETURNS return_data_type
    [ WITH <function_option> [ ,...n ] ]
    [ AS ]
    BEGIN 
                function_body 
        RETURN scalar_expression
    END
[ ; ]

Inline Table-valued Functions
ALTER FUNCTION [ schema_name. ] function_name 
( [ { @parameter_name [ AS ] [ type_schema_name. ] parameter_data_type 
    [ = default ] } 
    [ ,...n ]
  ]
)
RETURNS TABLE
    [ WITH <function_option> [ ,...n ] ]
    [ AS ]
    RETURN [ ( ] select_stmt [ ) ]
[ ; ]

Multistatement Table-valued Functions
ALTER FUNCTION [ schema_name. ] function_name 
( [ { @parameter_name [ AS ] [ type_schema_name. ] parameter_data_type 
    [ = default ] } 
    [ ,...n ]
  ]
)
RETURNS @return_variable TABLE <table_type_definition>
    [ WITH <function_option> [ ,...n ] ]
    [ AS ]
    BEGIN 
                function_body 
        RETURN
    END
[ ; ]

CLR Functions
ALTER FUNCTION [ schema_name. ] function_name 
( { @parameter_name [AS] [ type_schema_name. ] parameter_data_type 
        [ = default ] } 
    [ ,...n ]
)
RETURNS { return_data_type | TABLE <clr_table_type_definition> }
    [ WITH <clr_function_option> [ ,...n ] ]
    [ AS ] EXTERNAL NAME <method_specifier>
[ ; ]

<method_specifier>::=
        assembly_name.class_name.method_name

Function Options
<function_option>::= 
{
    [ ENCRYPTION ]
  | [ SCHEMABINDING ]
  | [ RETURNS NULL ON NULL INPUT | CALLED ON NULL INPUT ]
  | [ EXECUTE_AS_Clause ]
}

<clr_function_option>::=
}
    [ RETURNS NULL ON NULL INPUT | CALLED ON NULL INPUT ]
  | [ EXECUTE_AS_Clause ]
}

Table Type Definitions
<table_type_definition>:: = 
( { <column_definition> <column_constraint> 
  | <computed_column_definition> } 
        [ <table_constraint> ] [ ,...n ]
) 

<clr_table_type_definition>:: = 
( { column_name data_type } [ ,...n ] )

<column_definition>::=
{
    { column_name data_type }
    [ [ DEFAULT constant_expression ] 
      [ COLLATE collation_name ] | [ ROWGUIDCOL ]
    ]
    | [ IDENTITY [ (seed , increment ) ] ]
    [ <column_constraint> [ ...n ] ] 
}
<column_constraint>::= 
{
    [ NULL | NOT NULL ] 
    { PRIMARY KEY | UNIQUE }
      [ CLUSTERED | NONCLUSTERED ] 
        [ WITH FILLFACTOR = fillfactor 
        | WITH ( < index_option > [ , ...n ] )
            [ ON { filegroup | "default" } ]
  | [ CHECK ( logical_expression ) ] [ ,...n ]
}

<computed_column_definition>::=
column_name AS computed_column_expression 

<table_constraint>::=
{ 
    { PRIMARY KEY | UNIQUE }
      [ CLUSTERED | NONCLUSTERED ] 
            ( column_name [ ASC | DESC ] [ ,...n ] )
        [ WITH FILLFACTOR = fillfactor 
        | WITH ( <index_option> [ , ...n ] )
  | [ CHECK ( logical_expression ) ] [ ,...n ]
}

<index_option>::=
{ 
       PAD_INDEX = { ON | OFF }   | FILLFACTOR = fillfactor 
  | IGNORE_DUP_KEY = { ON | OFF }
  | STATISTICS_NORECOMPUTE = { ON | OFF } 
  | ALLOW_ROW_LOCKS = { ON | OFF }
  | ALLOW_PAGE_LOCKS ={ ON | OFF } 
}

引數

  • schema_name
    這是使用者自訂函數所屬的結構描述名稱。

  • function_name
    這是要變更的使用者自訂函數。

    ms186967.note(zh-tw,SQL.90).gif附註：
    即使沒有指定參數，函數名稱後面仍需要括號。

  • **@**parameter_name
    這是使用者自訂函數中的參數。可以宣告一或多個參數。

    函數最多可以有 1,024 個參數。除非定義了參數的預設值，否則，在執行函數時，使用者必須提供每個已宣告參數的值。

    使用 @ 記號 (@) 作為第一個字元，來指定參數名稱。參數名稱必須符合識別碼的規則。對函數而言，參數必須是本機參數；相同的參數名稱可以用在其他函數中。參數只能取代常數，不能用來取代資料表名稱、資料行名稱或其他資料庫物件的名稱。

    ms186967.note(zh-tw,SQL.90).gif附註：
    當在預存程序或使用者自訂函數中傳遞參數時，或在批次陳述式中宣告和設定變數時，會忽略 ANSI_WARNINGS。例如，如果變數定義為 char(3)，然後又設為超過 3 個字元的值，就會將資料截斷成定義的大小，INSERT 或 UPDATE 陳述式會繼續運作。

  • [ type_schema_name. ] parameter_data_type
    這是參數資料類型，對於其所屬的結構描述則視情況而定。就 Transact-SQL 函數而言，除了 timestamp 資料類型以外，其他所有資料類型 (包括 CLR 使用者自訂類型) 都是允許的資料類型。就 CLR 函數而言，除了 text、ntext、image 及 timestamp 資料類型以外，其他所有資料類型都是允許的資料類型。非純量類型 cursor 和 table 不能指定為 Transact-SQL 或 CLR 函數中的參數資料類型。

    如果未指定 type_schema_name，SQL Server 2005 Database Engine 會依照下列順序來尋找 parameter_data_type：

    • 內含 SQL Server 系統資料類型的結構描述。
    • 目前資料庫中之目前使用者的預設結構描述。
    • 目前資料庫的 dbo 結構描述。

  • [ **=**default ]
    這是參數的預設值。如果定義了 default 值，不必指定該參數的值就可以執行函數。

    ms186967.note(zh-tw,SQL.90).gif附註：
    可以針對 CLR 函數指定預設參數值，但 varchar(max) 和 varbinary(max) 資料類型除外。

    如果函數的參數有預設值，則必須在呼叫函數來擷取該預設值時指定關鍵字 DEFAULT。這個行為與使用預存程序中具有預設值的參數不一樣，因為，在預存程序中，省略參數也意味著使用預設值。

  • return_data_type
    這是純量使用者自訂函數的傳回值。就 Transact-SQL 函數而言，除了 timestamp 資料類型以外，其他所有資料類型 (包括 CLR 使用者自訂類型) 都是允許的資料類型。就 CLR 函數而言，除了 text、ntext、image 及 timestamp 資料類型以外，其他所有資料類型都是允許的資料類型。非純量類型 cursor 和 table 不能指定為 Transact-SQL 或 CLR 函數中的傳回資料類型。

  • function_body
    指定 Transact-SQL 陳述式序列 (這些陳述式聯合後不會產生資料表修改之類的副作用) 負責定義函數的值。function_body 只能用在純量函數和多重陳述式資料表值函數中。

    在純量函數中，function_body 是 Transact-SQL 陳述式序列，這些陳述式聯合評估為純量值。

    在多重陳述式資料表值函數中，function_body 是 Transact-SQL 陳述式序列，這些陳述式會擴展 TABLE 傳回變數。

  • scalar_expression
    指定純量函數傳回純量值。

  • TABLE
    指定資料表值函數的傳回值是資料表。只有常數和 **@**local_variables 可傳遞至資料表值函數。

    在內嵌資料表值函數中，TABLE 傳回值是利用單一 SELECT 陳述式來定義的。內嵌函數沒有相關聯的傳回變數。

    在多重陳述式資料表值函數中，**@**return_variable 是一個 TABLE 變數，可用來儲存及累積應被傳回作為函數值的資料列。只能為 Transact-SQL 函數 (不能為 CLR 函數) 指定 **@**return_variable。

  • select-stmt
    這是單一 SELECT 陳述式，可定義內嵌資料表值函數的傳回值。

  • EXTERNAL NAME <method_specifier>, assembly_name.class_name.method_name
    指定組件與函數繫結的方法。assembly_name 必須符合目前資料庫之 SQL Server 中的現有組件且可以看見。class_name 必須是有效的 SQL Server 識別碼，且必須作為類別存在於組件中。如果該類別的名稱符合命名空間，且該名稱利用句點 (.) 來分隔命名空間的各個部份，您就必須使用方括號 ([]) 或引號 ("") 來分隔類別名稱。method_name 必須是有效的 SQL Server 識別碼，且必須以指定類別中的靜態方法存在。

    ms186967.note(zh-tw,SQL.90).gif附註：
    依預設，SQL Server 不能執行 CLR 程式碼。您可以建立、修改和卸除參考 Common Language Runtime 模組的資料庫物件；不過，在啟用 clr enabled 選項之前，您無法在 SQL Server 中執行這些參考。若要啟用這個選項，請使用 sp_configure。
  • <table_type_definition>, ( { <column_definition> <column_constraint> ,   | <computed_column_definition> } ,   [ <table_constraint> ] [ ,...n ], ) ,
    定義 Transact-SQL 函數的資料表資料類型。資料表宣告包括資料行定義和資料行或資料表條件約束。
  • < clr_table_type_definition > , ( { column_namedata_type } [ ,...n ] ),
    定義 CLR 函數的資料表資料類型。資料表宣告只包含資料行名稱和資料類型。

<function_option>::= and <clr_function_option>::=

指定函數必須有下列其中一或多個選項。

  • ENCRYPTION
    指出 Database Engine 會對包含 ALTER FUNCTION 陳述式文字的目錄檢視資料行進行加密。使用 ENCRYPTION 可防止在 SQL Server 複寫中發行這個函數。無法為 CLR 函數指定 ENCRYPTION。

  • SCHEMABINDING
    指定函數必須繫結到參考的資料庫物件。如果其他結構描述繫結的物件正在參考函數，這個條件可防止對函數進行變更。

    只有在下發生下列其中一個動作時，才會移除函數與其參考的物件之間的繫結。

    • 已卸除這個函數。
    • 您可以利用未指定 SCHEMABINDING 選項的 ALTER 陳述式來修改函數。

    如需函數成為結構描述繫結所必須符合的條件清單，請參閱＜CREATE FUNCTION (Transact-SQL)＞。

    無法為 CLR 函數或參考別名資料類型的函數指定 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> 中指定的方法已經有一個指出 RETURNS NULL ON NULL INPUT 的自訂屬性，但 ALTER FUNCTION 陳述式卻指出 CALLED ON NULL INPUT，則優先使用 ALTER FUNCTION 陳述式。無法為 CLR 資料表值函數指定 OnNULLCall 屬性。

  • EXECUTE AS 子句
    指定執行使用者自訂函數時所在的安全性內容。因此，您可以控制 SQL Server 要利用哪個使用者帳戶來驗證在函數參考的任何資料庫物件上的權限。

    ms186967.note(zh-tw,SQL.90).gif附註：
    無法為內嵌使用者自訂函數指定 EXECUTE AS。

    如需詳細資訊，請參閱＜EXECUTE AS 子句 (Transact-SQL)＞。

< column_definition >::=

定義資料表資料類型。資料表宣告包括資料行定義和條件約束。針對 CLR 函數，只能指定 column_name 和 data_type。

  • column_name
    這是資料表的資料行名稱。資料行名稱必須符合識別碼規則，且在資料表中必須是唯一的。column_name 可以有 1 到 128 個字元。
  • data_type
    指定資料行資料類型。就 Transact-SQL 函數而言，除了 timestamp 以外，其他所有資料類型 (包括 CLR 使用者自訂類型) 都是允許的資料類型。就 CLR 函數而言，除了 text、ntext、image、char、varchar、varchar(max) 及 timestamp 以外，其他所有資料類型都是允許的資料類型。無法指定非純量類型 cursor 作為 Transact-SQL 或 CLR 函數中的資料行資料類型。
  • DEFAULT constant_expression
    指定在插入期間未明確提供值時，提供給資料行的值。constant_expression 是常數、NULL 或系統函數值。除了含有 IDENTITY 屬性的資料行之外，任何資料行都可以套用 DEFAULT 定義。無法為 CLR 資料表值函數指定 DEFAULT。

  • COLLATE collation_name
    指定資料行的定序。若未指定，就會將資料庫的預設定序指派給資料行。定序名稱可以是 Windows 定序名稱或 SQL 定序名稱。如需清單和詳細資訊，請參閱＜Windows 定序名稱 (Transact-SQL)＞和＜SQL 定序名稱 (Transact-SQL)＞。

    COLLATE 子句只可用來變更 char、varchar、nchar 及 nvarchar 資料類型之資料行的定序。

    無法為 CLR 資料表值函數指定 COLLATE。

  • ROWGUIDCOL
    指出新資料行是一個資料列全域唯一識別碼資料行。每份資料表都只能有一個 uniqueidentifier 資料行指定為 ROWGUIDCOL 資料行。ROWGUIDCOL 屬性只能指派給 uniqueidentifier 資料行。

    ROWGUIDCOL 屬性不會強制執行資料行所儲存之值的唯一性。它也不自動為插入資料表中的新資料列產生值。若要為每個資料行產生唯一值，請在 INSERT 陳述式上使用 NEWID 函數。可以指定預設值；不過，NEWID 不能指定為預設值。

  • IDENTITY
    指出新資料行是識別資料行。當新資料列加入資料表時，SQL Server 會提供資料行的唯一累加值。識別資料行通常用來搭配 PRIMARY KEY 條件約束一起使用，作為資料表的唯一資料列識別碼。IDENTITY 屬性可以指派給 tinyint、smallint、int、bigint、decimal(p,0) 或 numeric(p,0) 等資料行。每份資料表都只能建立一個識別資料行。繫結的預設值和 DEFAULT 條件約束，無法搭配識別資料行來使用。您必須同時指定 seed 和 increment，或同時不指定這兩者。如果同時不指定這兩者，預設值便是 (1,1)。

    無法為 CLR 資料表值函數指定 IDENTITY。

    • seed
      這是要指派給資料表中第一個資料列的整數值。
    • increment
      這是要加入資料表中後續資料列之 seed 值的整數值。

< column_constraint >::= and < table_constraint>::=

定義指定資料行或資料表的條件約束。就 CLR 函數而言，唯一允許的條件約束類型是 NULL。不允許具名條件約束。

  • NULL | NOT NULL
    判斷資料行中是否允許 Null 值。NULL 並不嚴格算是條件約束，您也可以如同指定 NOT NULL 來指定它。無法為 CLR 資料表值函數指定 NOT NULL。
  • PRIMARY KEY
    這是一項條件約束，它利用唯一索引強制執行指定資料行的實體完整性。在資料表值使用者自訂函數中，PRIMARY KEY 條件約束只能建立在每份資料表的一個資料行上。無法為 CLR 資料表值函數指定 PRIMARY KEY。
  • UNIQUE
    這是一項條件約束，它利用唯一索引為指定資料行提供實體完整性。一份資料表可以有多項 UNIQUE 條件約束。無法為 CLR 資料表值函數指定 UNIQUE。

  • CLUSTERED | NONCLUSTERED
    指出針對 PRIMARY KEY 或 UNIQUE 條件約束建立叢集或非叢集索引。PRIMARY KEY 條件約束使用 CLUSTERED，UNIQUE 條件約束則使用 NONCLUSTERED。

    只能為一個條件約束指定 CLUSTERED。如果針對 UNIQUE 條件約束指定 CLUSTERED，且指定了 PRIMARY KEY 條件約束，則 PRIMARY KEY 會使用 NONCLUSTERED。

    無法為 CLR 資料表值函數指定 CLUSTERED 和 NONCLUSTERED。

  • CHECK
    這是一個條件約束，藉由限制可能輸入一或多個資料行的值，強制執行範圍完整性。無法為 CLR 資料表值函數指定 CHECK 條件約束。

    • logical_expression
      這是一個傳回 TRUE 或 FALSE 的邏輯運算式。

<computed_column_definition>::=

指定計算資料行。如需有關計算資料行的詳細資訊，請參閱＜CREATE TABLE (Transact-SQL)＞。

  • column_name
    這是計算資料行的名稱。
  • computed_column_expression
    這是定義計算資料行值的運算式。

<index_option>::=

指定 PRIMARY KEY 或 UNIQUE 索引的索引選項。如需有關索引選項的詳細資訊，請參閱＜CREATE INDEX (Transact-SQL)＞。

  • PAD_INDEX = { ON | OFF }
    指定索引填補。預設值是 OFF。
  • FILLFACTOR = fillfactor
    指定百分比來指出在建立或變更索引期間，Database Engine 應該使各索引頁面之分葉層級填滿的程度。fillfactor 必須是 1 至 100 之間的整數值。預設值是 0。
  • IGNORE_DUP_KEY = { ON | OFF }
    指定在唯一叢集或唯一非叢集索引的多資料列插入交易中，對於索引鍵值重複的錯誤回應。預設值是 OFF。
  • STATISTICS_NORECOMPUTE = { ON | OFF }
    指定是否要重新計算散發統計資料。預設值是 OFF。
  • ALLOW_ROW_LOCKS = { ON | OFF }
    指定是否允許資料列鎖定。預設值是 ON。
  • ALLOW_PAGE_LOCKS = { ON | OFF }
    指定是否允許頁面鎖定。預設值是 ON。

備註

ALTER FUNCTION 不能用來將純量值函數變更為資料表值函數，反之亦然。另外，ALTER FUNCTION 也不能用來將內嵌函數變更為多重陳述式函數，反之亦然。ALTER FUNCTION 不能用來將 Transact-SQL 函數變更為 CLR 函數，反之亦然。

下列 Service Broker 陳述式不能併入 Transact-SQL 使用者自訂函數的定義中：

  • BEGIN DIALOG CONVERSATION
  • END CONVERSATION
  • GET CONVERSATION GROUP
  • MOVE CONVERSATION
  • RECEIVE
  • SEND

權限

需要函數或結構描述的 ALTER 權限。如果函數指定使用者自訂類型，則需要在該類型上的 EXECUTE 權限。

請參閱

參考

CREATE FUNCTION (Transact-SQL)
DROP FUNCTION (Transact-SQL)
EVENTDATA (Transact-SQL)

其他資源

使用者自訂函數 (Database Engine)
對發行集資料庫進行結構描述變更

說明及資訊

取得 SQL Server 2005 協助