SQL Server 2008(またはそれ以降)
まず、データベースで、次の2つのオブジェクトを作成します。
CREATE TYPE dbo.IDList
AS TABLE
(
ID INT
);
GO
CREATE PROCEDURE dbo.DoSomethingWithEmployees
@List AS dbo.IDList READONLY
AS
BEGIN
SET NOCOUNT ON;
SELECT ID FROM @List;
END
GO
C#コードで:
// Obtain your list of ids to send, this is just an example call to a helper utility function
int[] employeeIds = GetEmployeeIds();
DataTable tvp = new DataTable();
tvp.Columns.Add(new DataColumn("ID", typeof(int)));
// populate DataTable from your List here
foreach(var id in employeeIds)
tvp.Rows.Add(id);
using (conn)
{
SqlCommand cmd = new SqlCommand("dbo.DoSomethingWithEmployees", conn);
cmd.CommandType = CommandType.StoredProcedure;
SqlParameter tvparam = cmd.Parameters.AddWithValue("@List", tvp);
// these next lines are important to map the C# DataTable object to the correct SQL User Defined Type
tvparam.SqlDbType = SqlDbType.Structured;
tvparam.TypeName = "dbo.IDList";
// execute query, consume results, etc. here
}
SQL Server 2005
SQL Server 2005を使用している場合でも、XMLよりも分割関数をお勧めします。まず、関数を作成します:
CREATE FUNCTION dbo.SplitInts
(
@List VARCHAR(MAX),
@Delimiter VARCHAR(255)
)
RETURNS TABLE
AS
RETURN ( SELECT Item = CONVERT(INT, Item) FROM
( SELECT Item = x.i.value('(./text())[1]', 'varchar(max)')
FROM ( SELECT [XML] = CONVERT(XML, '<i>'
+ REPLACE(@List, @Delimiter, '</i><i>') + '</i>').query('.')
) AS a CROSS APPLY [XML].nodes('i') AS x(i) ) AS y
WHERE Item IS NOT NULL
);
GO
これで、ストアドプロシージャは次のようになります。
CREATE PROCEDURE dbo.DoSomethingWithEmployees
@List VARCHAR(MAX)
AS
BEGIN
SET NOCOUNT ON;
SELECT EmployeeID = Item FROM dbo.SplitInts(@List, ',');
END
GO
また、C#コードでは、リストを'1,2,3,12'
として渡す必要があります。 ...
テーブル値のパラメーターを渡す方法は、それを使用するソリューションの保守性を簡素化し、XMLや文字列分割を含む他の実装と比較してパフォーマンスが向上することがよくあります。
入力は明確に定義されており(区切り文字がコンマかセミコロンかを推測する必要はありません)、ストアドプロシージャのコードを検査しないと明らかでない他の処理関数への依存関係はありません。
UDTの代わりにユーザー定義のXMLスキーマを含むソリューションと比較すると、これには同様の数のステップが含まれますが、私の経験では、管理、保守、および読み取りのコードははるかに単純です。
多くのソリューションでは、多くのストアドプロシージャに再利用するこれらのUDT(ユーザー定義タイプ)の1つまたはいくつかだけが必要になる場合があります。この例と同様に、一般的な要件はIDポインターのリストを渡すことです。関数名は、それらのIDが表すコンテキストを記述し、タイプ名は総称である必要があります。