チュートリアル : SQL CLR のユーザー定義集計のデバッグ

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

このトピックの内容は、次の製品に該当します。

Edition	Visual Basic	C#	C++	Web Developer
Express
Standard
Pro/Team

表の凡例 :

	対象
	該当なし
	既定で非表示のコマンド

この例では、CLR SQL のユーザー定義集計のデバッグ方法を示します。この例により、AdventureWorks サンプルデータベースに Concatenate という、新しい CLR SQL 集計関数が作成されます。SQL ステートメントでこの関数を呼び出すと、入力パラメータで指定した列の値がすべて連結されます。

メモ :
使用している設定またはエディションによっては、表示されるダイアログボックスやメニューコマンドがヘルプに記載されている内容と異なる場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。

使用している設定またはエディションによっては、表示されるダイアログボックスやメニューコマンドがヘルプに記載されている内容と異なる場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。

CLR SQL 集計関数をデバッグするには

新しい SQL Server プロジェクトで、AdventureWorks サンプルデータベースへの接続を確立します。詳細については、「方法 : データベースに接続する」を参照してください。
この後の最初のサンプルにあるコードを使用して、新しい関数を作成し、Concatenate.cs と名前を付けます。詳細については、「方法 : SQL Server のプロジェクトの種類を使用して開発する」を参照してください。
SELECT ステートメントに含めて、関数をテストするスクリプトを追加します。ソリューションエクスプローラの [TestScripts] ディレクトリを右クリックし、[テストスクリプトの追加] をクリックして、このチュートリアルの 2 つ目のサンプルにあるコードを挿入します。ファイル名に Concatenate.sql と名前を付けて、保存します。ファイル名を右クリックし、[既定のデバッグスクリプトの設定] をクリックします。
if ステートメントの Accumulate メソッド内にある Concatenate.cs にブレークポイントを設定します。そのためには、テキストエディタウィンドウの網かけの左端余白をクリックします。次に [デバッグ] メニューの [デバッグ開始] をクリックして、プロジェクトのコンパイル、配置、単体テストを実行します。黄色の矢印で表される命令ポインタがブレークポイントに表示されて、関数のデバッグが行われます。
いろいろなデバッグ機能を試してください。
1. Concatenate.sql のスクリプトの GROUP BY 句を構成する行ごとに、Accumulate メソッドが 1 回実行されます。[デバッグ] メニューの [ステップイン] を繰り返しクリックすると、メソッドの結果が作成される過程を観察できます。
2. [ローカル] ウィンドウで、変数 value を開きます。この変数には、現在処理中のストア名が含まれます。
3. 変数 this をクリックします。この関数から子ノード intermediateResult が返されます。この子ノードには、現在のものまでのすべてのストア名がコンマ区切りで 1 つに連結されています。
4. テキストエディタで、intermediateResult 変数をダブルクリックして選択します。intermediateResult を [ウォッチ] ウィンドウにドラッグし、ウィンドウの任意の場所にドロップします。ウォッチする変数のリストに追加されます。
5. メソッドを、数回ステップ実行します。intermediateResult の値は、メソッドを実行するたびに変わり、新規のストア名が末尾に連結されます。
6. ブレークポイントをクリックして削除し、Terminate メソッド内の最初のステートメントにブレークポイントを追加します。このメソッドから呼び出し元に結果が返されます。ステップインするには、[デバッグ] メニューの [デバッグ開始] をクリックします。[デバッグ] メニューの [ステップイン] をクリックすると、ステップ実行できます。return ステートメントにヒットしたときは停止します。
7. 関数のデバッグを終了するには、もう一度 [続行] をクリックします。

使用例

これは、この例で使用される集計関数のコードです。

using System;
using System.Data.Sql;
using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;
using System.IO;
using System.Text;
[Serializable]
[SqlUserDefinedAggregate( 
    //use CLR serialization to serialize the intermediate result. 
    Format.UserDefined, 
    //Optimizer property: 
    IsInvariantToNulls=true,
    //Optimizer property: 
    IsInvariantToDuplicates=false,
    //Optimizer property: 
    IsInvariantToOrder=false,
    //Maximum size in bytes of persisted value: 
    MaxByteSize=8000)
] 
public class Concatenate: IBinarySerialize 
{ 
    /// <summary> 
    /// Variable holds intermediate result of the concatenation 
    /// </summary> 
    private StringBuilder intermediateResult; 
    /// <summary> 
    /// Initialize the internal data structures 
    /// </summary> 
    public void Init( ) 
    { 
        intermediateResult = new StringBuilder(); 
    } 
    /// <summary> 
    /// Accumulate the next value, nop if the value is null 
    /// </summary> 
    /// <param name="value"></param> 
    public void Accumulate(SqlString value) 
    { 
        if(value.IsNull) 
        { 
            return; 
        } 
        intermediateResult.Append(value.Value).Append(','); 
    } 
    /// <summary> 
    /// Merge the partially computed aggregate with this aggregate. 
    /// </summary> 
    /// <param name="other"></param> 
    public void Merge( Concatenate other) 
    { 
        intermediateResult.Append(other.intermediateResult); 
    } 
    /// <summary> 
    /// Called at end of aggregation, to return results. 
    /// </summary> 
    /// <returns></returns> 
    public SqlString Terminate() 
    { 
        string output = string.Empty; 
        //Delete the trailing comma, if any .
        if (intermediateResult != null && intermediateResult.Length > 0) 
            output = intermediateResult.ToString(0, intermediateResult.Length-1); 
        return new SqlString(output); 
    } 
    public void Read(BinaryReader r) 
    { 
        intermediateResult = new StringBuilder(r.ReadString()); 
    } 
    public void Write(BinaryWriter w) 
    { 
        w.Write(intermediateResult.ToString()); 
    } 
}

これは、関数を呼び出すテストスクリプトです。

SELECT scu.SalesPersonID, dbo.Concatenate(sst.Name)
FROM Sales.Customer as scu 
INNER JOIN Sales.Store as sst
    ON scu.CustomerID    = sst.CustomerID
INNER JOIN Sales.SalesPerson as spr
    ON scu.SalesPersonID = spr.SalesPersonID
WHERE    scu.SalesPersonID = 283
GROUP BY scu.SalesPersonID

次の方法で共有

チュートリアル : SQL CLR のユーザー定義集計のデバッグ

CLR SQL 集計関数をデバッグするには

使用例

参照

処理手順

その他の技術情報

その他のリソース