OUTPUT yan tümce (Transact-SQL)

Bir iç içe geçmiş bir INSERT OUTPUT yan sonuçlar yakalarken, UPDATE, DELETE, veya deyim BİRLEŞTİRMEK ve bu sonuçlar hedef tabloya ekleme, aşağıdaki bilgileri göz önünde bulundurun:

• Tüm işlem atomik olur.INSERT deyim hem de OUTPUT yan tümce içeren iç içe DML deyimini yürütmek ya da tam deyim başarısız olur.

• Dış INSERT deyim hedefe aşağıdaki kısıtlamalar geçerlidir:

  • Hedef, bir uzak tablo, görünüm veya genel tablo ifade olamaz.

  • Hedef yabancı anahtar kısıtlaması olamaz veya bir yabancı anahtar kısıtlaması tarafından başvurulan.

  • Tetikleyiciler hedef tanımlanamaz.

  • Birleştirme çoğaltma ya da güncellenebilir abonelik işlemsel kopyalama için hedef alamaz.

• İç içe DML deyim için uygulanacak kısıtlamalar:

  • Hedef, bir uzak tablo ya da bölümlenmiş görünüm olamaz.

  • Kaynak kendini içeremez bir<dml_table_source>yan tümce.

• INTO OUTPUT yan tümce içeren INSERT deyimleri desteklenmeyen bir<dml_table_source>yan tümce.

• @@ ROWCOUNT, yalnızca dış INSERT deyim ile eklenen satır döndürür.

• @@ IDENTITY, SCOPE_IDENTITY, IDENT_CURRENT, yalnızca iç içe DML deyim ile oluşturulan kimlik değerlerini ve olanları dış INSERT deyim ile oluşturulan verir.

• Sorgu bildirimleri deyim tek bir varlık olarak kabul ve dış INSERT deyim kendisini önemli değişiklik olsa bile, oluşturulan tüm ileti türünü iç içe DML, türü olacaktır.

• ,<dml_table_source>yan tümce, SELECT ve WHERE yan tümcesini içeremez alt toplamak işlevleri, sıralama işlev, tam metin yüklemler, kullanıcı tanımlı işlevleri gerçekleştiren veri erişimi veya TEXTPTR işlev.

OUTPUT döndürülen sütun olarak INSERT sonra UPDATE veya DELETE deyim tamamlandı ancak Tetikleyiciler yürütülen önce verileri yansıtacak.

INSTEAD OF Tetikleyicileri, INSERT, UPDATE veya DELETE gerçekte gibi oluştuysa, döndürülen sonuçlar oluşturulan için bile değişikliğe tetikleyici işleminin sonucu gerçekleşir.Tetikleyici gövdesi içinde kullanılan bir OUTPUT yan tümce içeren bir deyim, tablo diğer adları tetikleyici eklenen ve silinen çoğaltma INSERTED içeren sütun başvuruları önlemek için tablolar ve OUTPUT ile ilişkili tabloları DELETED başvurusu için kullanılmalıdır.

Çıktı yan tümce de INTO anahtar sözcüğü, DML işleminin hedef belirleme verilen DML eylem için tanımlanmış tüm etkin tetikleyici sahip olmayan belirtilir.Örneğin, hedef bir UPDATE deyim içinde tanımlanan OUTPUT yan tümceni, tablo herhangi UPDATE tetikleyicisi etkinleştirdiyseniz olamaz.

Sp_configure seçeneğini engellemek Tetikleyiciler sonuçlar ayarlanmışsa, bir INTO yan tümce içermeyen bir OUTPUT yan tümcesini deyim, gelen bir tetikleyici içinde çağrıldığında başarısız olmasına neden olur.

The OUTPUT yan tümce büyük nesne veri türleri destekler: nvarchar(max),varchar(max),varbinary(max), text,ntext,image, andxml.Güncelleştirme pucu yan tümcesi kullandığınızda deyim değiştirmek için birnvarchar(max),varchar(max), orvarbinary(max)sütun, önceki ve sonraki değeri görüntüler tam verilen referansta bulunulur,.TEXTPTR () işlev, ifade parçası olarak bulunamaz birtext,ntext, orimagesütun OUTPUT yan tümce.

