gbase数据、南大通用产品文档：GBase8sSQLERRD 数组

GBase 8s SQL 指南：教程
南大通用数据技术股份有限公司 - 204 -

在 SQLCODE 中可报告的某些错误代码反映一般的问题。数据库服务器可在 SQLERRD
的第二个字段中设置更详细的代码，显示数据库服务器 I/O 例程或操作系统遇到的错误。
将 SQLERRD 数组中的整数设置为跟在不同语句之后的不同值。在 GBase 8s ESQL/C 中，
仅使用数组的第一个和第四个元素。下表展示如何使用这些字段。
表 1. SQLERRD 的字段
字段
解释
第一个
对于 SELECT、UPDATE、INSERT 或 DELETE 语句，在成功的 PREPARE 语句之
后，或在打开 Select 游标之后，此字段包含估计的受影响的行数。
第二个
当 SQLCODE 包含一个错误代码时，此字段包含零或附加的错误代码，称
为 ISAM 错误代码，
说明主要错误的原因。
在对单个行的成功的插入操作之
后，
此字段包含任何 SERIAL、
BIGSERIAL 或 SERIAL8 值为那行生成的值。
（然
而，当通过表上的触发器，或通过视图上的 INSTEAD
OF 触发器，将一序列列
作为触发器的活动直接插入时，不更新此字段。）
第三个
在成功的多行插入、更新或删除操作之后，此字段包含处理了的行数。在以错
误结束的多行插入、
更新或删除操作之后，
此字段包含在检测到该错误之前成
功地处理了的行数。
第四个
在对于 SELECT、UPDATE、INSERT 或 DELETE 语句的成功的 PREPARE 语句之
后，
或在已打开了选择游标之后，
此字段包含磁盘访问的与处理的全部行的估
计加权总和。
第五个
在 PREPARE、EXECUTE
IMMEDIATE、DECLARE 或静态的 SQL 语句中的语法错误
之后，此字段包含检测到该错误的位置的语句文本的偏移量。
第六个
在对选择了的行的成功的访存之后，或成功的插入、更新或删除操作之后，此
字段包含处理了的最后一行的 rowid（物理地址）。此 rowid 值是否对应于
数据库服务器返回给用户的行，
依赖于数据库服务器处理查询的方式，
特别是
对于 SELECT 语句。
第七个
保留。
这些附加的详细信息可是有用的。例如，您可使用第三个字段中的值来报告删除了或更新
了多少行。当您的程序准备一个用户输入的 SQL 语句并发现错误时，第五个字段中的值
使得您能够向用户显示错误的精确点。（当您在错误之后请求修改语句时，DB-Access 使
用此特性来定位游标。）


GBase 8s SQL 指南：教程
南大通用数据技术股份有限公司 - 205 -

GBase 8s JDBC Driver 支持 JNDI（Java™ 命名和目录接口）。此支持使得 JDBC 程序能
够访问 GBase 8s sqlhosts 文件。sqlhosts 文件允许客户机应用程序找到并连接至网络上任
何位置的 GBase 8s 数据库服务器。要获取关于此文件的更多信息，请参阅《GBase 8s 管
理员指南》。
您可从本地文件或从 LDAP 服务器来访问 sqlhosts 数据。系统管理员必须使用 GBase 8s
实用程序，来将 sqlhosts 数据加载至 LDAP 服务器内。
您的 CLASSPATH 变量必须引用 JNDI JAR（Java 归档）文件和 LDAP SPI（服务提供商
接口）JAR 文件。您必须使用 LDAP Version 3.0 或更新的版本，其支持对象类
extensibleObject。
您可使用 sqlhosts 文件 group 选项，
来为 GBASEDBTSERVER 的值指定数据库服务器组
的名称。group 选项对“高可用性数据复制”（HDR）非常有用；顺序地在 HDR 对中罗列
主和辅助数据库服务器。要获取关于如何设置和使用 sqlhosts 文件中的组的更多信息，请
参阅《GBase 8s 管理员指南》。要获取关于 HDR 的更多信息，请参阅 连接至高可用性
集群的服务器。
未签名的 applet 不可访问 sqlhosts 文件或 LDAP 服务器。要获取更多信息，请参阅 在
applet 中使用驱动程序。

功能说明
修改预租磁盘空间大小。
语法格式
ALTER TABLE [vc_name.][database_name.] table_name AUTOEXTEND ON
NEXT NUM[M/G];
表5- 74 参数说明
参数名称
说
明
vc_name
vc 名，可选项。

GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
1002
参数名称
说
明
database_name
数据库名，可选项。
table_name
表名。
NUM[M/G]
指定预租空间大小，NUM 以M(megabytes)，G(gigabytes)为
单位，有效范围为1M ≤NUM ＜2G。
示例
示例1：修改表的指定预租磁盘空间大小。
gbase> CREATE TABLE t(nameid int, name varchar(50)) AUTOEXTEND
ON NEXT 1M;
Query OK, 0 rows affected
gbase> SHOW CREATE TABLE t\G
*************************** 1. row ***************************
Table: t
Create Table: CREATE TABLE "t" (
"nameid" int(11) DEFAULT NULL,
"name" varchar(50) DEFAULT NULL
)
ENGINE=EXPRESS
DEFAULT
CHARSET=utf8
TABLESPACE='sys_tablespace' AUTOEXTEND ON NEXT 1M
1 row in set (Elapsed: 00:00:00.00)
gbase> ALTER TABLE t AUTOEXTEND ON NEXT 2M;
Query OK, 0 rows affected
Records: 0
Duplicates: 0
Warnings: 0
gbase> SHOW CREATE TABLE t\G
*************************** 1. row ***************************
Table: t
Create Table: CREATE TABLE "t" (
"nameid" int(11) DEFAULT NULL,
"name" varchar(50) DEFAULT NULL
)
ENGINE=EXPRESS
DEFAULT
CHARSET=utf8
TABLESPACE='sys_tablespace' AUTOEXTEND ON NEXT 2M
1 row in set (Elapsed: 00:00:00.00)