返回首页

gbase数据、南大通用产品文档:GBase8sSQLCODE 字段

更新日期:2024年09月11日

SQLCODE 字段是数据库服务器的主要返回代码。在每个 SQL 语句之后,将 SQLCODE
设置为如下表所示的一个整数值。当那个值为零时,无误地执行该语句。特别地,当假定
一个语句将数据返回到主变量内时,代码零意味着已返回了该数据且可使用它。任何非零
代码都意味着相反的意思。未将有用的数据返回到了主变量。
表 1. SQLCODE 的值
返回值
解释
值 < 0
指定一个错误代码。
值 = 0
指示成功。
0 < 值 < 100 在 DESCRIBE 语句之后,表示描述 SQL 语句的类型的一个整数值。
100
在未返回行的成功查询之后,指示 NOT FOUND 条件。在 INSERT

GBase 8s SQL 指南:教程
南大通用数据技术股份有限公司
- 208 -
返回值
解释
INTO/SELECT、UPDATE、DELETE 或 SELECT... INTO TEMP 语句未能访
问任何行之后,NOT FOUND 还可发生在符合 ANSI 的数据库中。

数据的结束
当正确地执行语句,但未找到行时,数据库服务器将 SQLCODE 设置为 100。在两种情况
下可发生此情况。
第一种情况涉及使用游标的查询。
(检索多行 描述使用游标的查询。

在这些查询中,
FETCH
语句将来自活动集的每一值检索到内存内。检索最后一行之后,后续的 FETCH 语句不可
返回任何数据。当发生此情况时,数据库服务器将 SQLCODE 设置为 100,指示数据的结
束,找不到行。
第二种情况涉及不使用游标的查询。在此情况下,当没有行满足查询条件时,数据库服务
器将 SQLCODE 设置为 100。
在不符合 ANSI 的数据库中,
仅不返回行的 SELECT 语句
会导致将 SQLCODE 设置为 100。
在符合 ANSI 的数据库中,如果未返回行,则 SELECT、DELETE、UPDATE 和 INSERT
语句都将 SQLCODE 设置为 100。

负代码
在语句期间,
当发生意外错误时,
数据库服务器在 SQLCODE 中返回一个负数值来说明该
问题。在联机错误消息文件中记录这些代码的含义。

inet
inet 类型在一个数据区域内保存主机的IPv4 或IPv6 地址,以及一个可选子网。主机地
址中网络地址的位数表示子网(
“子网掩码”

。如果子网掩码是32 并且地址是IPv4,则
这个值不表示任何子网,只表示一台主机。在IPv6 里,地址长度是128 位,因此128 位表
示唯一的主机地址。
该类型的输入格式是address/y,address 表示IPv4 或者IPv6 地址,y 是子网掩码的二进
制位数。
如果省略/y,
则子网掩码对IPv4 是32,
对IPv6 是128,
所以该值表示只有一台

机。如果该值表示只有一台主机,/y 将不会显示。
inet 和cidr 类型之间的基本区别是inet 接受子网掩码,而cidr 不接受。

Invalid qualifier length
Interval 对象的长度值不正确。
请参阅 INTERVAL 数据类型 以获取正确的值。

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