ALTER TRIGGER (Transact-SQL)

構文

Trigger on an INSERT, UPDATE, or DELETE statement to a table or view (DML Trigger)
ALTER TRIGGER schema_name.trigger_name 
ON ( table | view ) 
[ WITH <dml_trigger_option> [ ,...n ] ]
(FOR | AFTER | INSTEAD OF ) 
{ [ DELETE ] [ , ] [ INSERT ] [ , ] [ UPDATE ] } 
[ NOT FOR REPLICATION ] 
AS { sql_statement [ ; ] [ ...n ] | EXTERNAL NAME <method specifier> [ ; ] } 

<dml_trigger_option> ::=
    [ ENCRYPTION ]
    [ <EXECUTE AS Clause> ]

<method_specifier> ::=
        assembly_name.class_name.method_name

Trigger on a CREATE, ALTER, DROP, GRANT, DENY, REVOKE, or UPDATE statement (DDL Trigger)

ALTER TRIGGER trigger_name 
ON { DATABASE | ALL SERVER } 
[ WITH <ddl_trigger_option> [ ,...n ] ]
{ FOR | AFTER } { event_type [ ,...n ] | event_group } 
AS { sql_statement [ ; ] | EXTERNAL NAME <method specifier> 
[ ; ] }
} 

<ddl_trigger_option> ::=
    [ ENCRYPTION ]
    [ <EXECUTE AS Clause> ]

<method_specifier> ::=
        assembly_name.class_name.method_name

Trigger on a LOGON event (Logon Trigger)
ALTER TRIGGER trigger_name 
ON ALL SERVER 
[ WITH <logon_trigger_option> [ ,...n ] ]
{ FOR| AFTER } LOGON 
AS { sql_statement  [ ; ] [ ,...n ] | EXTERNAL NAME < method specifier >  [ ; ] }

<logon_trigger_option> ::=
    [ ENCRYPTION ]
    [ EXECUTE AS Clause ]

<method_specifier> ::=
    assembly_name.class_name.method_name

引数

• schema_name
  DML トリガーが属しているスキーマの名前を指定します。DML トリガーのスコープは、トリガーが作成されたテーブルまたはビューのスキーマです。schema_name は、DML トリガーと、トリガーに対応するテーブルまたはビューが既定のスキーマに属している場合のみ、省略可能です。schema_name は、DDL トリガーまたはログオン トリガーに対しては指定できません。

• trigger_name
  変更する既存のトリガーです。

• table | view
  DML トリガーが実行されるテーブルまたはビューです。テーブルまたはビューの完全修飾名の指定は省略可能です。

• DATABASE
  DDL トリガーのスコープを現在のデータベースに適用します。これを指定すると、現在のデータベースで event_type または event_group が発生するたびにトリガーが起動します。

• ALL SERVER
  DDL トリガーまたはログオン トリガーのスコープを現在のサーバーに適用します。これを指定すると、現在のサーバーの任意の場所で event_type または event_group が発生するたびにトリガーが起動します。

• WITH ENCRYPTION
  ALTER TRIGGER ステートメントのテキストが含まれている sys.syscomments や sys.sql_modules のエントリを暗号化します。WITH ENCRYPTION を使用すると、そのトリガーを SQL Server レプリケーションの一部としてパブリッシュできなくなります。WITH ENCRYPTION は、CLR トリガーには指定できません。

  注
  トリガーが WITH ENCRYPTION を使用して作成されている場合、それを有効なままにするには、ALTER TRIGGER ステートメントで WITH ENCRYPTION を再度指定する必要があります。

• EXECUTE AS
  トリガーが実行されるセキュリティ コンテキストを指定します。このオプションを使用することで、SQL Server のインスタンスが使用するユーザー アカウントを制御することができます。このアカウントは、トリガーが参照するデータベース オブジェクトに対する権限を検証するために使用されます。

  詳細については、「EXECUTE AS 句 (Transact-SQL)」を参照してください。

• AFTER
  トリガーをアクティブにする SQL ステートメントが正常に実行された後にのみ、そのトリガーを起動することを指定します。このトリガーが起動される前に、すべての連鎖参照操作および制約チェックも正常に終了している必要があります。

  FOR キーワードのみが指定されている場合は、AFTER が既定値です。

  DML AFTER トリガーは、テーブルでのみ定義できます。

