テーブル値パラメータ (データベース エンジン)

Transact-SQL でのテーブル値パラメータの作成および使用

テーブル値パラメータには、SQL Server の型とその型を参照するパラメータの 2 つの主要コンポーネントがあります。テーブル値パラメータを作成して使用するには、次の手順を実行します。

1. テーブル型を作成してテーブル構造を定義します。

   SQL Server の型を作成する方法の詳細については、「ユーザー定義テーブル型」を参照してください。テーブル構造を定義する方法の詳細については、「CREATE TABLE (Transact-SQL)」を参照してください。

2. テーブル型のパラメータを含むルーチンを宣言します。SQL Server ルーチンの詳細については、「CREATE PROCEDURE (Transact-SQL)」および「CREATE FUNCTION (Transact-SQL)」を参照してください。

3. テーブル型の変数を宣言してテーブル型を参照します。変数を宣言する方法の詳細については、「DECLARE @local\_variable (Transact-SQL)」を参照してください。

4. INSERT ステートメントを使用してテーブル変数を入力します。データを挿入する方法の詳細については、「INSERT と SELECT を使用した行の追加」を参照してください。

5. テーブル変数を作成して入力したら、変数をルーチンに渡すことができます。

   ルーチンの有効範囲が失われると、テーブル値パラメータは使用できなくなります。型定義は削除されるまで残ります。

SQL Server Native Client でテーブル値パラメータを使用するには、「テーブル値パラメータ (SQL Server Native Client)」を参照してください。

ADO.NET でテーブル値パラメータを使用するには、ADO.NET のドキュメントを参照してください。

利点

制限

スコープ

セキュリティ

カタログ ビュー

テーブル値パラメータと BULK INSERT 操作

テーブル値パラメータの使用はセットベースの変数を使用するその他の方法に似ていますが、多くの場合、大規模なデータセットを処理するときは、テーブル値パラメータを使用する方が短時間で済みます。テーブル値パラメータよりもスタートアップ コストがかかる一括操作と比較すると、1,000 行未満の行を挿入する場合は、テーブル値パラメータの方がパフォーマンスが高くなります。

再利用されるテーブル値パラメータの場合、一時テーブル キャッシュを使用するとメリットがあります。このテーブル キャッシュを使用すると、同等の BULK INSERT 操作よりもスケーラビリティが向上します。少数の行の挿入操作では、BULK INSERT 操作またはテーブル値パラメータではなく、パラメータ一覧またはバッチにまとめられたステートメントを使用すると、パフォーマンス上の利点が多少得られる場合があります。ただし、これらの方法はプログラミングが容易ではなく、行が増えるとすぐにパフォーマンスが低下します。

テーブル値パラメータは、同等のパラメータ配列の実装と同様またはそれ以上のパフォーマンスを実現します。

次の表に、使用を推奨するテクノロジを挿入操作の速度に基づいて示します。

例

次の例では、Transact-SQL を使用して、テーブル値パラメータの型を作成してその型を参照する変数を宣言し、パラメータ一覧を入力して値をストアド プロシージャに渡す方法を示します。

USE AdventureWorks;
GO

/* Create a table type. */
CREATE TYPE LocationTableType AS TABLE 
( LocationName VARCHAR(50)
, CostRate INT );
GO

/* Create a procedure to receive data for the table-valued parameter. */
CREATE PROCEDURE usp_InsertProductionLocation
    @TVP LocationTableType READONLY
    AS 
    SET NOCOUNT ON
    INSERT INTO [AdventureWorks].[Production].[Location]
           ([Name]
           ,[CostRate]
           ,[Availability]
           ,[ModifiedDate])
        SELECT *, 0, GETDATE()
        FROM  @TVP;
        GO

/* Declare a variable that references the type. */
DECLARE @LocationTVP 
AS LocationTableType;

/* Add data to the table variable. */
INSERT INTO @LocationTVP (LocationName, CostRate)
    SELECT [Name], 0.00
    FROM 
    [AdventureWorks].[Person].[StateProvince];

/* Pass the table variable data to a stored procedure. */
EXEC usp_InsertProductionLocation @LocationTVP;
GO

関連項目

参照