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 实用程序。

该功能将所选的库下的所有express 引擎表数据进行导出，导出为非压缩
数据文件。
在“对象资源管理器”中，展开“用户数据库”， 右键单击用户数据库
下的某个数据库，单击“导出数据库为非压缩文件”并弹出操作对话框，如下
图所示：

图 7-124 导出数据库为非压缩文件
选择“ 导出数据库为非压缩文件”菜单项后，会弹出“导出数据库为非
压缩文件”对话框，如下图所示：

GBase 8a MPP Cluster 管理工具手册

- 134 -

南大通用数据技术股份有限公司

图 7-125 导出数据库为压缩文件
在“ 导出数据库为非压缩文件”对话框中，点击“选择路径”按钮，会弹
出“导出路径选择”对话框，选择导出文件存放路径。点击“确定”

图 7-126 导出路径选择
在“ 导出数据库为非压缩文件”对话框中，
显示已选择的本地文件存放路径。
确保选择的路径下没有要导出的“数据库名”文件夹，选择好后，点击“确
定”按钮，开始导出数据库。点击“取消”按钮关闭对话框，取消本次导出操
作。



GBase 8a MPP Cluster 管理工具手册
南大通用数据技术股份有限公司

- 135 -

图 7-127 选择导出数据库为压缩文件
点击“确定”按钮，开始导出数据库

图 7-128 导出进度
导出成功后，提示信息：

图 7-129 导出提示
导出数据成功，导出的数据会存放在所选择的本地文件存放路径下，以所导出

GBase 8a MPP Cluster 管理工具手册

- 136 -

南大通用数据技术股份有限公司
数据库命名的文件夹，下面存放建表语句，以及库下所有表命名的.gdp 数据文
件。

图 7-130 导出结果

使用 RENAME TRUSTED CONTEXT 语句来更改可信的上下文对象的名称。
此语句是对 SQL 的 ANSI/ISO 标准的扩展。您必须持有数据库安全管理员
（DBSECADM）角色来重命名可信的上下文。
语法

元素
描述
限制
语法
old_name new_name 替代的
可信的上下文标识
符
必须为数据库服务器的现有的可信
的上下文对象
标识符
new_name 您在此为可信的上
下文声明的新名称
必须为一部分名称，无限定符。它
不可以字符 "SYS" 开头，且必须
不标识在数据库服务器上业已存在
的可信的上下文。
标识符
用法

GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 802
new_name 和 old_name 不可包括限定符，诸如 owner、database 或 dbserver。
成功地执行 RENAME TRUSTED CONTEXT 语句之后，所有对 old_name 的引用都会
被 GBase 8s 数据库服务器实例的 sysuser 数据库中的这些表中的 new_name 所
替代：

systrustedcontext

systcxattributes

systcxusers.
此外，那些尝试通过引用该 old_name 来建立到该数据库的连接的应用程序将会
失败，除非已经声明该 old_name 作为新的可信的上下文对象的标识符。
如果在此上下文的可信的连接为活动的时候，您重命名该可信的上下文，则那些
连接保持为可信的，直到它们终止为止，或直到下一重用尝试为止。然而，如果
尝试着切换在这些可信的连接上的用户，则返回错误。
下例是一个完整的 RENAME TRUSTED CONTEXT 语句，以 cntx2 作为 cntx1 可信
的上下文的新名称替代安全对象标识符 cntx1：
RENAME TRUSTED CONTEXT cntx1 TO cntx2;
在下列任一情况下，此示例失败：

如果 cntx1 不是当前数据库服务器实例的可信的上下文对象的名称，

或如果 cntx2 已是同一数据库服务器的现有的可信的上下文对象的名称。