CREATE FUNCTION sqlserver用户定义函数

2024-08-31 00:44:48

字体：大中小

来源：转载

供稿：网友

创建用户定义函数，它是返回值的已保存的 Transact-SQL 例程。用户定义函数不能用于执行一组修改全局数据库状态的操作。与系统函数一样，用户定义函数可以从查询中唤醒调用。也可以像存储过程一样，通过 EXECUTE 语句执行。
用户定义函数用 ALTER FUNCTION 修改，用 DROP FUNCTION 除去。

语法
标量函数

CREATE FUNCTION [ owner_name.] function_name
( [ { @parameter_name [AS] scalar_parameter_data_type [ = default ] } [ ,...n ] ] )
RETURNS scalar_return_data_type
[ WITH < function_option> [ [,] ...n] ]
[ AS ]
BEGIN
function_body
RETURN scalar_expression
END

内嵌表值函数

CREATE FUNCTION [ owner_name.] function_name
( [ { @parameter_name [AS] scalar_parameter_data_type [ = default ] } [ ,...n ] ] )
RETURNS TABLE
[ WITH < function_option > [ [,] ...n ] ]
[ AS ]
RETURN [ ( ] select-stmt [ ) ]

多语句表值函数

CREATE FUNCTION [ owner_name.] function_name
( [ { @parameter_name [AS] scalar_parameter_data_type [ = default ] } [ ,...n ] ] )
RETURNS @return_variable TABLE < table_type_definition >
[ WITH < function_option > [ [,] ...n ] ]
[ AS ]
BEGIN
function_body
RETURN
END
< function_option > ::=
{ ENCRYPTION | SCHEMABINDING }
< table_type_definition > ::=
( { column_definition | table_constraint } [ ,...n ] )

参数
owner_name
拥有该用户定义函数的用户 ID 的名称。owner_name 必须是现有的用户 ID。
function_name
用户定义函数的名称。函数名称必须符合标识符的规则，对其所有者来说，该名称在数据库中必须是唯一的。
@parameter_name
用户定义函数的参数。CREATE FUNCTION 语句中可以声明一个或多个参数。函数最多可以有 1,024 个参数。函数执行时每个已声明参数的值必须由用户指定，除非该参数的默认值已经定义。如果函数的参数有默认值，在调用该函数时必须指定"default"关键字才能获得默认值。这种行为不同于存储过程中有默认值的参数，在存储过程中省略参数也意味着使用默认值。
使用 @ 符号作为第一个字符来指定参数名称。参数名称必须符合标识符的规则。每个函数的参数仅用于该函数本身；相同的参数名称可以用在其它函数中。参数只能代替常量；而不能用于代替表名、列名或其它数据库对象的名称。
scalar_parameter_data_type
参数的数据类型。所有标量数据类型（包括 bigint 和 sql_variant）都可用作用户定义函数的参数。不支持 timestamp 数据类型和用户定义数据类型。不能指定非标量类型（例如 cursor 和 table）。
scalar_return_data_type
是标量用户定义函数的返回值。scalar_return_data_type 可以是 SQL Server 支持的任何标量数据类型（text、ntext、image 和 timestamp 除外）。
scalar_expression
指定标量函数返回的标量值。
TABLE
指定表值函数的返回值为表。
在内嵌表值函数中，通过单个 SELECT 语句定义 TABLE 返回值。内嵌函数没有相关联的返回变量。
在多语句表值函数中，@return_variable 是 TABLE 变量，用于存储和累积应作为函数值返回的行。
function_body
指定一系列 Transact-SQL 语句定义函数的值，这些语句合在一起不会产生副作用。function_body 只用于标量函数和多语句表值函数。
在标量函数中，function_body 是一系列合起来求得标量值的 Transact-SQL 语句。
在多语句表值函数中，function_body 是一系列填充表返回变量的 Transact-SQL 语句。
select-stmt
是定义内嵌表值函数返回值的单个 SELECT 语句。
ENCRYPTION
指出 SQL Server 加密包含 CREATE FUNCTION 语句文本的系统表列。使用 ENCRYPTION 可以避免将函数作为 SQL Server 复制的一部分发布。
SCHEMABINDING
指定将函数绑定到它所引用的数据库对象。如果函数是用 SCHEMABINDING 选项创建的，则不能更改（使用 ALTER 语句）或除去（使用 DROP 语句）该函数引用的数据库对象。
函数与其所引用对象的绑定关系只有在发生以下两种情况之一时才被解除：
除去了函数。

在未指定 SCHEMABINDING 选项的情况下更改了函数（使用 ALTER 语句）。
只有在满足以下条件时，函数才能绑定到架构：
该函数所引用的用户定义函数和视图也已绑定到架构。

该函数所引用的对象不是用两部分名称引用的。

该函数及其引用的对象属于同一数据库。

执行 CREATE FUNCTION 语句的用户对所有该函数所引用的数据库对象都具有 REFERENCES 权限。
如果不符合以上条件，则指定了 SCHEMABINDING 选项的 CREATE FUNCTION 语句将失败。
注释
用户定义函数为标量值函数或表值函数。如果 RETURNS 子句指定一种标量数据类型，则函数为标量值函数。可以使用多条 Transact-SQL 语句定义标量值函数。
如果 RETURNS 子句指定 TABLE，则函数为表值函数。根据函数主体的定义方式，表值函数可分为行内函数或多语句函数。
如果 RETURNS 子句指定的 TABLE 不附带列的列表，则该函数为行内函数。行内函数是使用单个 SELECT 语句定义的表值函数，该语句组成了函数的主体。该函数返回的表的列（包括数据类型）来自定义该函数的 SELECT 语句的 SELECT 列表。
如果 RETURNS 子句指定的 TABLE 类型带有列及其数据类型，则该函数是多语句表值函数。
多语句函数的主体中允许使用以下语句。未在下面的列表中列出的语句不能用在函数主体中。
赋值语句。

控制流语句。

DECLARE 语句，该语句定义函数局部的数据变量和游标。

SELECT 语句，该语句包含带有表达式的选择列表，其中的表达式将值赋予函数的局部变量。

游标操作，该操作引用在函数中声明、打开、关闭和释放的局部游标。只允许使用以 INTO 子句向局部变量赋值的 FETCH 语句；不允许使用将数据返回到客户端的 FETCH 语句。

INSERT、UPDATE 和 DELETE 语句，这些语句修改函数的局部 table 变量。

EXECUTE 语句调用扩展存储过程。
函数的确定性和副作用
函数可以是确定的或不确定的。如果任何时候用一组特定的输入值调用函数时返回的结果总是相同的，则这些函数为确定的。如果每次调用函数时即使用的是相同的一组特定输入值，返回的结果总是不同的，则这些函数为不确定的。
不确定的函数会产生副作用。副作用是更改数据库的某些全局状态，比如更新数据库表或某些外部资源，如文件或网络等（例如，修改文件或发送电子邮件消息）。
不允许在用户定义函数主体中内置不确定函数；这些不确定函数如下：

@@CONNECTIONS@@TOTAL_ERRORS

@@CPU_BUSY@@TOTAL_READ

@@IDLE@@TOTAL_WRITE

@@IO_BUSYGETDATE

@@MAX_CONNECTIONSGETUTCDATE

@@PACK_RECEIVEDNEWID

@@PACK_SENTRAND

@@PACKET_ERRORSTEXTPTR

上一篇：Sql Server 2012 转换函数的比较(Cast、Convert和Parse)

下一篇：SQL Server字符串切割函数