SQL Server存储过程输入参数使用表值

SQL Server存储过程输入参数使用表值

转载自：http://blog.csdn.net/smithliu328/article/details/9996149

 

在2008之前如果我们想要将表作为输入参数传递给SQL Server存储过程使比较困难的，可能需要很多的逻辑处理将这些表数据作为字符串或者XML传入。

 

在2008中提供了表值参数。使用表值参数，可以不必创建临时表或许多参数，即可向 Transact-SQL 语句或例程（如存储过程或函数）发送多行数据，这样可以省去很多自定义的代码。这样的操作对于存储过程内基于表函数的操作变得非常容易操作。

表值参数是使用用户定义的表类型来声明的。所以使用之前要先定义表类型。

/* 创建表类型.*/

CREATE TYPE LocationTableType AS TABLE

( LocationName VARCHAR(50)

, CostRate INT );

GO

 

/* 创建一个存储过程以表值参数作为输入. */

CREATE PROCEDURE dbo. usp_InsertProductionLocation

    @TVP LocationTableType READONLY

    AS

    SET NOCOUNT ON

    INSERT INTO Production.Location

           (Name

           ,CostRate

           ,Availability

           ,ModifiedDate)

        SELECT *, 0, GETDATE()

        FROM  @TVP;

        GO

 

 

/* 声明表值参数变量.*/

DECLARE @LocationTVP ASLocationTableType;

 

/* 将数据插入表值变量*/

INSERT INTO @LocationTVP(LocationName, CostRate)

    SELECT Name, 0.00

    FROM Person.StateProvince;

 

/* 将变量传递给存储过程*/

EXEC usp_InsertProductionLocation@LocationTVP;

GO

  表值参数是 SQL Server 2008 中的新参数类型。表值参数是使用用户定义的表类型来声明的。使用表值参数，可以不必创建临时表或许多参数，即可向 Transact-SQL 语句或例程（如存储过程或函数）发送多行数据。

    表值参数与 OLE DB 和 ODBC 中的参数数组类似，但具有更高的灵活性，且与 Transact-SQL 的集成更紧密。表值参数的另一个优势是能够参与基于数据集的操作。

    (注意：Transact-SQL 通过引用向例程传递表值参数，以避免创建输入数据的副本。)

在 Transact-SQL 中创建和使用表值参数

表值参数具有两个主要部分：SQL Server 类型以及引用该类型的参数。若要创建和使用表值参数，请执行以下步骤：

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 中使用表值参数，请参阅Table-Valued Parameters (SQL Server Native Client)。

若要在 ADO.NET 中使用表值参数，请参阅 ADO.NET 文档。

优点

表值参数具有更高的灵活性，在某些情况下，可比临时表或其他传递参数列表的方法提供更好的性能。表值参数具有以下优势：

• 首次从客户端填充数据时，不获取锁。
• 提供简单的编程模型。
• 允许在单个例程中包括复杂的业务逻辑。
• 减少到服务器的往返。
• 可以具有不同基数的表结构。
• 是强类型。
• 使客户端可以指定排序顺序和唯一键。

限制

表值参数有下面的限制：

• SQL Server 不维护表值参数列的统计信息。
• 表值参数必须作为输入 READONLY 参数传递到 Transact-SQL 例程。不能在例程体中对表值参数执行诸如 UPDATE、DELETE 或 INSERT 这样的 DML 操作。
• 不能将表值参数用作 SELECT INTO 或 INSERT EXEC 语句的目标。表值参数可以在 SELECT INTO 的 FROM 子句中，也可以在 INSERT EXEC 字符串或存储过程中。

作用域

就像其他参数一样，表值参数的作用域也是存储过程、函数或动态 Transact-SQL 文本。同样，表类型变量也与使用 DECLARE 语句创建的其他任何局部变量一样具有作用域。可以在动态 Transact-SQL 语句内声明表值变量，并且可以将这些变量作为表值参数传递到存储过程和函数。

安全性

表值参数的权限使用下列 Transact-SQL 关键字来遵循 SQL Server 的对象安全模式：CREATE、GRANT、DENY、ALTER、CONTROL、TAKE OWNERSHIP、REFERENCES、EXECUTE、VIEW DEFINITION 和 REVOKE。

目录视图

若要获取与表值参数关联的信息，可以查询下列目录视图：sys.parameters (Transact-SQL)、sys.types (Transact-SQL) 和 sys.table_types (Transact-SQL)。

表值参数与 BULK INSERT 操作

表值参数的使用方法与其他基于数据集的变量的使用方法相似；但是，频繁使用表值参数将比大型数据集要快。大容量操作的启动开销比表值参数大，与之相比，表值参数在插入数目少于 1000 的行时具有很好的执行性能。

重用的表值参数可从临时表缓存中受益。这一表缓存功能可比对等的 BULK INSERT 操作提供更好的伸缩性。使用小型行插入操作时，可以通过使用参数列表或批量语句（而不是 BULK INSERT 操作或表值参数）来获得小的性能改进。但是，这些方法在编程上不太方便，并且随着行的增加，性能会迅速下降。

表值参数在执行性能上与对等的参数阵列实现相当甚至更好。

下表说明根据插入操作的速度应使用哪种技术。

数据源	服务器逻辑	行数	最佳技术
服务器上带格式的数据文件	直接插入	< 1000	BULK INSERT
服务器上带格式的数据文件	直接插入	> 1000	BULK INSERT
服务器上带格式的数据文件	复杂	< 1000	表值参数
服务器上带格式的数据文件	复杂	> 1000	BULK INSERT
远程客户端进程	直接插入	< 1000	表值参数
远程客户端进程	直接插入	> 1000	BULK INSERT
远程客户端进程	复杂	< 1000	表值参数
远程客户端进程	复杂	> 1000	表值参数

 

 

示例

下面的示例使用 Transact-SQL 并演示如何执行以下操作：创建表值参数类型，声明变量来引用它，填充参数列表，然后将值传递到存储过程。

USE AdventureWorks; GO /*创建表值参数类型 */ CREATE TYPE LocationTableType AS TABLE ( LocationName VARCHAR(50) , CostRate INT ); GO /* 创建一个过程来获得该表值参数数据 */ 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 @LocationTVP AS LocationTableType; /* Add data to the table variable. */ INSERT INTO @LocationTVP (LocationName, CostRate) SELECT [Name], 0.00 FROM [AdventureWorks].[Person].[StateProvince]; /* 把表变量的数据传递给存储过程 */ EXEC usp_InsertProductionLocation @LocationTVP; GO