UPDATE() (Transact-SQL)

Gibt einen booleschen Wert zurück, der zeigt, ob der Versuch einer INSERT- oder UPDATE-Aktion an einer angegebenen Tabelle oder Sicht unternommen wurde. UPDATE() wird im Text eines Transact-SQL-INSERT- oder UPDATE-Triggers verwendet, um zu testen, ob der Trigger bestimmte Aktionen ausführen sollte.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

UPDATE ( column ) 

Argumente

  • column
    Der Name der auf eine INSERT- oder UPDATE-Aktion zu testenden Spalte. Da der Tabellenname in der ON-Klausel des Triggers angegeben ist, nehmen Sie den Tabellennamen nicht vor dem Spaltennamen in die Klausel auf. Die Spalte kann einen beliebigen Datentyp enthalten, der von SQL Server unterstützt wird. Berechnete Spalten können jedoch in diesem Kontext nicht verwendet werden.

Rückgabetypen

Boolesch

Hinweise

UPDATE() gibt TRUE zurück, und zwar unabhängig davon, ob ein INSERT- oder UPDATE-Versuch erfolgreich ist oder nicht.

Um mehrere Spalten auf eine INSERT- oder UPDATE-Aktion zu testen, geben Sie nach der ersten eine separate UPDATE(column)-Klausel an. Mithilfe von COLUMNS_UPDATED können auch mehrere Spalten auf INSERT- oder UPDATE-Aktionen getestet werden. Das hierbei zurückgegebene Bitmuster gibt an, welche Spalten eingefügt oder aktualisiert wurden.

IF UPDATE gibt den TRUE-Wert in INSERT-Aktionen zurück, da in die Spalten entweder explizite Werte oder implizite Werte (NULL) eingefügt werden.

HinweisHinweis

Die IF UPDATE(column)-Klausel funktioniert genauso wie eine IF-, IF…ELSE- oder WHILE-Klausel und kann den BEGIN…END-Block verwenden. Weitere Informationen finden Sie unter Ablaufsteuerungssprache (Transact-SQL).

UPDATE(column) kann überall innerhalb des Texts eines Transact-SQL-Triggers verwendet werden.

HinweisHinweis

In SQL Server 2000 erkennt UPDATE() keine Änderungen an timestamp-Spalten. Für diese Spalten gibt eine IF UPDATE()-Klausel innerhalb des Triggertexts den Wert FALSE zurück, unabhängig davon, ob die Spalten aktualisiert werden oder nicht. In SQL Server 2008 und SQL Server 2005 erkennt UPDATE() Änderungen an timestamp-Spalten. Eine IF UPDATE()-Klausel innerhalb eines DML-Triggertexts gibt den Wert TRUE zurück, wenn diese Spalten aktualisiert werden.

Beispiele

Das folgende Beispiel erstellt einen Trigger, der eine Meldung an den Client ausgibt, wenn jemand versucht, die StateProvinceID- oder PostalCode-Spalten der Address-Tabelle zu aktualisieren.

USE AdventureWorks2008R2;
GO
IF EXISTS (SELECT name FROM sys.objects
      WHERE name = 'reminder' AND type = 'TR')
   DROP TRIGGER Person.reminder;
GO
CREATE TRIGGER reminder
ON Person.Address
AFTER UPDATE 
AS 
IF ( UPDATE (StateProvinceID) OR UPDATE (PostalCode) )
BEGIN
RAISERROR (50009, 16, 10)
END;
GO
-- Test the trigger.
UPDATE Person.Address
SET PostalCode = 99999
WHERE PostalCode = '12345';
GO