CLR ユーザー定義集計の要件

CLR (共通言語ランタイム) アセンブリの型は、必要な集計コントラクトが実装されていれば、ユーザー定義集計関数として登録できます。 このコントラクトは、SqlUserDefinedAggregate 属性と集計コントラクトのメソッドで構成されます。 集計コントラクトには、集計の中間状態を保存するためのメカニズムと、Init、Accumulate、Merge、および Terminate の 4 つのメソッドで構成される新しい値を積算するメカニズムが含まれます。 これらの要件を満たしていれば、ユーザー定義集計の豊富なメリットを Microsoft SQL Server で有効に活用できます。 このトピックの次のセクションでは、ユーザー定義集計を作成し、そのユーザー定義集計を使用して作業する方法について詳しく説明します。 例については、「CLR ユーザー定義集計関数の呼び出し」を参照してください。

SqlUserDefinedAggregate

詳細については、「SqlUserDefinedAggregateAttribute」を参照してください。

集計のメソッド

ユーザー定義集計として登録するクラスでは、次のインスタンス メソッドをサポートする必要があります。 次に、集計を計算するためにクエリ プロセッサで使用されるメソッドを示します。

public void Init();

public void Accumulate ( input-type value[, input-type value, ...]);

public void Merge( udagg_class value);

public return_type Terminate();

テーブル値パラメーター

テーブル値パラメーター (TVP) とは、プロシージャや関数に渡されるユーザー定義のテーブル型です。TVP を使用すると、複数行のデータを効率的にサーバーに渡すことができます。 TVP の機能はパラメーター配列に似ていますが、より柔軟性が高く、Transact-SQL との統合も緊密です。 TVP を使用するとパフォーマンスが向上する可能性もあります。 また、サーバーへのラウンド トリップを減らすのにも役立ちます。 スカラー パラメーターのリストを使用するなどしてサーバーに複数の要求を送信する代わりに、データを TVP としてサーバーに送信できます。 SQL Server のプロセスで実行されているマネージ ストアド プロシージャやマネージ関数にユーザー定義のテーブル型をテーブル値パラメーターとして渡したり、戻り値として受け取ったりすることはできません。 また、TVP はコンテキスト接続のスコープ内では使用できません。 ただし、コンテキスト接続ではない接続で使用されている SqlClient を使用すると、SQL Server のプロセスで実行されているマネージ ストアド プロシージャやマネージ関数で TVP を使用できます。 その接続は、マネージ プロシージャやマネージ関数を実行しているのと同じサーバーへの接続でかまいません。 TVP の詳細については、「テーブル値パラメーターの使用 (データベース エンジン)」を参照してください。

関連項目

概念

CLR ユーザー定義型

CLR ユーザー定義集計関数の呼び出し

変更履歴