Tabela Valued parametry (aparat bazy danych)

Tworzenie i używanie tabel Valued parametry w języku Transact-SQL

Parametry wartości tabela mają dwa podstawowe składniki: a SQL Server Typ i parametr, który odwołuje się do tego typu. Aby utworzyć i używać parametrów wycenione tabela, wykonaj następujące kroki:

1. Tworzenie tabela i definiowania struktury tabela.

   Aby uzyskać informacje na temat tworzenia SQL Server Wpisz, zobacz Typy zdefiniowane przez użytkownika tabela. Aby uzyskać więcej informacji na temat definiowania strukturę tabela zobacz CREATE TABLE (Transact-SQL).

2. Deklaruje procedury, które ma parametr typu tabela.Aby uzyskać więcej informacji na temat SQL Server procedury, zobacz CREATE PROCEDURE (języka Transact-SQL) i CREATE funkcja języka Transact-SQL).

3. Zmienna typu Tabela i typ tabeli odwołania.Aby uzyskać informacje na temat deklarowaniu zmiennych, zobacz temat DECLARE @local\_variable (Transact-SQL).

4. Wypełnić przy użyciu zmiennej tabela WSTAWIANIE instrukcja.Aby uzyskać więcej informacji na temat sposobu wstawiania danych zobacz Adding Rows by Using INSERT and SELECT.

5. Po utworzona i wypełniona zmiennej tabela, można przekazać zmiennej do procedury.

   Gdy procedura jest poza zakresem, parametr wycenione tabela nie jest już dostępny.Definicja typu pozostaje, dopóki nie zostanie usunięte.

Aby użyć parametru wartości tabela w SQL Server Klient macierzystym, zobacz Tabela Valued parametry (SQL Server Native klient).

Aby użyć parametru wartości tabela w ADO.NET, zapoznaj się z dokumentacją ADO.NET.

Korzyści

Ograniczenia

Zakres

Zabezpieczenia

Widoki wykazów

Tabela Valued vs parametry.Operacje INSERT BULK

Przy użyciu wartości z tabela parametrów jest porównywalna z innych sposobów używania oparte na zestawie zmiennych; jednak za pomocą wartości w tabela parametrów często może być szybciej w przypadku dużych zestawów danych.W porównaniu z operacje zbiorcze, które uruchomienia większych kosztów niż wartości w tabela parametrów wycenione tabela parametrów wykonuje również wstawiania wierszy poniżej 1000.

Parametry wartości w tabeli, które są używane ponownie korzyści z buforowania tabela tymczasowa.Buforowanie tabela umożliwia lepszą skalowalność niż równoważną operacji BULK INSERT.Za pomocą operacji małych wiersza o wkładaniu korzyści mała wydajność może zostać uzyskane za pomocą parametru list lub batched instrukcji BULK INSERT operacji lub wycenione tabela parametrów.Jednak te metody to mniej wygodne do programowania i wydajność zmniejsza się szybko, zwiększ wierszy.

Wartości w tabela parametrów wykonywać równie dobrze lub lepiej niż implementacja równoważnych parametrów tablicy.

W poniższej tabela przedstawiono technologii używania opartą na szybkości operacji wstawiania.

Przykłady

W poniższym przykładzie użyto Transact-SQL i pokazuje, jak utworzyć typ parametru wartości w tabela, przy deklarowaniu zmiennej, aby odwoływać, wypełnienie listy parametrów, a następnie przekazać wartości do procedura przechowywana.

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

See Also

Other Resources