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

使用 DBDATE 环境变量可以指定 DATE 值的最终用户格式。

GBase 8s SQL 指南：参考
南大通用数据技术股份有限公司 - 153 -
在使用 C shell 的 UNIX™ 系统上，使用以下语法设置 DBDATE。

下列格式化符号在 DBDATE 设置中有效：
- . /
是在日期格式中可作为分隔符存在的字符。
0
指示时间单位之间不显示任何分隔符。
D 和 M
是表示日和月的字符。
Y2 和 Y4
是表示年份和年份精度的字符。
一些东亚语言环境支持基于纪元的日期的附加语法。有关基于纪元的格式的详细信
息，请参阅《GBase 8s GLS 用户指南》。
DBDATE 可指定显示格式的下列属性：

日期中时间单位的顺序（月、日和年）

年份是以两位数字 (Y2) 还是四位数字 (Y4) 的形式显示

月、日和年时间单位之间的分隔符
对于“美国英语”语言环境，DBDATE 的缺省值为 MDY4/，其中 M 表示月，D 表
示日，Y4 表示四位的年份，而斜杠 ( / ) 表示时间单位分隔符（例如，01/08/2011）。
可充当分隔符的其他有效字符包括连字符 ( - )、句点 ( . ) 或零 (0)。要指示没有分隔符，
请使用零。如果尝试指定连字符、句点或零以外的字符作为分隔符，或者未在 DBDATE
规范中加入任何分隔符，那么缺省情况下会使用斜杠 ( / )。
如果未在客户机上设置 DBDATE，那么数据库服务器上的任何 DBDATE 设置会覆
盖客户机上的 MDY4/ 缺省值。如果在客户机上设置了 DBDATE，那么客户机会使用该
值（而不是数据库服务器上的设置）。
下表显示了有效 DBDATE 设置的一些示例以及它们对应于日期 2011 年 1 月 8 日的
显示：

DBDATE 设置
2011 年 1 月 8
日的表示法：
DBDATE 设置 2011 年 1 月 8 日
的表示法：

GBase 8s SQL 指南：参考
南大通用数据技术股份有限公司 - 154 -
MDY4/
01/08/2011
Y2DM.

GL_DATE 环境变量指定 DATE 列的值的最终用户格式。 GL_DATE 格式字符串可以包含
以下字符：
•
一个或多个空格字符
•
普通字符（不是百分号或空格字符）
•
格式化指令。由百分号（% ）和一个或两个指定所需替换的转换字符组成
在下表中定义日期格式化伪指令。
指令
替换为
%a
在语言环境中定义为星期几名称的缩写
%A
语言环境中定义的星期几的完整名称
%b
语言环境中定义的月的缩写

GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 217 -

指令
替换为
%B
语言环境中定义的完整的月的名称
%C
作为十进制（00 到 99）的世纪数（年除以 100 并截断为整数）
%d
一个月份中的日期数（01 到 31）
单个数字前面要加零（0）
%D
与 %m/%d/%y 格式相同
e
一个月份中的日期数（1 到 31）
单个数字前面用空格补齐
%h
与 %b 格式指令相同
%iy 两位数表示的年份（00 到 99）
这是针对于 %y 的特定于 GBase 8s 的格式化指令
%iY 四位数表示的年份（0000 到 9999）
这是针对于 %Y 的特定于 GBase 8s 的格式化指令
%m
月份（01 到 12）
%n
newline 字符
%t
TAB 字符
%w
星期数（0 - 6）
0 代表本地语言中的星期日。
%x
表示语言环境定义的特殊日期
%y
两位数表示的年份（00 - 99）
%Y
四位数表示的年份（ 0000 - 9999）
%%
% （在格式化字符串中允许 % ）

GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 218 -

重要： 不支持字段规范的 GL_DATE 可选日期格式限定符。
例如，通过使用 %4m 显示月份作为十进制数值，不支持最大字段宽度为 4 。
不支持 GL_DATE 转换修饰符 O，它指示使用替代数字用于替换日期格式 。
任何两个格式化指令之间必须出现空格或其它非字母数字字符。如果 GL_DATE 变量格式
与任何有效的格式指令都不对应，则当数据库服务器尝试格式化日期时会发生错误。
例如，
对于美国英语语言环境，
您可以使用以下格式将 09/29/1998 格式化为内部 DATE 值：

