# ALTER EVENT
#### 功能描述
修改已创建的定时任务中的参数。
#### 注意事项
- 定时任务相关操作只有sql_compatibility = 'B'时支持。
- 只有定时任务的所有者有权修改对应的定时任务，系统管理员默认拥有修改所有定时任务的权限。
- 可以通过SHOW EVENTS或在PG_JOB表中查看log_user列来获得job的所有者信息。
- 每次修改定时任务成功后，会更新被修改job的所有者为当前用户，若修改定时任务时指定了definer，则更新为被指定的definer。
- definer选项场景限制与[CREATE EVENT](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0532.html#ZH-CN_TOPIC_0000002235339453)章节中对definer限制场景一致。
  ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
  系统管理员修改其他用户创建的定时任务后，被修改定时任务的所有者将切换为系统管理员，待执行语句将使用系统管理员的权限执行。
  
 
#### 语法格式
```
ALTER
    [DEFINER = user]    
EVENT event_name
    [ON SCHEDULE schedule]
    [ON COMPLETION [NOT] PRESERVE]
    [RENAME TO new_event_name]
    [ENABLE | DISABLE | DISABLE ON SLAVE]
    [COMMENT 'string']
    [DO event_body]
```
#### 参数说明
- DEFINER 定时任务待执行语句在执行时使用的权限。默认情况下使用当前创建定时任务者的权限，当definer被指定时，使用被指定用户user的用户权限。
  definer参数只有具有sysadmin权限的用户有权指定。
  
- ON SCHEDULE 定时任务执行时刻。其中schedule子句与[CREATE EVENT](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0532.html#ZH-CN_TOPIC_0000002235339453)中schedule一致。
  
- RENAME TO 更新定时任务名。
  
- ON COMPLETION \[NOT\] PRESERVE 默认情况下，一旦事务处于完成状态，系统表中就会立刻删除该定时任务。用户可以通过设置ON COMPLETION PRESERVE来覆盖默认行为。
  
- ENABLE \| DISABLE \| DISABLE ON SLAVE 创建定时任务后，定时任务默认处于ENABLE状态，即到规定时间立即执行待执行语句。用户可以使用DISABLE关键字，改变定时任务的活动状态。DISABLE ON SLAVE表现与DISABLE一致。
  
- COMMENT 用户可以给定时任务添加注释，注释内容在GS_JOB_ATTRIBUTE表中查看。
  
- DO 定时任务待执行语句。
  
 
#### 示例
```
--创建一个定时任务。
gaussdb=# CREATE TABLE t_ev(num int);
gaussdb=# CREATE EVENT IF NOT EXISTS event_e1 ON SCHEDULE AT sysdate + interval 5 second + interval 33 minute DISABLE DO insert into t_ev values(0);
--修改定时任务状态和待执行语句。
gaussdb=# ALTER EVENT event_e1 ENABLE DO select 1;
--修改定时任务名。
gaussdb=# ALTER EVENT event_e1 RENAME TO event_ee;
--查询定时任务。
gaussdb=# SHOW EVENTS;
--删除定时任务。
gaussdb=# DROP EVENT event_ee;
--删除表。
gaussdb=# DROP TABLE t_ev;
```
#### 相关链接
[CREATE EVENT](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0532.html#ZH-CN_TOPIC_0000002235339453)，[DROP EVENT](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0584.html#ZH-CN_TOPIC_0000002235459441)，[SHOW EVENTS](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0657.html#ZH-CN_TOPIC_0000002200419514)