Ara sonuç kümelerini veya tablo sırası olarak kullanan uygulamalarda OUTPUT kullanabilirsiniz.Diğer bir deyişle, uygulama sürekli olarak ekleme veya satırları kaldırma tablo.Aşağıdaki örnek, çıktı kullanır yan tümce silinmiş satırı arama uygulamaya dönmek için DELETE deyim içinde.

Bu örnek, bir satırdan kaldırır bir tablo sırası olarak kullanılan ve tek bir eylem işleme uygulamasında silinmiş değerleri döndürür.Diğer semantik da, bir yığın uygulamak için tablo kullanma gibi uygulanabilir.Bununla birlikte,SQL Server, satır işlenir ve çıktı kullanarak DML deyimlerini tarafından döndürülen sırasını garanti etmez yan tümce.Bu istenen semantik garanti veya birden çok satır DML işlemi için uygun, olduğunu anlamak bir uygun WHERE yan tümce eklemek için uygulama kadar hiçbir garantili sıradır.Aşağıdaki örnek, alt sorgu kullanır ve benzersiz bir özelliği olduğunu varsayarDatabaseLogIDsütun için uygulamak istediğiniz sıralama kurallarına.

The following example inserts a row into the ScrapReason table and uses the OUTPUT clause to return the results of the statement to the @MyTableVartable variable.İçinScrapReasonIDsütunu bir IDENTITY özellik ile tanımlanmış, bir değer olarak belirtilmemişINSERTTablo, sütun.Değeri tarafından üretilen ancak, NotDatabase Enginesütun iade içinOUTPUTyan tümcesindeki sütunINSERTED.ScrapReasonID.

Aşağıdaki örnek, tüm satırları silerShoppingCartItemTablo.Yan tümceOUTPUT DELETED.*belirleyen sonuçlar,DELETEdeyim, silinmiş satırlar, tüm sütunları olan arama uygulaması. döndürdüThe SELECT statement that follows verifies the results of the delete operation on the ShoppingCartItem table.

Aşağıdaki örnek güncelleştirmeleriVacationHourssütun,EmployeeTablo 25 oranında ilk 10 satırı.The OUTPUT clause returns the VacationHours value that exists before applying the UPDATE statement in the column DELETED.VacationHours, and the updated value in the column INSERTED.VacationHours to the @MyTableVartable variable.

İkiSELECTdeyimlerini izleyin, dönüş değerleri@MyTableVarve güncelleştirme işlemi sonuçlarınıEmployeeTablo.sonuçlar NotINSERTED.ModifiedDatesütun olmayan değerler aynıModifiedDatesütunundaEmployeeTablo.Bu, çünkü birAFTER UPDATETetik değerini güncelleştirirModifiedDategeçerli tarih olarak tanımlananEmployeeTablo.Ancak, sütunları döndürülenOUTPUTTetikleyicileri harekete önce verileri göstermek.

Tanımlayarak, aşağıdaki örnekte C örneği temel oluşturur bir ifade,OUTPUTgüncelleştirilmiş arasındaki fark olarak yanVacationHoursdeğeri,VacationHoursgüncelleştirme uygulanmadan önceki değeri.The value of this expression is returned to the @MyTableVartable variable in the column VacationHoursDifference.

Aşağıdaki örnek güncelleştirmeleriScrapReasonID sütun,WorkOrderTablo ile belirtilen tüm iş siparişleriProductIDveScrapReasonID.The OUTPUT INTO clause returns values from the table being updated (WorkOrder) and also from the Product table.The Product table is used in the FROM clause to specify the rows to update.İçinWorkOrdertablosunda birAFTER UPDATEüzerinde tanımlı tetikleyiciINTOanahtar gereklidir.

Aşağıdaki örnekte, satır silinirProductProductPhototanımlanan arama ölçütleri temel tabloFROMyan tümce ofDELETEdeyim.The OUTPUT clause returns columns from the table being deleted (DELETED.ProductID, DELETED.ProductPhotoID) and columns from the Product table.Bu tablo kullanılırFROMyan tümce için satırları silme.

