gbase数据、南大通用产品文档：GBase8sGBASEDBTCONTIME 环境变量

GBASEDBTCONTIME 环境变量指定 CONNECT 语句进行建立与数据库服务器的
连接的每次尝试持续多少秒后返回错误。如果未设置任何值，那么缺省值 60 秒通常支持
几百个并发客户机连接，但对于某些系统，如果设置很低的值（例如 15），可能极少会
遇到连接错误。节点间的总距离、硬件速度、流量和网络并发性级别都会影响优化
GBASEDBTCONTIME 时应设置的值。
GBASEDBTCONTIME 和 GBASEDBTCONRETRY 环境变量允许您将客户机端连接功能配置为
重试该连接而不是返回 -908 错误。

seconds 表示建立与数据库服务器的连接的尝试所花的最少秒数。
例如：输入以下命令以将 GBASEDBTCONTIME 设置为 60 秒：
setenv GBASEDBTCONTIME 60

GBase 8s SQL 指南：参考
南大通用数据技术股份有限公司 - 182 -
如果 GBASEDBTCONTIME 设置为 60 而 GBASEDBTCONRETRY 设置为 3，
那么在异常终止之前，连接数据库服务器的尝试会（在初次尝试 0 秒后）在第 20 秒、
第 40 秒和第 60 秒进行（如有必要）。这一 20 秒时间间隔是
GBASEDBTCONTIME 除以 GBASEDBTCONRETRY 的结果。如果尝试将
GBASEDBTCONTIME 设置为零，那么数据库服务器自动将其复位为缺省值 60 秒。
如果 CONNECT 语句的执行涉及搜索 DBPATH，那么应用以下规则：
DBPATH 设置中的所有适当服务器至少都会被访问一次，即使可能超出
GBASEDBTCONTIME 值也是如此。因此，CONNECT 语句运行时可能会超出
GBASEDBTCONTIME 时间限制，并返回指示连接失败或找不到该数据库的错误。
GBASEDBTCONRETRY 指定应对 DBPATH 中的每个数据库服务器条目进行
多少次附加连接尝试。
GBASEDBTCONTIME 值在 DBPATH 中指定数目的数据库服务器条目之间分
配。因此，如果 DBPATH 包含大量服务器，那么应相应增加
GBASEDBTCONTIME 的值。例如：如果 DBPATH 包含三个条目，尝试每个连接
至少花 30 秒，那么将 GBASEDBTCONTIME 设置为 90。
GBASEDBTCONTIME 优先于 GBASEDBTCONRETRY 设置。可以在超出
GBASEDBTCONTIME 值之后但达到 GBASEDBTCONRETRY 值之前结束重试。
如以下示例所示，可使用 onutil SET 命令修改 GBASEDBTCONTIME 和
GBASEDBTCONRETRY 环境变量：
% onutil
1> SET GBASEDBTCONTIME 120;
Dynamic Configuration completed successfully
2> SET GBASEDBTCONRETRY 10;
Dynamic Configuration completed successfully

[ERROR]:
(GBA-02BR-0065) The gcware not in
'READONLY' mode, please switch this mode by hand!

备份时，程序连同数据库中所有的用户和密码同时备份，因此恢复时，也
是备份时的用户和密码，因此建议客户，备份前记录好集群中默认的root
用户和gbase 用户的密码，以免恢复时忘记。

当集群进行了扩容或者缩容操作时，集群的结构会发生变化。因此，原先
的备份记录将会失效，无法完成恢复操作。正确的做法是在集群扩容、缩
容后，进行新的备份操作，这样就可以通过备份记录进行数据恢复。

当备份时数据是使用密钥进行加密过，
还需要保存好密钥，
在恢复数据时，
解密过程需要用到原始密钥

语法格式
CREATE [DEFINER = { user | CURRENT_USER }] EVENT
[IF NOT EXISTS]
ON SCHEDULE
[ON COMPLETION [NOT] PRESERVE]
[ENABLE | DISABLE]
[GLOBAL | LOCAL]
[COMMENT 'comment']
DO event_body;
schedule:
AT
timestamp
[+
INTERVAL
interval]
...
|
EVERY
interval
[STARTS
timestamp
[+
INTERVAL
interval]
...]
[ENDS timestamp [+ INTERVAL interval] ...]
interval:
quantity { YEAR | QUARTER | MONTH | DAY | HOUR | MINUTE |WEEK |
SECOND | YEAR_MONTH | DAY_HOUR | DAY_MINUTE | DAY_SECOND |
HOUR_MINUTE | HOUR_SECOND | MINUTE_SECOND }
表5- 204 参数说明
字段名称
含义说明
event_name
创建的event 名字（唯一确定的）
ON SCHEDULE
计划任务。
schedule
决定event 的执行时间和频率（注意时间一定要是将来的时
间，过去的时间会出错），有两种形式AT 和EVERY。
[ON
COMPLETION
[NOT] PRESERVE]
可选项，默认是ON COMPLETION NOT PRESERVE，即计
划任务执行完毕后自动
drop
该事件；ON
COMPLETION PRESERVE 则不会drop 掉。
COMMENT
'comment'
可选项，comment 用来描述event；相当于注释，最大长度
64 个字节。
[ENABLE
|
DISABLE]
设定event 的状态，默认ENABLE：表示系统尝试执行这个
事件，DISABLE：关闭该事件，可以用alter 修改。
[GLOBAL | LOCAL]
GLOBAL 表示各节点独占执行，LOCAL 表示各节点独立执

GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
1457
字段名称
含义说明
行
DO event_body
需要执行的sql 语句（可以是复合语句）。CREATE EVENT
在存储过程中使用是合法的。
注意

默认创建事件存储在当前库中，
也可显示指定事件创建在哪个库
中；

通过show events 只能查看当前库中创建的事件；

事件执行完即释放，如立即执行事件，执行完后，事件便自动删
除，多次调用事件或等待执行事件可以查看到；

如果两个事件需要在同一时刻调用，gbase 会确定调用他们的顺
序，如果要指定顺序，需要确保一个事件至少在另一个事件1 秒后
执行；

对于递归调度的事件，结束日期不能在开始日期之前；

select 可以包含在一个事件中，然而他的结果消失了，就好像没
执行过；

创建事件时不支持LOAD 语句；

event 不支持procedure、function、trigger 等对象的创建。
示例
创建测试表：
gbase> DROP TABLE IF EXISTS events_list;
gbase> CREATE TABLE events_list(event_name VARCHAR(20) NOT NULL, ev
ent_started TIMESTAMP NOT NULL);
创建事件1（立即启动事件）：
CREATE EVENT event_now
ON SCHEDULE
AT NOW()
DO insert into events_list values('event_now', now());
查看事件执行结果：
gbase> select * from events_list;
+------------+---------------------+
| event_name | event_started
|
+------------+---------------------+
| event_now | 2017-07-01 04:06:40 |
+------------+---------------------+
创建事件2（每分钟启动事件）：

GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
1458
CREATE EVENT test.event_minute
ON SCHEDULE
EVERY 1 MINUTE
DO insert into events_list values('event_now', now());
查看事件执行结果：
gbase> SELECT * FROM events_list;
+-------------+---------------------+
| event_name | event_started
|
+-------------+---------------------+
| event_now | 2017-07-01 04:26:53 |
| event_now | 2017-07-01 04:27:53 |
| event_now | 2017-07-01 04:28:53 |
+-------------+---------------------+