• INSTEAD OF
  その DML トリガーを、トリガーをアクティブにする SQL ステートメントの代わりに実行するように指定します。したがって、トリガーをアクティブにするステートメントの操作は無効になります。DDL トリガーまたはログオン トリガーでは INSTEAD OF を指定できません。

  テーブルまたはビューでは、INSERT、UPDATE、または DELETE の各ステートメントに定義できる INSTEAD OF トリガーは 1 つだけですが、ビューに別のビューを作成して、各ビューに独自の INSTEAD OF トリガーを定義することは可能です。

  INSTEAD OF トリガーは、WITH CHECK OPTION を使用して作成したビューでは使用できません。WITH CHECK OPTION が指定されているビューに対して INSTEAD OF トリガーを追加すると、SQL Server でエラーが発生します。ユーザーは、INSTEAD OF トリガーを定義する前に、ALTER VIEW を使用して WITH CHECK OPTION を削除する必要があります。

• { [ DELETE ] [ , ] [ INSERT ] [ , ] [ UPDATE ] } | { [INSERT ] [ , ] [ UPDATE ] }
  このテーブルまたはビューに対して実行したときに DML トリガーをアクティブにするデータ変更ステートメントを指定します。少なくとも 1 つのオプションを指定する必要があります。トリガー定義では、このキーワードを指定する順序や組み合わせを問いません。複数のオプションを指定するときは、オプションをコンマで区切ります。

  INSTEAD OF トリガーの場合、目的のテーブルに ON DELETE 連鎖参照操作を指定している参照関係があるときは、DELETE オプションを指定できません。同様に、目的のテーブルに ON UPDATE 連鎖参照操作を指定している参照関係があるときは、UPDATE オプションを指定できません。詳細については、「ALTER TABLE (Transact-SQL)」を参照してください。

• event_type
  実行後に DDL トリガーが起動される Transact-SQL 言語イベントの名前です。DDL トリガーで使用できるイベントの一覧については、「DDL イベント」を参照してください。

• event_group
  Transact-SQL 言語イベントの定義済みグループの名前を指定します。DDL トリガーは、event_group に属する Transact-SQL 言語イベントの実行後に起動します。DDL トリガーで使用できるイベント グループの一覧については、「DDL イベント グループ」を参照してください。対応するイベントの種類を sys.trigger_events カタログ ビューに追加すると、event_group は、ALTER TRIGGER の実行が終了した後、マクロとしても機能します。

• NOT FOR REPLICATION
  トリガーに関係するテーブルをレプリケーション エージェントが変更するときに、トリガーを実行してはいけないことを示します。詳細については、「NOT FOR REPLICATION を使用した制約、ID、およびトリガの制御」を参照してください。

• sql_statement
  トリガー条件とトリガー動作です。

• <method_specifier>
  トリガーにバインドするアセンブリのメソッドを指定します。このメソッドは引数を受け取らず、void を返す必要があります。class_name は、有効な SQL Server 識別子で、アセンブリの表示設定が指定されたアセンブリ内にクラスとして存在する必要があります。クラスを入れ子にはできません。

説明

ALTER TRIGGER の詳細については、「CREATE TRIGGER (Transact-SQL)」の「解説」を参照してください。

DML トリガー

DDL トリガー

権限

DML トリガーを変更するには、トリガーが定義されているテーブルやビューに対する ALTER 権限が必要です。

サーバー スコープ (ON ALL SERVER) で定義されている DDL トリガー、またはログオン トリガーを変更するには、サーバーに対する CONTROL SERVER 権限が必要です。データベース スコープ (ON DATABASE) で定義されている DDL トリガーを変更するには、現在のデータベースでの ALTER ANY DATABASE DDL TRIGGER 権限が必要です。

例

次の例では、ユーザーが SalesPersonQuotaHistory テーブルにデータを追加したり、データを変更したりしようとすると、クライアントに対してユーザー定義のメッセージを出力する DML トリガーを作成します。次に ALTER TRIGGER を使用してトリガーを変更し、トリガーを INSERT 操作だけに適用します。このトリガーは、テーブルの更新や行の挿入を行うユーザーに対して、Compensation 部門にも変更を知らせる必要があることを連絡できるので有用です。

USE AdventureWorks2008R2;
GO
IF OBJECT_ID(N'Sales.bonus_reminder', N'TR') IS NOT NULL
    DROP TRIGGER Sales.bonus_reminder;
GO
CREATE TRIGGER Sales.bonus_reminder
ON Sales.SalesPersonQuotaHistory
WITH ENCRYPTION
AFTER INSERT, UPDATE 
AS RAISERROR ('Notify Compensation', 16, 10);
GO
-- Now, change the trigger.
USE AdventureWorks2008R2;
GO
ALTER TRIGGER Sales.bonus_reminder
ON Sales.SalesPersonQuotaHistory
AFTER INSERT
AS RAISERROR ('Notify Compensation', 16, 10);
GO

関連項目

参照

概念