Parametri con valori di tabella (Motore di database)

Creazione e utilizzo di parametri con valori di tabella in Transact-SQL

I parametri con valori di tabella includono due componenti principali, ovvero un tipo di SQL Server e un parametro che fa riferimento a tale tipo. Per creare e utilizzare parametri con valori di tabella, effettuare le operazioni seguenti:

1. Creare un tipo di tabella e definire la struttura della tabella.

   Per informazioni su come creare un tipo di SQL Server, vedere Tipi di tabella definiti dall'utente. Per ulteriori informazioni su come definire la struttura di una tabella, vedere CREATE TABLE (Transact-SQL).

2. Dichiarare una routine che include un parametro del tipo di tabella. Per ulteriori informazioni sulle routine di SQL Server, vedere CREATE PROCEDURE (Transact-SQL) e CREATE FUNCTION (Transact-SQL).

3. Dichiarare una variabile del tipo di tabella e fare riferimento al tipo di tabella. Per informazioni sulla dichiarazione delle variabili, vedere DECLARE @local\_variable (Transact-SQL).

4. Riempire la variabile di tabella utilizzando un'istruzione INSERT. Per ulteriori informazioni su come inserire dati, vedere Aggiunta di righe con INSERT e SELECT.

5. Dopo avere creato e riempito la variabile di tabella, è possibile passare la variabile a una routine.

   Quando la routine non è più compresa nell'ambito, il parametro con valori di tabella non è più disponibile. La definizione del tipo viene invece mantenuta fino a quando non viene eliminata.

Per utilizzare un parametro con valori di tabella in SQL Server Native Client, vedere Parametri con valori di tabella (SQL Server Native Client).

Per utilizzare un parametro con valori di tabella in ADO.NET, vedere la documentazione di ADO.NET.

Vantaggi

Restrizioni

Ambito

Protezione

Viste del catalogo

Confronto tra parametri con valori di tabella e operazioni BULK INSERT

L'utilizzo di parametri con valori di tabella è confrontabile con altre modalità di utilizzo di variabili basate su set, ma può spesso risultare più rapido nel caso di set di dati di notevoli dimensioni. Rispetto alle operazioni bulk, che comportano costi di avvio maggiori, i parametri con valori di tabella garantiscono livelli di prestazioni ottimali per operazioni di inserimento di non oltre 1.000 righe.

I parametri con valori di tabella riutilizzati possono sfruttare il vantaggio derivante dalla memorizzazione nella cache della tabella temporanea, che consente di ottenere una migliore scalabilità rispetto alle operazioni BULK INSERT equivalenti. Se si eseguono operazioni di inserimento di righe di entità ridotta, è possibile ottenere vantaggi minimi in termini di prestazioni utilizzando elenchi di parametri o istruzioni batch anziché operazioni BULK INSERT o parametri con valori di tabella. Tali metodi, tuttavia, risultano meno efficaci da programmare e le prestazioni si riducono rapidamente con l'aumentare del numero di righe.

I parametri con valori di tabella garantiscono livelli di prestazioni analoghi o migliori rispetto all'implementazione di una matrice di parametri equivalente.

Nella tabella seguente viene illustrata la tecnologia da utilizzare in base alla velocità delle operazioni di inserimento.

Esempi

Nell'esempio seguente viene utilizzato Transact-SQL e viene illustrato come creare un tipo di parametro con valori di tabella, dichiarare una variabile per farvi riferimento, riempire un elenco di parametri e quindi passare i valori a una stored procedure.

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

Vedere anche

Riferimento