警报

达梦数据库还提供了警报的功能,允许用户定义一些自己想要捕获的动作,如果这些动作发生时,系统就会将对应信息存储到指定的表中,将想要得到的信息存储起来,以便做到实时的监控。

创建、修改和删除警报可以通过以下两种方式来实现。一是通过系统过程来实现;二是通过图形化客户端 MANAGER 管理工具实现。用户选择其中的一种即可。

5.1 通过系统过程实现

5.1.1 创建、删除和修改警报

5.1.1.1 创建警报

创建一个警报可以通过系统过程 SP_CREATE_ALERT 实现。警报的定义信息都存储在系统表 SYSALERTS 中。

语法如下:

SP_CREATE_ALERT (

	name 			varchar(128),

	enabled 		int,

	type 			int,

	errtype 		int,

	errcode 		int,

	delaytime 		int,

	describe 		varchar(8187)

)

参数详解

  • NAME

警报名。必须是有效的标识符,同时不能是 DM 关键字。警报不能同名,在创建时系统会检测这个警报是否存在,如果存在则报错。

  • ENABLE

警报是否开启。取值 0 或 1。1 是;0 否。

  • TYPE

警报的类型。取值 0 或 1。0 表示发生错误时警报;1 表示发生某些数据库事件时警报。

  • ERRTYPE

触发警报的错误和数据库事件。与参数 TYPE 相关。

当 TYPE=0 时,ERRTYPE 表示触发警报的错误类型。取值 1~12。具体含义分别为:1 常规错误;2 启动错误;3 系统错误;4 服务器配置错误;5 分析阶段错误;6 权限错误;7 运行时错误;8 备份恢复错误;9 作业管理错误;10 数据库复制错误;11 其它错误;12 指定错误码。

当 TYPE=1 时,ERRTYPE 表示触发警报的数据库事件。取值 1~4。具体含义分别为:1DDL 事件;2 授权回收事件;3 连接或断开数据库事件;4 数据库备份恢复事件。

  • ERRCODE

指定错误码。错误码取值和参数 TYPE、ERRTYPE 相关。

当 TYPE=0、ERRTYPE 取 1~12 时,指定各种错误类型相关的错误码,ERRCODE 必须是小于 0 的整数。

当 TYPE=1、ERRTYPE=1 时,指定 DDL 事件的错误码,ERRCODE 取值 1~15。如何取值,请参考如下规则:因为 DDL 事件包含 CREATE、ALTER、DROP 和 TRUNC 四种,所以此处的错误码是四种当中的任意几个组合值。ERRCODE 在 DM 数据库系统内部用四位二进制来表示它们的组合,从低位到高位依次是:CREATE、ALTER、DROP、TRUNCATE。1 表示指定,0 表示不指定。用户输入的 ERRCODE 值需要转化为十进制。例如,指定 CREATE 和 DROP,内部二进制表示为 0101,转化为十进制为 5,所以 ERRCODE 值就是 5。

当 TYPE=1、ERRTYPE=2 时,指定授权回收事件的错误码,ERRCODE 取值 1、2、3。1 表示 GRANT 的错误码;2 表示 REVOKE 的错误码;3 表示 GRANT 和 REVOKE 的错误码。

当 TYPE=1、ERRTYPE=3 时,指定连接事件的错误码,取值 1、2、3。1 表示 LOGIN 的错误码;2 表示 LOGOUT 的错误码;3 表示 LOGIN 和 LOGOUT 的错误码。

当 TYPE=1、ERRTYPE=4 时,指定数据库备份恢复事件的错误码,取值 1、2、3。1 表示 BACKUP 的错误码;2 表示 RESTORE 的错误码;3 表示 BACKUP 和 RESTORE 的错误码。

  • DELEYTIME

表示警报发生后,推迟多长时间通知操作员。范围 0~3600,单位秒。

  • ADDITION_TXT

表示警报的注释,最长为 500 个字节。

例如,创建一个名为 ALERT1 的警报。

SP_CREATE_ALERT('ALERT1',1, 0, 1, -600, 1, '错误码的测试');