Aşağıdaki örnek, kısmi bir değerin güncelleştirirDocumentSummary, annvarchar(max)sütunundaProduction.Documentkullanarak tablo,.WRITEyan tümce.Sözcükcomponentssözcüğü ile değiştirilirfeaturesYeni sözcük, sözcük varolan verileri ve karakter değiştirildi (uzunluk) olarak değiştirilecek başlangıç konumu (ofset) belirterek.The example uses the OUTPUT clause to return the before and after images of the DocumentSummary column to the @MyTableVartable variable.Dikkat tam önce ve sonra resimleriDocumentSummarysütun döndürdü.

Aşağıdaki örnekOUTPUTsonuçlar döndürmek için bir tetikleyici yan tetikleyici operasyon.İlk olarak, bir görünüm oluşturulurScrapReasonTablo ve birINSTEAD OF INSERTTetikleyici tanımlı, yalnızca görünümNamesütun tablonun temel değiştiren kullanıcı.İçin sütunScrapReasonIDolan birIDENTITYtemel sütununda tablo, tetikleyici kullanıcı tarafından sağlanan değerin. yoksayarBöyleceDatabase Engineiçin otomatik olarak oluşturmak doğru değeri.Ayrıca, değer için kullanıcı tarafından sağlananModifiedDategöz ardı edilir ve küme geçerli tarih.The OUTPUT clause returns the values actually inserted into the ScrapReason table.

USE AdventureWorks;
GO
IF OBJECT_ID('dbo.vw_ScrapReason','V') IS NOT NULL
    DROP VIEW dbo.vw_ScrapReason;
GO
CREATE VIEW dbo.vw_ScrapReason
AS (SELECT ScrapReasonID, Name, ModifiedDate
    FROM Production.ScrapReason);
GO
CREATE TRIGGER dbo.io_ScrapReason 
    ON dbo.vw_ScrapReason
INSTEAD OF INSERT
AS
BEGIN
--ScrapReasonID is not specified in the list of columns to be inserted 
--because it is an IDENTITY column.
    INSERT INTO Production.ScrapReason (Name, ModifiedDate)
        OUTPUT INSERTED.ScrapReasonID, INSERTED.Name, 
               INSERTED.ModifiedDate
    SELECT Name, getdate()
    FROM inserted;
END
GO
INSERT vw_ScrapReason (ScrapReasonID, Name, ModifiedDate)
VALUES (99, N'My scrap reason','20030404');
GO

İşte 12 Nisan 2004'te, oluşturulan sonuç kümesi (' 2004-04-12').DikkatScrapReasonIDActualveModifiedDatesütun sağlanan değerler yerine tetiği işlemi tarafından oluşturulan değerleri yansıtacakINSERTdeyim.

ScrapReasonID adı ModifiedDate

-------------  ---------------- -----------------------

17 Benim hurda neden 2004-04-12 16:23:33.050

Aşağıdaki örnek oluştururEmployeeSalesTablo ve birden fazla satır kullanma mikrofona ekleyen birINSERTdeyim ile birSELECTkaynak tablolar. veri almak için bildirimiThe EmployeeSales table contains an identity column (EmployeeID) and a computed column (ProjectedSales).Tarafından üretilen bu değerler içinSQL Server Database Engineekleme işlemi sırasında bu sütunların hiçbiri tanımlanabilir@MyTableVar.

Aşağıdaki örnekte, satır silinirProductProductPhototanımlanan arama ölçütleri temel tabloFROMyan tümce ofDELETEdeyim.The OUTPUT INTO clause returns columns from the table being deleted (DELETED.ProductID, DELETED.ProductPhotoID) and columns from the Product table to the @MyTableVartable variable.The Product table is used in the FROM clause to specify the rows to delete.The OUTPUT clause returns the DELETED.ProductID, DELETED.ProductPhotoID columns and the date and time the row was deleted from the ProductProductPhoto table to the calling application.

Aşağıdaki örnek, döndürülen verileri yakalayanOUTPUTyan birMERGEdeyim ve bu verileri başka bir tablo. eklerThe MERGE statement updates the Quantity column of the ProductInventory table daily, based on orders that are processed in the SalesOrderDetail table.Bu da siler satır ürünleri, stoklar bırakmak için0veya altı.Bu örnek satır silinir, yakalar ve başka bir tabloya eklerZeroInventoryizleyen ürünleri hiçbir stok.