@@CONNECTIONS | @@TOTAL_ERRORS |
@@CPU_BUSY | @@TOTAL_READ |
@@IDLE | @@TOTAL_WRITE |
@@IO_BUSY | GETDATE |
@@MAX_CONNECTIONS | GETUTCDATE |
@@PACK_RECEIVED | NEWID |
@@PACK_SENT | RAND |
@@PACKET_ERRORS | TEXTPTR |
@@TIMETICKS |
盡管在用戶定義函數主體中不允許有不確定函數,這些用戶定義函數在調用擴展存儲過程時仍會產生副作用。
由于擴展存儲過程會對數據庫產生副作用,因此調用擴展存儲過程的函數是不確定的。當用戶定義函數調用會對數據庫產生副作用的擴展存儲過程時,不要指望結果集保持一致或執行函數。
從函數中調用擴展存儲過程
從函數內部調用時擴展存儲過程無法向客戶端返回結果集。任何向客戶端返回結果集的 ODS API 都將返回 FAIL。擴展存儲過程可以連接回 Microsoft® SQL Server™;但是,它不應嘗試聯接與喚醒調用擴展存儲過程的函數相同的事務。
與從批處理或存儲過程中喚醒調用相似,擴展存儲過程在運行 SQL Server 的 Windows® 安全帳戶的上下文中執行。存儲過程的所有者在授予用戶 EXECUTE 特權時應考慮這一點。
函數調用
在可使用標量表達式的位置可喚醒調用標量值函數,包括計算列和 CHECK 約束定義。當喚醒調用標量值函數時,至少應使用函數的兩部分名稱。
[database_name.]owner_name.function_name ([argument_expr][,...])
如果用戶定義函數用于定義計算列,則該函數的確定性同樣決定了是否可在該計算列上創建索引。只有當函數具有確定性時,才可以在使用該函數的計算列上創建索引。如果在輸入相同的情況下函數始終返回相同的值,則該函數具有確定性。
可以使用由一部分組成的名稱喚醒調用表值函數。
[database_name.][owner_name.]function_name ([argument_expr][,...])
對于 Microsoft® SQL Server™ 2000 中包含的系統表函數,喚醒調用時需在函數名的前面加上前綴"::"。
SELECT *
FROM ::fn_helpcollations()
對于導致語句停止執行然后從存儲過程中的下一語句繼續執行的 Transact-SQL 錯誤,在函數中的處理方式不同。在函數中,這類錯誤會導致函數停止執行。這反過來使喚醒調用該函數的語句停止執行。
權限
用戶應具有執行 CREATE FUNCTION 語句的 CREATE FUNCTION 權限。
CREATE FUNCTION 的權限默認地授予 sysadmin 固定服務器角色和 db_owner 和 db_ddladmin 固定數據庫角色的成員。sysadmin 和 db_owner 的成員可用 GRANT 語句將 CREATE FUNCTION 權限授予其它登錄。
函數的所有者對其函數具有 EXECUTE 權限。其他用戶不具有 EXECUTE 權限,除非給他們授予了特定函數上的 EXECUTE 權限。
若要創建或更改在 CONSTRAINT、DEFAULT 子句或計算列定義中引用了用戶定義函數的表,用戶還必須對這些函數有 REFERENCES 權限。
示例
A. 計算 ISO 周的標量值用戶定義函數
下例中,用戶定義函數 ISOweek 取日期參數并計算 ISO 周數。為了正確計算該函數,必須在調用該函數前喚醒調用 SET DATEFIRST 1。
CREATE FUNCTION ISOweek (@DATE datetime) RETURNS int AS BEGIN DECLARE @ISOweek int SET @ISOweek= DATEPART(wk,@DATE)+1 -DATEPART(wk,CAST(DATEPART(yy,@DATE) as CHAR(4))+'0104') --Special cases: Jan 1-3 may belong to the previous year IF (@ISOweek=0) SET @ISOweek=dbo.ISOweek(CAST(DATEPART(yy,@DATE)-1 AS CHAR(4))+'12'+ CAST(24+DATEPART(DAY,@DATE) AS CHAR(2)))+1 --Special case: Dec 29-31 may belong to the next year IF ((DATEPART(mm,@DATE)=12) AND ((DATEPART(dd,@DATE)-DATEPART(dw,@DATE))>= 28)) SET @ISOweek=1 RETURN(@ISOweek) END
下面是函數調用。注意 DATEFIRST 設置為 1。
SET DATEFIRST 1
SELECT master.dbo.ISOweek('12/26/1999') AS 'ISO Week'
下面是結果集。
ISO Week
----------------
52
B. 內嵌表值函數
下例返回內嵌表值函數。
USE pubs GO CREATE FUNCTION SalesByStore (@storeid varchar(30)) RETURNS TABLE AS RETURN (SELECT title, qty FROM sales s, titles t WHERE s.stor_id = @storeid and t.title_id = s.title_id)
C. 多語句表值函數
假設有一個表代表如下的層次關系:
CREATE TABLE employees (empid nchar(5) PRIMARY KEY, empname nvarchar(50), mgrid nchar(5) REFERENCES employees(empid), title nvarchar(30) )
表值函數 fn_FindReports(InEmpID) 有一個給定的職員ID,它返回與所有直接或間接向給定職員報告的職員相對應的表。該邏輯無法在單個查詢中表現出來,不過可以實現為用戶定義函數。
CREATE FUNCTION fn_FindReports (@InEmpId nchar(5)) RETURNS @retFindReports TABLE (empid nchar(5) primary key, empname nvarchar(50) NOT NULL, mgrid nchar(5), title nvarchar(30)) /*Returns a result set that lists all the employees who report to given employee directly or indirectly.*/ AS BEGIN DECLARE @RowsAdded int -- table variable to hold accumulated results DECLARE @reports TABLE (empid nchar(5) primary key, empname nvarchar(50) NOT NULL, mgrid nchar(5), title nvarchar(30), processed tinyint default 0) -- initialize @Reports with direct reports of the given employee INSERT @reports SELECT empid, empname, mgrid, title, 0 FROM employees WHERE empid = @InEmpId SET @RowsAdded = @@rowcount -- While new employees were added in the previous iteration WHILE @RowsAdded > 0 BEGIN /*Mark all employee records whose direct reports are going to be found in this iteration with processed=1.*/ UPDATE @reports SET processed = 1 WHERE processed = 0 -- Insert employees who report to employees marked 1. INSERT @reports SELECT e.empid, e.empname, e.mgrid, e.title, 0 FROM employees e, @reports r WHERE e.mgrid=r.empid and e.mgrid > e.empid and r.processed = 1 SET @RowsAdded = @@rowcount /*Mark all employee records whose direct reports have been found in this iteration.*/ UPDATE @reports SET processed = 2 WHERE processed = 1 END -- copy to the result of the function the required columns INSERT @retFindReports SELECT empid, empname, mgrid, title FROM @reports RETURN END GO -- Example invocation SELECT * FROM fn_FindReports('11234') GO