上面的例子创建了一个名为 ALERT1 的警报,ENABLE 为 1 表示开启,TYPE 为 0 表示发生错误时警报,ERRTYPE 指定的是 1 表示常规错误,表示只有发生常规错误时警报才发生,DELEYTIME 指定可以推迟 1 秒钟通知操作员。警报发生后,系统会将对应信息存储到上面提到的 SYSALERTHISTORIES 表中。

5.1.1.2 修改警报

修改警报可以通过系统过程 SP_ALTER_ALERT 来实现。

语法如下:

SP_ALTER_ALERT (

	name 			varchar(128),

	enabled 		int,

	type 			int,

	errtype 		int,

	errcode 		int,

	delaytime 		int,

	describe 		varchar(8187)

)

参数详解

它的参数和 SP_CREATE_ALERT 的参数完全相同,除了 NAME 不可修改外,其他的属性都可修改。对于可修改参数,如果要修改,则指定新值;如果不修改,则指定原值即可。

例如,下面的语句修改警报 ALERT1。

SP_ALTER_ALERT('ALERT1', 1, 1, 1, 15, 1, 'DDL警报测试');

上面的例子修改警报 ALERT1,ENABLE 还是原来的值,没有被修改;TYPE 修改为 1,表示对事件的捕获;ERRTYPE 修改为 1,表示的是对事件中的 DDL 进行捕获;ERRCODE 修改为 15,从上面可以看出,这个是一个组合值,对于 DDL 事件共有四种类型(CREATE、ALTER、DROP、TRUNC),每一个位表示一个操作,这里的 15 可以被分解为二进制 1111,可以看出四个位都为 1,也就是选中了这四个操作中的所有操作;DELAYTIME 没有被修改;ADDITION_TXT 被修改为'DDL 警报测试'。修改后的警报只要系统做了 DDL 操作就会被激发,同时会将相应信息存储到上面提到的 SYSALERTHISTORIES 表中。

5.1.1.3 删除警报

删除警报通过调用系统过程 SP_DROP_ALERT 实现。

语法如下:

SP_DROP_ALERT (

	name varchar(128),

)

参数详解

  • NAME

待删除的警报名。删除时系统会检测这个警报是否存在,如果不存在则报错。

例如 下面的语句删除警报 ALERT1。

SP_DROP_ALERT('ALERT1');

5.1.2 为警报关联操作员

5.1.2.1 关联

如果想要将警报的执行结果通知给指定操作员,需要将这个警报关联要通知到的操作员,关联操作员通过系统 SP_ALERT_ADD_OPERATOR 实现。一个警报可以关联多个操作员。

语法如下:

SP_ALERT_ADD_OPERATOR (

	alertname 		varchar(128),

	opr_name 		varchar(128),

	enablemail 		int,

	enablenetsent 	int

)

参数详解

  • ALERTNAME

警报名。表示要将哪一个警报进行关联,在创建时系统会检测这个警报是否存在,如果不存在则报错。

  • OPER_NAME

操作员名。表示要与哪一个操作员进行关联,在创建时系统会检测这个操作员是否已经存在,如果不存在则报错。

  • ENABLEMAIL

表示指定警报的执行结果是否用邮件的方式通知指定的操作员。1 是;0 否。

  • ENABLENETSEND

表示指定警报的执行结果是否用网络发送的方式通知指定的操作员。1 是;0 否。这个功能只有在 WINDOWS 下才起作用。

例如,下面的语句指定 ALERT1 警报的执行结果用邮件和网络两种方式通知操作员 TOM。

SP_ALERT_ADD_OPERATOR('ALERT1','TOM',1,1);

5.1.2.2 取消

当不再需要某个警报与操作员的关联,可以通过系统过程 SP_ALERT_DROP_OPERATOR 来取消关联。

语法如下:

SP_ALERT_DROP_OPERATOR (

	alertname 	varchar(128),

	opr_name 	varchar(128)

)

参数详解

  • ALERTNAME

警报名。表示要取消关联的警报。系统会检测这个警报是否存在,如果不存在则报错。

  • OPER_NAME

