Возвращающие табличное значение параметры (компонент Database Engine)

Создание и использование возвращающих табличные значения параметров в Transact-SQL

Возвращающие табличные значения параметры имеют два основных компонента: тип SQL Server и параметр, ссылающийся на этот тип. Чтобы создать и использовать возвращающие табличные значения параметры, следуйте следующим шагам.

1. Создайте табличный тип и определите структуру таблицы.

   Дополнительные сведения о создании типа SQL Server см. в разделе Определяемые пользователем типы таблиц. Дополнительные сведения о задании структуры таблицы см. в разделе Инструкция CREATE TABLE (Transact-SQL).

2. Объявите процедуру, имеющую параметр типа table. Дополнительные сведения о процедурах SQL Server см. в разделах CREATE PROCEDURE (Transact-SQL) и CREATE FUNCTION (Transact-SQL).

3. Объявите переменную типа table и создайте ссылку на тип table. Сведения об объявлении переменных см. в разделе DECLARE @local_variable (Transact-SQL).

4. Заполните переменную типа table с помощью инструкции INSERT. Дополнительные сведения о вставке данных см. в разделе Добавление строк с помощью инструкций INSERT и SELECT.

5. После создания переменной типа table ее можно передать процедуре.

   После выхода процедуры из области параметр, возвращающий табличное значение, становится недоступным. Определение типа остается, пока не будет удалено.

Сведения об использовании возвращающих табличные значения параметров в собственном клиенте SQL Server см. в разделе Параметры, возвращающие табличное значение (собственный клиент SQL Server).

Сведения об использовании возвращающих табличные значения параметров в ADO.NET см. в документации по ADO.NET.

Преимущества

Ограничения

Область действия

Безопасность

Представления каталога

Возвращающие табличные значения параметры и операции BULK INSERT

Использование возвращающих табличные значения параметров похоже на другие способы использования переменных, основанных на наборах. Однако применение возвращающих табличные значения параметров при работе с большими наборами данных часто позволяет добиться увеличения производительности. По сравнению с массовыми операциями, имеющими большие начальные затраты, возвращающие табличные значения параметры показывают хорошую производительность при вставке менее 1000 строк.

Возвращающие табличные значения параметры, используемые повторно, могут использовать кэширование временных таблиц. Это кэширование таблиц позволяет обеспечить лучшую масштабируемость, чем в эквивалентных операциях BULK INSERT. С помощью маленьких операций вставки строк можно добиться небольшого увеличения производительности, применяя списки параметров или пакетные инструкции вместо операций BULK INSERT или возвращающих табличные значения параметров. Однако эти методы сложнее программировать, а производительность быстро падает при увеличении количества строк.

Возвращающие табличные значения параметры работают также хорошо или даже лучше, чем эквивалентная реализация массива параметров.

В следующей таблице показывается, какую технологию следует использовать, исходя из скорости операций вставки.

Примеры

В следующем примере используется язык Transact-SQL; в примере показывается, как создать тип возвращающего табличное значение параметра, объявить ссылающуюся на него переменную, заполнить список параметров, а затем передать значения хранимой процедуре.

USE AdventureWorks2008R2;
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 [AdventureWorks2008R2].[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 
    [AdventureWorks2008R2].[Person].[StateProvince];

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

См. также

Справочник