顧名思義:表值函數返回的是表,而標量值函數可以返回基類型
一、表值函數
用戶定義表值函數返回 table 數據類型。對於內聯表值函數,沒有函數主體;表是單個 SELECT 語句的結果集。
以下示例創建了一個內聯表值函數。此函數的輸入參數為客戶(商店)ID,而返回 ProductID
、Name
以及 YTD Total
(銷售到商店的每種產品的本年度節截止到現在的銷售總額)列。
USE AdventureWorks; GO CREATE FUNCTION Sales.fn_SalesByStore (@storeid int) RETURNS TABLE AS RETURN ( SELECT P.ProductID, P.Name, SUM(SD.LineTotal) AS 'YTD Total' FROM Production.Product AS P JOIN Sales.SalesOrderDetail AS SD ON SD.ProductID = P.ProductID JOIN Sales.SalesOrderHeader AS SH ON SH.SalesOrderID = SD.SalesOrderID WHERE SH.CustomerID = @storeid GROUP BY P.ProductID, P.Name ); GO
以下示例調用此函數並指定客戶 ID 為 602
SELECT * FROM Sales.fn_SalesByStore (602);
對於多語句表值函數,在 BEGIN...END 語句塊中定義的函數體包含一系列 Transact-SQL 語句,這些語句可生成行並將其插入將返回的表中。
以下示例創建了一個表值函數。此函數具有一個輸入參數 EmployeeID
而返回直接或間接向指定員工報告的所有員工的列表。
USE AdventureWorks; GO CREATE FUNCTION dbo.fn_FindReports (@InEmpID INTEGER) RETURNS @retFindReports TABLE ( EmployeeID int primary key NOT NULL, Name nvarchar(255) NOT NULL, Title nvarchar(50) NOT NULL, EmployeeLevel int NOT NULL, Sort nvarchar (255) NOT NULL ) --Returns a result set that lists all the employees who report to the --specific employee directly or indirectly.*/ AS BEGIN WITH DirectReports(Name, Title, EmployeeID, EmployeeLevel, Sort) AS (SELECT CONVERT(Varchar(255), c.FirstName + ' ' + c.LastName), e.Title, e.EmployeeID, 1, CONVERT(Varchar(255), c.FirstName + ' ' + c.LastName) FROM HumanResources.Employee AS e JOIN Person.Contact AS c ON e.ContactID = c.ContactID WHERE e.EmployeeID = @InEmpID UNION ALL SELECT CONVERT(Varchar(255), REPLICATE ('| ' , EmployeeLevel) + c.FirstName + ' ' + c.LastName), e.Title, e.EmployeeID, EmployeeLevel + 1, CONVERT (Varchar(255), RTRIM(Sort) + '| ' + FirstName + ' ' + LastName) FROM HumanResources.Employee as e JOIN Person.Contact AS c ON e.ContactID = c.ContactID JOIN DirectReports AS d ON e.ManagerID = d.EmployeeID ) -- copy the required columns to the result of the function INSERT @retFindReports SELECT EmployeeID, Name, Title, EmployeeLevel, Sort FROM DirectReports RETURN END; GO
在以下示例中,調用了此函數。
-- Example invocation SELECT EmployeeID, Name, Title, EmployeeLevel FROM dbo.fn_FindReports(109) ORDER BY Sort;
二、標量值函數
寫一個標量值函數
CREATE FUNCTION [dbo].[testGetSubNodes_] ( @nodeId int ) RETURNS int AS BEGIN declare @nodeCount int select @nodeCount=5 from MenuTree return @nodeCount END
這個函數很簡單返回一個整型值,然后就可以在存儲過程中調用了,不過調用的方式有所不同,象上面的表值函數調用是不需要所有者的,只要寫函數名稱就可以,對於標量值函數來說,是需要加上所有者的,比如所有者是dbo
select dbo.testGetSubNodes_,這樣就可以返回5,如果不加dbo,那sql會不認識這個函數。
再來一個標量值函數:
CREATE FUNCTION FUN_DataFormat (@strDate datetime) RETURNS varchar(20) AS BEGIN declare @date varchar(20) set @date = DATENAME(YY,@strDate)+'年'+Convert(VARCHAR,MONTH(@strDate))+'月'+Convert(VARCHAR,DAY(@strDate))+'日' return @date END
可以通過select dbo.FUN_DataFormat(getdate())來使用。