* Sep 29, 1998 this day is:(Tuesday), a fine day *
要创建此格式， 将 GL_DATE 环境变量设置为如下值：
* %b %d, %Y this day is:(%A), a fine day *
要将此日期值插入到具有日期列的数据库表中，您可以执行以下类型的插入：
•
非本地化 SQL，其中 SQL 语句未更改地发送到数据库服务器
输入完全按照 GL_DATE 设置预期的日期
•
本地化 SQL，将转义语法转换为特定于 GBase 8s 格式
以 JDBC 转义格式 yyyy-mm-dd 输入日期值；该值会自动转换为 GL_DATE 格式。

以下示例显示这两种类型的插入：
要从数据库中检索格式化的 GL_DATE DATE 值，请调用 ResultSet 类的 getString() 方法。

将表示日期的字符串输入数据库表的 char 、varchar 或 lvarchar 类型列，您还可以建立表
示日期字符串值的日期对象。此日期字符串值必须是GL_DATE 格式。
以下示例显示查询 DATE 值的这两种方式：
PreparedStatement pstmt = conn.prepareStatement("Select * from
tablename "
+ "where col2 like ?;");
pstmt.setString(1, "%Tue%");
ResultSet r = pstmt.executeQuery();
while(r.next())
{
String s = r.getString(1);
java.sql.Date d = r.getDate(2);
System.out.println("Select: column col1 (GL_DATE format) = <"
+ s + ">");
System.out.println("Select: column col2 (JDBC Escape format) = <"
+ d + ">");
}

GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 219 -

r.close();
pstmt.close();

GBase 8a MPP Cluster 提供专用的备份恢复工具(gcrcman)，用户使用它可以方便地
对整个集群中的数据进行备份和恢复。集群的备份、恢复工具随集群的安装自动安
装，该工具被安装在安装目录$GCLUSTER_BASE/server/bin 下。
一次全量备份开启一个新的周期。一次增量备份则续写最后一个备份周期，使其增
加一个备份点。
本章主要介绍如何使用备份恢复工具进行数据的备份与恢复，具体包括：

集群级全量备份：
将当前集群的数据全量备份至指定的备份目录中(确保已经创
建好目录)。

集群级增量备份：在指定备份目录中的全量或增量备份数据的基础上，将当前
集群的数据增量备份至该备份目录。

库级全量备份：备份某个库下所有的表和普通视图。

库级增量备份：增量备份某个库下所有的表。

表级全量备份：将某一个表的数据全量备份至备份目录中。

表级增量备份：将某一个表的数据增量备份至备份目录中。

集群级恢复：将备份目录中的指定备份数据，恢复至当前的集群中。

库级恢复：恢复一个库下所有的表和普通视图。

表级恢复：将备份目录中的单个表的数据，恢复至当前数据库中。

查看备份数据：数据备份后，查看已经备份了哪些数据。

删除备份数据：删除用户指定的备份数据。

删除垃圾数据：由于异常或者用户中断，残留的垃圾备份数据，用户可以通过
工具删除。

GBase 8a MPP Cluster 产品手册
4 管理员指南
文档版本953（2022-09-15）
南大通用数据技术股份有限公司
376
注意

执行gcrcman.py 命令时，必须是安装数据库时指定的dbauser。

需要在coordinator 节点上执行备份恢复操作，
执行备份恢复操作时集群各节
点网络连接正常。

执行gcrcman.py 命令，需要确定操作系统已安装pexpect 包。

在执行备份恢复的过程中，
集群的各个节点上，
必须都存在gcrcman.py 中参
数path 指定的路径，
集群安装用户dbauser 用户对该路径具备读写操作权限，
且在执行过程中该目录一直存在。

不要将$GCLUSTER_BASE、$GBASE_BASE、$GCWARE_BASE 这三个目
录及其子目录设置为path 的路径。

在执行备份恢复的过程中，操作系统和数据库用户的密码不能更改。

执行备份恢复操作时，恢复时需要和备份时集群的拓扑结构相同，包括管理
节点、数据节点、数据的distribution 信息等。

无论是多个会话连接，
还是一个会话连接，
每次只能运行一个gcrcman.py 程
序。

暂不支持单个VC 的数据备份恢复。
表4- 50 GCluster 8a MPP Cluster 支持的备份对象说明如下（√：支持；×：不支持）
数据库对象
集群级
库级
表级
表元数据
√
√
√
表数据
√
√
√
表索引
√
√
√
存储过程
√
×
×
视图
√
√
×
UDF
×
×
×
镜像表
√
×
×
表空间
√
√
×