表值函数：Table Valued Function

Author: Zhu Yue
本文主要介绍SQL Server 2019 版本中的Table Valued Function，以及使用场景；
如果你仍然奋战在数据库相关的工作时，尤其是使用Microsoft SQL Server，有一些功能点是需要掌握的，这包含基本的SQL语言，视图，函数，触发器，存储过程，游标等；

作为数据仓库工程师，平时在工作中，我们会经常使用视图和存储过程来为上下游的Data Layer或者前端BI工具提供数据，经常用的只有通过数据库内置的函数进行一些数值时间日期的转换；

今天我们主要来介绍另外一种SQL Server 2019版本下的Table Valued Function

定义： 表值函数（Table Valued Function），从字面意义上可以看出，其返回值是Table 类型，是一个数据集，可以简单理解为带有参数的视图；

使用场景：通过传入不同的参数，动态的返回不同的数据集合；

下面，我们使用一个例子来进行讲解，Table Valued Function的两种类型；
首先准备一张表，Workday Calendar，共有10行记录，表示从19年12月1日到19年12月10日的工作日分析，我们想通过TVF函数，查询其中某一天是否是工作日。

图片.png

Inline Table Valued Function

创建一个inline TVF “udfGetCalendar”，如下所示：

CREATE FUNCTION [dbo].[udfGetCalendar]
(
    @InputDTS VARCHAR(50)
)
RETURNS TABLE
AS
RETURN SELECT [dateName],
              [dayOfWeek],
              [dayOfWeekName],
              [dayOfMonth],
              [monthName],
              [isWeekDay],
              [isHoliday]
      FROM [DW].[dbo].[WorkdayCalendar]
      WHERE [dateName] = @InputDTS;

创建完成后，可以输入想要查询的日期：

SELECT [dateName],
       [isWeekDay]
FROM [dbo].[udfGetCalendar]('2019-12-08');

查询结果如下：

图片.png

简单直接，用法类似视图，但是可以通过传入参数来获得某一类条件下的数据集合，且这类集合通过表的形式返回；

Multi-statement table-valued functions (MSTVF)

第二种类型的TVF可以理解为可以通过多行SQL语句返回某一类条件下的数据集合。

CREATE FUNCTION [dbo].[udfGetWorkday]
(
    @isWeekDay INT
)
RETURNS @GetWorkday TABLE
(
    [dateName] [CHAR](10),
    [dayOfWeekName] [VARCHAR](10)
)
AS
BEGIN
    INSERT INTO @GetWorkday
    SELECT [dateName],
           [dayOfWeekName]
    FROM [DW].[dbo].[WorkdayCalendar]
    WHERE [isWeekDay] = @isWeekDay;

    RETURN;
END;

执行查询语句，传入参数值 1，表示我们想筛选出来，所有工作日的日期信息；

SELECT * FROM [dbo].[udfGetWorkday] (1)

执行结果如下所示：

图片.png

所有在19年12月1日 ~ 19年12月10日之间的工作日都筛选了出来。

那么有同学可能问了，既然可以使用参数，为什么不用存储过程？
个人理解，主要原因是2019版本的SQL Server，在TVF功能上更加强调使用内存资源进行计算，并且能够使用内存加速数据处理过程，但是也因为这点，不建议把较为复杂的业务逻辑放在TVF中进行处理；

参考资料：
http://www.sqlservertutorial.net/sql-server-user-defined-functions/sql-server-table-valued-functions/