gbase数据、南大通用产品文档：GBase8sreset sysadmin 参数：

移动 sysadmin 数据
库（SQL 管理 API）
随同 admin() 或 task() 函数，使用 reset sysadmin 参数来将 sysadmin 数据库移到指定的
dbspace。移动 sysadmin 数据库将该数据库重置回到首次创建它时的原始状态；所有数据、

command history 和结果表都会丢失。仅内建任务、传感器和阈值保留在 sysadmin 表中。
语法

元素
描述
关键考虑
dbspace
dbspace 的名称。


GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 783 -

用法
这个函数没有等同的实用程序命令。
如果您未指定 dbspace 作为最后的参数，则这个命令删除 sysadmin 数据库，然后在
rootdbs 中重新创建它。删除所有 ph_* 表和 command_history 行，并删除所有结果表。
示例
下列示例删除现有的 sysadmin 数据库并在名为 dbsp1 的 dbspace 内创建新的 sysadmin
数据库：
EXECUTE FUNCTION task("reset sysadmin","dbs1");
下一个示例删除 sysadmin 数据库，然后在 rootdbs 中重新创建它。
EXECUTE FUNCTION admin("reset sysadmin");
除了内建任务、传感器和阈值之外，从 ph_ 表中删除所有数据行，通过这个函数调用从
sysadmin 删除所有结果表。该函数执行完成之后，command_history 表为空。

当安装 GBase 8s ESQL/C 时，安装脚本将头文件存储在 $GBASEDBTDIR/incl/esql
目录
（在 UNIX™ 操作系统上）
和 %GBASEDBTDIR%\incl\esql 目录中
（在 Windows™ 环
境中）。
下表显示了 GBase 8s ESQL/C 产品提供的头文件。
表 1. ESQL/C 头文件
头文件
内容
其它信息
datetime.h
GBase 8s ESQL/C datetime 和 interval 结构的定
义，它们是 DATETIME 和 INTERVAL 列的主变量
时间数据类型
decimal.h
GBase 8s ESQL/C decimal 数据类型的定义，是
DECIMAL 和 MONEY 数据类型的主变量
Numeric 数据
类型
gls.h
用于 GLS 功能的函数原型和数据结构
GBase 8s
GLS 用户指
南
ifxtypes.h
精确映射 GBase 8s 数据类型 int1 、int2 、int4 、
mint 、mlong 、MSHORT 和 MCHAR ，用于
32 位和 64 位平台
整数主机变量
类型
locator.h
GBase 8s ESQL/C 定位器结构（ifx_loc_t 或 loc_t）
的定义，它是字节和文本列的主变量
简单大对象

GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 27 -
sqlca.h
ESQL/C 用来存储错误状态代码的结构的定义
当 esql 预处理器预处理程序时，自动包含此文件。
异常处理
sqlda.h
值指针和结构定义以及动态定义变量的描述
确定 SQL 语
句
sqlhdr.h
该文件包含 sqlda.h 头文件、其它头文件以及函数原
型。
预处理器预处理程序时自动包含该文件。
在程序中包含
头文件
sqliapi.h
内部库 API 函数原型
仅供内部 GBase 8s ESQL/C 使用。
无
sqlstype.h
SQL 语句常量的定义
DESCRIBE 语句使用这些常量描述动态准备的 SQL
语句
确定 SQL 语
句
sqltypes.h
定义与 ESQL/C 和 SQL 数据类型相对应的常量
当程序包含 DESCRIBE 语句时，
ESQL/C 使用这些常
量。
数据类型常量
sqlxtype.h
当在 X/Open 模式时定义与 GBase 8s ESQL/C 和
SQL 数据类型相对应的常量
当程序包含 DESCRIBE 语句时，
ESQL/C 使用这些常
量。
X/Open 数据
类型常量
value.h
GBase 8s ESQL/C 使用的值结构
仅供内部 GBase 8s ESQL/C 使用。
无
varchar.h
可以使用 VARCHAR 数据类型的宏
字符和字符串
数据类型
下图显示了特定于 GBase 8s 的 GBase 8s ESQL/C 头文件。
表 2. GBase 8s 的 ESQL/C 头文件
头文件
内容
其它信息
collct.h
GBase 8s ESQL/C 中复杂类型的数据结构的定义
复杂数据类型

GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 28 -
头文件
内容
其它信息
ifxgls.h
用于 GLS 应用程序编程接口的函数原型
仅供内部 GBase 8s ESQL/C 使用。
无
int8.h
存储 INT8 数据类型结构的定义
int8 数据类型
下表显示了特定于 Windows 环境的 GBase 8s ESQL/C 头文件。
表 3. Windows 环境中的 ESQL/C 头文件
头文件
内容
其它信息
sqlproto.h
所有 ESQL/C 库函数的函数原型，用于不完全符合
ANSI C 标准的源
声明函数原型
infxcexp.c
包含用于导出 ESQL 客户端接口 DLL 使用的所有 C
运行时例程的地址的 C 代码
相同运行例程的版本独
立性
login.h
InetLogin 和 HostInfoStruct 结构的定义，为应用
程序定制配置参数
因为此文件不包含 ESQL 语句，
所以不需要使用 ESQL
include 伪指令包含它。而是用 C #include 预处理器
伪指令。
InetLogin 结构的字段
声明函数原型
GBase 8s ESQL/C 提供 sqlproto.h 头文件为所有 GBase 8s ESQL/C 库函数声明函数
原型。您使用 ANSI C 编译器的 GBase 8s ESQL/C 源文件需要这些函数原。缺省情况下，
esql 命令处理器不包含函数原型声明。
使处理器包含符合 GBase 8s ESQL/C 函数的 ANSI
兼容的函数原型可以防止 ANSI C 编译器生成警告。
限制：
尽管可以使用 ANSI C 编译器，
GBase 8s ESQL/C 预处理器并不全支持 ANSI
C，因此您可能不能处理遵循 ANSI C 标准的全部程序。
因为 sqlproto.h 文件不包含任何 GBase 8s ESQL/C 语句，使用可用使用以下方法包
含此文件：
使用 GBase 8s ESQL/C include 预处理器伪指令：
EXEC SQL include sqlproto;
使用 C #include 预处理器伪指令：
#include "sqlproto.h";
在程序中包含头文件
GBase 8s ESQL/C 预处理器在程序中自动包含以下 GBase 8s ESQL/C 头文件：

GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 29 -
sqlhdr.h 文件为您的 GBase 8s ESQL/C 程序提供和游标相关的结构。
该头文件自动包含 sqlda.h 和 ifxtypes.h 头文件。
sqlca.h 文件，允许您的查询检查带有 SQLSTATE 或 SQLCODE 变量的 GBase 8s
ESQL/C 语句的成功或失败。
限制： 尽管现在使用 ANSI C 编译器，GBase 8s ESQL/C 预处理器也不完全支持
ANSI C，因此可能不能处理所有遵循 ANSI C 标准的程序。
要在您的 GBase 8s ESQL/C 程序中包含任何其它头文件，必须使用 include 预处理
器伪指令。但是，如果您的程序引用头文件定义的结构或定义，则必须包含 GBase 8s
ESQL/C 头文件。例如：如果您的程序访问 datetime 数据，那么必须包含 datetime.h 头文
件，如下所示：
EXEC SQL include datetime.h;
确保使用分号结束代码行。一些其它示例如下：
EXEC SQL include varchar.h;
EXEC SQL include sqlda;
$include sqlstype;
提示： 不需要对 GBase 8s ESQL/C 头文件输入 .h 文件扩展名；esql 预处理器假
定 .h 扩展。

问题现象
UP 从hive 表向8a 表insert 时报错”(GBA-01-600) Gbase internal error: I/O
operation on HDP”
Gnode 层express 日志中有信息：Caused by: HdfsNetworkConnectException:
Failed to resolve address "bigdata-dn-30.cars.com:1019" Name or service
not known
解决方法：
在集群节点/etc/hosts 里面增加bigdata-dn-30.cars.com 主机名、ip 映射信息

GBase 8a MPP Cluster 最佳实践
5 FAQ
文档版本（2022-02-11）
南大通用数据技术股份有限公司
102