GBASEDBTCONTIME 会话环境选项

在当前会话中每一 CONNECT 语句尝试建立到数据库服务器的连接时,使用 SET ENVIRONMENT 语句的 GBASEDBTCONTIME 会话环境选项来指定秒数的限定。

GBASEDBTCONTIME 会话环境选项有此语法:

GBASEDBTCONTIME 环境选项
元素 描述 限制 语法
integer 在 CONNECT 语句尝试建立到数据库服务器的连接时,无符号整数值 > 0 设置最大秒数 必须定界在单引号(')或双引号(")之间。'0' 设置是 GBASEDBTCONTIME 配置参数的缺省设置。 文字的数值用引号括起的字符串

用法

GBASEDBTCONTIME 会话环境设置可覆盖客户端 GBASEDBTCONTIME 环境变量的设置。通过设置 GBASEDBTCONTIME 和 GBASEDBTCONRETRY 会话环境变量来配置在当前的会话中您的服务器到服务器连接能力,您可最小化连接错误。要设置 GBASEDBTCONTIME 会话环境选项的优化值,请考虑节点之间的总距离、硬件速度、流量以及网络的并发水平。

为了设置 CONNECT 语句可用于尝试连接到数据库服务器实例的时间量的上限,这是按升序(从最低至最高)排列的该方法的优先权:

如果同一 CONNECT 语句的先前尝试未能建立连接,则 GBASEDBTCONTIME 会话环境选项的值除以 GBASEDBTCONRETRY 会话环境选项的值决定连续的连接尝试之间的最大秒数。

例如,下列语句设置 GBASEDBTCONTIME 为 60 秒,并设置 GBASEDBTCONRETRY 为重试一次:
SET ENVIRONMENT GBASEDBTCONTIME '60';
          SET ENVIRONMENT GBASEDBTCONRETRY '1';
在此示例中,CONNECT 语句尝试建立连接 60 秒。在 0 秒初次尝试连接到数据库服务器。如果 GBASEDBTCONTIME 会话环境选项设置为缺省值 '0',则在返回错误之前,在 60 秒进行附加的连接尝试,如果必要的话。
类似地,您可为多次重新尝试配置这些会话环境选项。以相同的 GBASEDBTCONTIME 设置,下列语句指定另外重新尝试两次:
SET ENVIRONMENT GBASEDBTCONRETRY '3'; 

如果 GBASEDBTCONRETRY 设置为 '3',则在返回错误之前,最多进行三次附加的对数据库服务器的连接尝试(在 204060 秒,如果必要的话)。

此 20 秒的间隔是 GBASEDBTCONTIME 值除以 GBASEDBTCONRETRY 值的结果。

如果您设置 GBASEDBTCONTIME 会话环境选项为 '0'
SET ENVIRONMENT GBASEDBTCONTIME '0';
        
数据库服务器自动地使用 GBASEDBTCONTIME 配置参数的设置。如果未设置 GBASEDBTCONTIME 参数,则在该会话中后续的 CONNECT 语句期间使用它的缺省值 60 秒。
如果 CONNECT 语句必须搜索 DBPATH,则 GBASEDBTCONRETRY 会话环境选项指定可对 DBPATH 中每一数据库服务器条目进行的附加连接尝试的次数。
  • 即使超过 GBASEDBTCONTIME 值,也至少访问 DBPATH 设置中所有恰当的服务器一次。因此,CONNECT 语句可能花费比 GBASEDBTCONTIME 时限更长的时间来返回错误,指明连接失败,或找不到数据库。
  • GBASEDBTCONTIME 值在 DBPATH 中指定的数据库服务器条目的数目之中分配。因此,如果 DBPATH 包含大量服务器,则相应地增加 GBASEDBTCONTIME 值。例如,如果 DBPATH 包含三个条目,要为每一连接尝试花费至少 30 秒,则请设置 GBASEDBTCONTIME 为 '90'
    SET ENVIRONMENT GBASEDBTCONTIME '90';