操作员名。表示要取消关联的操作员,系统会检测这个操作员是否已经存在,如果不存则会报错。

例如,取消警报 TEST 与操作员 TOM 的关联,取消之后警报的执行结果不会再通知操作员 TOM。

SP_ALERT_DROP_OPERATOR('ALERT1','TOM');

5.1.3 清除警告日志记录

清除迄今为止某个警报的所有日志记录,即删除表 SYSALERTHISTORIES 中的相关记录。可以通过系统过程 SP_ALERT_DROP_HISTORIES 来实现。

语法如下:

SP_ALERT_DROP_HISTORIES (

	alertname varchar(128)

)

参数详解

  • ALERTNAME

待清除日志的警报名。

例如,清除所有的 ALERT1 警报日志记录。

SP_ALERT_DROP_HISTORIES ('ALERT1');

5.2 通过图形化客户端实现

警告对话框用于实现警告的创建与修改。包括:常规、通知信息和 DDL 三部分。

5.2.1 常规

警告的常规属性设置页面。

新建警报-常规界面

图5.1 新建警报-常规界面

参数详解

  • 警告名

警告的标识名称。

  • 启用

是否启用这个警告。

  • 警报类型

指定警报的类型。警报类型有错误警报和事件警报,分别表示发生错误时警报和发生某些事件时警报。

  • 错误类型或事件类型

错误类型或事件类型由警报类型决定。

1.如果警报类型为错误警报,则此处为错误类型。错误类型以下 12 个可选项:

1)常规错误

2)启动错误

3)系统错误

4)服务器配置错误

5)语法分析错误

6)权限错误

7)运行时错误

8)备份恢复错误

9)作业管理错误

10)数据库复制错误

11)其他错误

12)指定错误码

2.如果警报类型为事件警报,则此处为事件警报。事件类型有如下 5 个可选项:

1)DDL 事件

2)授权回收事件

3)连接或断开数据库事件

4)数据库分析事件

5)数据库备份恢复事件

  • 错误编码或事件编码

    错误编码或事件编码由警报类型决定。

1.如果警报类型为错误警报,此处为错误编码。错误编码的取值由错误类型决定。

1)如果错误类型为指定错误码,那么此需要错误编码。指定的错误编码必须是小于 0 的值。

2)如果错误类型为指定错误码之外的其他方式,那么此处不需要指定错误编码。

2.如果警报类型为事件警报,此处为事件编码。事件编码的取值由错误类型决定。

1)如果错误类型为 DDL 事件时,那么事件编码可以是 CREATE、ALTER、DROP、TRUNC 其中的一个或任意多个的组合。

2)如果错误类型为授权回收事件时,那么事件编码可以是 GRANT 和 REVOKE 其中的一个或组合。

3)如果错误类型为连接或断开数据库事件时,那么事件编码可以是 LOGIN、LOGOUT 其中的一个或组合。

4)如果错误类型为数据库分析事件时,那么事件编码为 ANALYZE 。

5)如果错误类型为数据库备份恢复事件时,那么事件编码可以是 BACKUP、RESTORE 其中的一个或组合。

  • 包含信息

这个参数表示的是对这个警报的一些注释字符串,长度最长为 500 个字节。

  • 延迟时间

这个参数表示的是警报通知操作员时需要推迟的时间,推迟的时间范围为 0 到 3600 秒,也就是说必须是在一个小时范围之内。

5.2.2 通知信息

警告的通知信息属性设置页面。

新建警报-通知界面

图5.2 新建警报-通知界面

参数详解

  • 操作员列表

已存在的各操作员列表。

  • 操作员

操作员名。

  • 电子邮件通知

是否采用电子邮件通知。1 是;0 否。

  • 网络消息通知

是否采用网路消息通知。1 是;0 否。

5.2.3 DDL

  显示警告创建与修改的 SQL 语句。

新建警报-DDL 界面

图5.3 新建警报-DDL界面

     参数详解

  • 保存

保存 SQL 脚本到文件中。

微信扫码
分享文档
扫一扫
联系客服