共用方式為


CREATE AGGREGATE (Transact-SQL)

建立使用者定義的彙總函數 (其實作定義在 .NET Framework 的組件類別中)。若要使 Database Engine 將彙總函數繫結到它的實作,您必須先利用 CREATE ASSEMBLY 陳述式,將包含這項實作的 .NET Framework 組件上載到 SQL Server 執行個體中。

[!附註]

依預設,會關閉 SQL Server 執行 CLR 程式碼的能力。您可以建立、修改和卸除參考 Managed 程式碼模組的資料庫物件,但除非利用 sp_configure 來啟用 clr enabled 選項,否則,這些模組中的程式碼不會在 SQL Server 執行個體中執行。

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

語法

CREATE AGGREGATE [ schema_name . ] aggregate_name
        (@param_name <input_sqltype> 
        [ ,...n ] )
RETURNS <return_sqltype>
EXTERNAL NAME assembly_name [ .class_name ]

<input_sqltype> ::=
        system_scalar_type | { [ udt_schema_name. ] udt_type_name }

<return_sqltype> ::=
        system_scalar_type | { [ udt_schema_name. ] udt_type_name }

引數

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

  • aggregate_name
    這是您要建立之彙總函式的名稱。

  • @param_name
    使用者定義彙總中的一或多個參數。在執行彙總函數時,使用者必須提供參數的值。使用 "at" 記號 (
    @
    ) 當做第一個字元來指定參數名稱。參數名稱必須符合識別碼的規則。這些參數是函數的本機參數。

  • system_scalar_type
    這是用來保留輸入參數值或傳回值的 SQL Server 系統純量資料類型。除了 text、ntext 和 image,所有純量資料類型都可用來當做使用者定義彙總的參數。無法指定 cursor 和 table 之類的非純量類型。

  • udt_schema_name
    這是 CLR 使用者自訂類型所屬的結構描述名稱。如果未指定,Database Engine 會依照下列順序來參考 udt_type_name:

    • 原生 SQL 類型命名空間。

    • 目前資料庫中之目前使用者的預設結構描述。

    • 目前資料庫的 dbo 結構描述。

  • udt_type_name
    這是目前資料庫中已建立之 CLR 使用者自訂類型的名稱。如果未指定 udt_schema_name,則 SQL Server 會假設類型屬於目前使用者的結構描述。

  • assembly_name [ **.**class_name ]
    指定要繫結使用者自訂彙總函式的組件,以及 (選擇性) 組件所屬的結構描述名稱和實作使用者自訂彙總的組件中之類別名稱。這個組件必須已利用 CREATE ASSEMBLY 陳述式建立在資料庫中。class_name 必須是有效的 SQL Server 識別碼,且符合組件中現有的類別名稱。如果用來撰寫類別的程式設計語言使用命名空間,如 C#,則 class_name 可能是符合命名空間的名稱。如果未指定 class_name,則 SQL Server 會假設它與 aggregate_name 相同。

備註

assembly_name 及其方法所參考的組件類別,應該滿足在 SQL Server 執行個體中實作使用者自訂彙總函式的所有需求。如需詳細資訊,請參閱<CLR 使用者定義彙總>。

權限

需要 CREATE AGGREGATE 權限,以及 EXTERNAL NAME 子句所指定之組件的 REFERENCES 權限。

範例

下列範例假設 SQL Server Database Engine 範例安裝在本機電腦的預設位置中,且已編譯 StringUtilities.csproj 範例應用程式。如需詳細資訊,請參閱<String Utilities Sample>。

下列範例會建立彙總 Concatenate。在建立這項彙總之前,會將 StringUtilities.dll 組件註冊在本機資料庫中。

USE AdventureWorks;
GO
DECLARE @SamplesPath nvarchar(1024)
-- You may have to modify the value of the this variable if you have
--installed the sample some location other than the default location.
SELECT @SamplesPath = REPLACE(physical_name, 'Microsoft SQL Server\MSSQL10.MSSQLSERVER\MSSQL\DATA\master.mdf', 'Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\') 
     FROM master.sys.database_files 
     WHERE name = 'master';
CREATE ASSEMBLY StringUtilities FROM @SamplesPath + 'StringUtilities\CS\StringUtilities\bin\debug\StringUtilities.dll'
WITH PERMISSION_SET=SAFE;
GO

CREATE AGGREGATE Concatenate(@input nvarchar(4000))
RETURNS nvarchar(4000)
EXTERNAL NAME [StringUtilities].[Microsoft.Samples.SqlServer.Concatenate];
GO