gbase数据、南大通用产品文档：GBase8sSQL 管理 API 概述

使用 SQL 管理 API 来通过 SQL 语句远程地管理 GBase 8s 。
SQL 管理 API 由两个函数组成：admin() 和 task()。这些函数执行相同的操作，但返回
不同格式的结果。这些函数带有一个或多个定义操作的参数。许多操作是您也可通过命令
行实用程序完成的操作。使用 SQL 管理 API 函数的好处是，您可从其他数据库服务器远
程地运行它们；反之，您必须直接地连接到运行命令行实用程序命令的那台数据库服务器
上。
您可在 SQL 语句内调用 admin() 和 task() 函数，该语句可包括表达式，或您可使用
EXECUTE FUNCTION 语句来调用它们。在一个事务内运行 admin() 或 task() 函数，该事
务不包括任何其他语句。
在 sysadmin 数据库中定义 SQL 管理 API 函数。您必须连接到 sysadmin 数据库，或直
接地或远程地来运行这些函数。
仅下列用户可运行 SQL 管理 API 函数：
 用户 gbasedbt
 root 用户，如果将 sysadmin 数据库上的 Connect 权限授予该用户
 DBSA 组成员，如果将 sysadmin 数据库上的 Connect 权限授予该角色
 通过带有 grant admin 参数的 admin() 和 task() 函数授予 SQL 管理 API 命令
权限的用户。
为了复制文件中存在的存储空间、chunk 和日志，您可生成 SQL 管理 API 命令。为此，
请运行带有 -c 选项的 dbschema 实用程序。

GBase JDBC 是一种兼容JDBC 规范3.0、4.0（类型4）的驱动，这意味着
它是符合JDBC 3.0、4.0 版本规范的一种纯Java 程序，并能使用GBase 协议直
接和GBase 服务器通信。
GBase JDBC 为使用JAVA 程序语言的客户端应用提供
访问GBase 8s 接口。

概述

本节描述可以用来操纵时间值的函数。
参考日期和时间类型来获取每种日期和
时间类型在有效格式下可以表达的值的范围；

返回当前日期或者时间的函数都等于在查询开始执行时的值，仅执行一次。这
意味在一个单查询中多次引用像NOW()这样的函数总会得到一样的结果。
这个
原则也适用于CURDATE()，CURTIME()，UTC_DATE()，UTC_TIME()，
UTC_TIMESTAMP()和它们的同义词；

CURRENT_TIMESTAMP() ，CURRENT_TIME() ，CURRENT_DATE() 和
FROM_UNIXTIME()返回当前时区，这和time_zone 系统变量是一样的。还有
UNIX_TIMESTAMP()假设它的参数是当前时区的datetime 值。
示例
示例1
返回当前日期和时间。

GBase UP 产品手册 5 数据库管理指南
文档版本04（2021-04-21） 南大通用数据技术股份有限公司 844
gbase> SELECT NOW() FROM t;
+---------------------+
| NOW() |
+---------------------+
| 2014-01-03 14:53:55 |
+---------------------+
1 row in set
示例2
返回当前日期。
gbase> SELECT CURDATE() FROM t;
+------------+
| CURDATE() |
+------------+
| 2013-10-12 |
+------------+
1 row in set
示例3
返回当前时间。
gbase> SELECT CURTIME() FROM t;
+-----------+
| CURTIME() |
+-----------+
| 10:37:04 |
+-----------+
1 row in set
示例4
返回当前UTC 日期。
gbase> SELECT UTC_DATE() FROM t;
+------------+
| UTC_DATE() |
+------------+
| 2013-10-12 |
+------------+
1 row in set
示例5
返回当前UTC 时间。
gbase> SELECT UTC_TIME() FROM t;

GBase UP 产品手册 5 数据库管理指南
文档版本04（2021-04-21） 南大通用数据技术股份有限公司 845
+------------+
| UTC_TIME() |
+------------+
| 02:37:32 |
+------------+
1 row in set
示例6
返回当前UTC 时间戳（日期+时间）。
gbase> SELECT UTC_TIMESTAMP() FROM t;
+---------------------+
| UTC_TIMESTAMP() |
+---------------------+
| 2013-10-12 02:37:59 |
+---------------------+
1 row in set
示例7
返回当前时间戳（日期+时间）。
gbase> SELECT CURRENT_TIMESTAMP() FROM t;
+---------------------+
| CURRENT_TIMESTAMP() |
+---------------------+
| 2013-10-12 10:38:14 |
+---------------------+
1 row in set
示例8
返回当前时间。
gbase> SELECT CURRENT_TIME() FROM t;
+----------------+
| CURRENT_TIME() |
+----------------+
| 10:38:26 |
+----------------+
1 row in set
示例9
返回当前日期。
gbase> SELECT CURRENT_DATE() FROM t;
+----------------+

GBase UP 产品手册 5 数据库管理指南
文档版本04（2021-04-21） 南大通用数据技术股份有限公司 846
| CURRENT_DATE() |
+----------------+
| 2013-10-12 |
+----------------+
1 row in set