ALTER EVENT-Anweisung

Ändert die Definition eines Ereignisses oder seiner zugehörigen Verarbeitungsroutine zum Automatisieren vordefinierter Aktionen bzw. die Definition von geplanten Aktionen. Sie können diese Anweisung auch verwenden, um die Definition eines Event-Handlers zu verbergen.

Syntax 1 - Ereignis ändern

ALTER EVENT [ owner.]event-name 
[ AT { CONSOLIDATED | REMOTE | ALL } ]
[ FOR { PRIMARY | ALL} ]
[ { DELETE TYPE 
   | TYPE event-type 
   | WHERE { trigger-condition | NULL }
   | { ADD | ALTER | DELETE } SCHEDULE schedule-spec } ]
[ ENABLE | DISABLE ]
[ [ ALTER ] HANDLER compound-statement | DELETE HANDLER ]

event-type :
BackupEnd 
| Connect 
| ConnectFailed 
| DatabaseStart
| DBDiskSpace
| Deadlock 
| "Disconnect" 
| GlobalAutoincrement 
| GrowDB
| GrowLog 
| GrowTemp
| LogDiskSpace 
| RAISERROR
| ServerIdle 
| TempDiskSpace

trigger-condition :
event_condition( condition-name ) { = | < | > | != | <= | >= } value

schedule-spec :
[ schedule-name ]
   { START TIME start-time | BETWEEN start-time AND end-time }
   [ EVERY period { HOURS | MINUTES | SECONDS } ]
   [ ON { ( day-of-week, ... ) | ( day-of-month, ... ) } ]
   [ START DATE start-date ]

event-name | schedule-name :  identifier

day-of-week :  string

value | period | day-of-month :  integer

start-time | end-time : time

start-date : date

Syntax 2 - Definition eines Event-Handlers verbergen

ALTER EVENT event-name SET HIDDEN

Parameter

AT-Klausel Verwenden Sie diese Klausel, um die Angabe in Bezug zur Datenbank zu ändern, bei der das Ereignis verarbeitet wird.
FOR-Klausel Verwenden Sie diese Klausel in einem Datenbankspiegelungssystem oder einem Scale-Out-System mit Schreibschutz, um die Datenbanken einzuschränken, in denen das Ereignis verarbeitet wird.
DELETE TYPE-Klausel Verwenden Sie diese Klausel, um eine Zuordnung des Ereignisses zu einem Ereignistyp zu entfernen.
ADD | ALTER | DELETE SCHEDULE-Klausel Verwenden Sie diese Klausel, um die Definition eines Abfolgeplans zu ändern. Es kann nur ein Abfolgeplan in einer einzigen ALTER EVENT-Anweisung geändert werden.
WHERE-Klausel Verwenden Sie diese Klausel, um die Triggerbedingung, unter der ein Ereignis ausgelöst wird, zu ändern. Die Option WHERE NULL löscht eine Bedingung.
START TIME-Klausel Mit dieser Klausel geben Sie die Startzeit und optional die Endzeit für das Ereignis ein. Die Parameter start-time und end-time sind Zeichenfolgen (z.B. '12:34:56'). Variablen und Ausdrücke sind nicht zulässig (z.B. NOW()).
START DATE-Klausel Mit dieser Klausel geben Sie das Startdatum für das Ereignis ein. Der Parameter start-date ist eine Zeichenfolge. Variablen und Ausdrücke sind nicht zulässig (z.B. TODAY()).
SET HIDDEN-Klausel Mit dieser Klausel blenden Sie die Definition eines Event-Handlers aus. Die Angabe der SET HIDDEN-Klausel führt zur permanenten Verschleierung der Event-Handler-Definition, die in der Aktionsspalte der Systemtabelle ISYSEVENT gespeichert ist.

Bemerkungen

Mit dieser Anweisung können Sie eine Ereignisdefinition ändern, die mit CREATE EVENT erstellt wurde. Sie können die Anweisung folgendermaßen verwenden:

Definition eines Event-Handlers verbergen
Einen Event-Handler ohne Triggerbedingung oder Abfolgeplan während der Entwicklungsphase definieren und testen und anschließend dann die Bedingungen zum Ausführen mithilfe von ALTER EVENT hinzufügen, sobald der Event-Handler fertiggestellt ist

Wenn Sie ein Ereignis ändern müssen, können Sie es deaktivieren, während es läuft, indem Sie die Anweisung ALTER EVENT...DISABLE ausführen. Um ein Element in Sybase Central zu deaktivieren, rechtsklicken Sie auf das Ereignis und deaktivieren die Option Aktiviert. Die Deaktivierung des Ereignisses unterbricht die Ausführung des aktuellen Event-Handlers nicht. Der Event-Handler läuft bis zum Abschluss weiter. Wenn der Event-Handler abgeschlossen ist, wird er erst wieder gestartet, wenn Sie ihn wieder aktivieren. Sie können die Definition ändern und wieder aktivieren. Um zu ermitteln, welche Ereignisse laufen, führen Sie folgende Anweisung aus:

SELECT * 
FROM dbo.sa_conn_info()
WHERE CONNECTION_PROPERTY( 'EventName',Number ) = 'event-name';