更新日期：2024年09月11日
要从一致性检查获取最大好处并确保数据库空间备份的完整性，必须定期执行以下操作：
验证所有数据和数据库服务器开销信息是一致的。
检查消息日志是否在您验证一致性时有断言失败。
在您验证一致性后创建 0 级数据库空间备份。
以下主题描述了其中每个操作。
验证一致性
由于此检查需要一定时间并且此检查可能导致争用，因此请将此检查调度为在活动最少的
时候执行。必须在创建 0 级备份之前执行此检查。
运行下表中显示的命令以作为一致性检查的一部分。
表 1. 检查数据一致性
验证类型
命令
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 340 -
系统目录表
oncheck -cc
数据
oncheck -cD dbname
扩展数据块数
oncheck -ce
索引
oncheck -cI dbname
保留页
oncheck -cr
逻辑日志和保留页
oncheck -cR
元数据和智能大对象
oncheck -cs
您可以在数据库服务器处于联机方式时运行这些命令中的每个命令。有关每个命令如何在
检查对象时锁定它们以及哪些用户可以执行验证的信息，请参阅 《GBase 8s 管理员参
考》 中的 oncheck。
在大多数情况下，如果这些验证过程中的一个或多个过程检测到错误，那么解决方案是从
数据库空间备份复原数据库。但是，错误的来源也可能是硬件或操作系统。
验证系统目录表
要验证系统目录表，使用 oncheck -cc 命令。
每个数据库包含它本身的系统目录，该目录包含有关数据库表、列、索引、视图、约束、
存储过程和特权的信息。
如果当验证完成时显示警告，那么该警告的唯一用途是提醒您找不到特定类型的记录。这
些警告并非指示您的数据、系统目录或甚至数据库设计有任何问题。该警告仅指示不存在
任何表的同义词；即，系统目录在表 syssyntable 中不包含记录。 例如，如果您为没有为任
何表定义同义词的数据库验证系统目录表，那么可能显示以下警告：
WARNING: No syssyntable records found.
但是，如果您在验证系统目录表时接收到错误消息，那么情况就完全不同了。请立即
与 GBase 8s 技术支持联系。
验证数据页
要确认数据页，请使用 oncheck -cD 命令。
如果数据页验证检测到错误，请尝试从指定表中卸载数据，删除该表，重新创建该表，并
重新装入该数据。有关装入和卸载数据的信息，请参阅《GBase 8s 迁移指南》。如果该过
程不成功，请从存储空间备份执行数据复原。
验证扩展数据块
要确认每个数据库中的扩展数据块，请使用 oncheck -ce 命令。
扩展数据块一定不能重叠。如果该命令检测到错误，请从存储空间备份执行数据复原。
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 341 -
验证索引
如果索引已损坏，那么数据库服务器在查询中将无法使用索引。
可以通过使用 oncheck -cI 命令来验证数据库中每个表上的索引。
此外，调度程序任务 bad_index_alert 将查找已被服务器标记为已损坏的索引。此任务在每
晚运行。
对于此任务找到的每个已损坏索引，
都会在 sysadmin:ph_alert 表中建立一个条目。
如果索引已损坏，请将其删除，然后重新创建。
验证逻辑日志
要确认逻辑日志和保留页，请使用 oncheck -cR 命令。
验证保留页
要确认保留页，请使用 oncheck -cr 命令。
保留页是位于根数据库空间初始块开始处的页。这些页包含主数据库服务器开销信息。如
果该命令检测到错误，请从存储空间备份执行数据复原。
该命令可能会提供警告。在大多数情况下，这些警告让您注意的是您已经知道的情况。
验证元数据
对每个数据库运行 oncheck -cs 以验证数据库中所有智能大对象的元数据。
如有必要，
从数
据库空间备份复原数据。
监视数据不一致性
如果一致性检查代码在数据库服务器操作期间检测到不一致，将向数据库服务器消息日志
报告断言失败。（请参阅《GBase 8s 管理员参考》中的消息日志主题。）
消息日志和转储文件中的读断言失败
以下示例显示断言失败在消息日志中采用的格式。
Assert Failed: Short description of what failed
Who: Description of user/session/thread running at the time
Result: State of the affected database server entity
Action: What action the database server administrator should take
See Also: file(s) containing additional diagnostics
See Also: 行中包含以下一个或多个文件名：
af.xxx
shmem.xxx
gcore.xxx
gcore.xxx
/path name/core
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 342 -
在所有情况中，
xxx 对与单个线程的断言失败相关联的所有文件而言是一个公共的十六进制
数。文件 af.xxx、shmem.xxx 和 gcore.xxx 位于 ONCONFIG 参数 DUMPDIR 指定的目录
下。
文件 af.xxx 包含发送到消息日志的断言失败消息的副本以及当前相关结构和数据缓冲区的
内容。
仅当 ONCONFIG 参数 DUMPSHMEM 设置为 1 或 2 时，文件 shmem.xxx 才包含断言失
败时数据库服务器共享内存的完整副本。
仅限 UNIX：
在 UNIX™ 上，
仅当 ONCONFIG 参数 DUMPGCORE 设置为 1 且您的操作
系统支持 gcore 实用程序时，gcore.xxx 才包含数据库服务器虚拟进程（线程此时在其上运
行）的核心转储。仅当 ONCONFIG 参数 DUMPCORE 设置为 1 时，core 才包含数据库服
务器虚拟进程（线程此时在其上运行）的核心转储。core 文件的路径名是上次调用数据库
服务器的目录。
验证表和表空间数据
要验证表和表空间数据，请对数据库或表使用 oncheck -cD 命令。
大多数的一般断言失败消息后面均跟随其他信息，
其他信息通常包含检测到错误的表空间。
如果此检查确认存在不一致情况，请从表中卸载数据，删除该表，重新创建该表，并重新
装入该数据。否则，无需执行其他任何操作。
在许多情况中，数据库服务器当断言失败时会立即停止。但是，当失败看起来是特定于某
个表或较小实体时，数据库服务器会继续运行。
当断言是由于数据库服务器代表用户访问的数据页上的不一致而失败时，还会将错误发送
至应用程序进程。SQL 错误取决于正在进行的操作。但是，ISAM错误几乎始终是 -105 或
-172，如下所示：
-105 ISAM error: bad isam file format
-172 ISAM error: Unexpected internal error
有关消息的目标和内容的更多详细信息，请参阅《GBase 8s 管理员参考》中有关消息日志
消息的主题。
保留一致的 0 级备份
在您执行验证一致性中描述的检查而不出错之后，请创建 0 级备份。保留该存储空间备份
和所有后续的逻辑日志备份磁带，直至您完成下一次一致性检查。请在每次 0 级备份之前
执行一致性检查。如果不这样做，那么至少保留所有从存储空间备份恢复所需的磁带，该
备份是在验证数据库服务器一致之后立即创建的。
GBase 8s ESQL/C 程序可以使用 SQL 语句与数据库服务器通信。该程序可以使用静态和
动态SQL 语句。
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 7 -
静态 SQL 语句是指编译程序时所有组件都已知的 SQL 语句。
动态 SQL 语句是您在编译
时不指定所有组件的语句；该程序在运行时接收全部或部分语句。
可以使用以下两种格式之一将 C 语言嵌入到 C 函数中：
l
EXEC SQL 关键字：
EXEC SQL SQL_statement;
使用 EXEC SQL 关键字是嵌入 SQL 语句的 ANSI 兼容方法。
l
美元符号 ($) ：
$SQL_statement;
在任一格式中，使用有效语句的完整文本代替 SQL_statement。GBase 8s ESQL/C 语句可
以在大多数可以使用常量的地方包含主机变量。
嵌入式 SQL 语句中的区分大小写
下表描述了 GBase 8s ESQL/C 预处理程序如何对待大写和小写字母。
表 1. ESQL/C 文件中区分大小写
ESQL/C 标
识符
区分
大小写
示例
主机变量
是
GBase 8s ESQL/C 将变量 fname 和 Fname 视为不同的变
量：
EXEC SQL BEGIN DECLARE SECTION;
char fname[16], lname[16];
char Fname[16];
EXEC SQL END DECLARE SECTION;
该样本不会从预处理器生成警告。
变量类型
是
GBase 8s ESQL/C 和 C 将数据类型的名称都视为区分大小写。
以下示例中的 CHAR 类型与 char 数据类型不同，它会生成错误：
EXEC SQL BEGIN DECLARE SECTION;
char fname[16], lname[16];
CHAR Fname[16];
EXEC SQL END DECLARE SECTION;
然而，如果为它提供一个 typedef 语句 CHAR 类型不会生成
错误。在以下示例中，CHAR 类型不会生成错误：
typedef char CHAR;
EXEC SQL BEGIN DECLARE
SECTION;
char fname[16], lname[16];
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 8 -
CHAR Fname[16];
EXEC SQL END DECLARE
SECTION;
SQL 关键
字
否
两个 CONNECT 语句是建立与 stores7 演示数据库的连接的
有效方法：
EXEC SQL CONNECT TO 'stores7';
or
EXEC SQL connect to
'stores7';
在本出版物中给出的示例中，SQL 关键字都以小写字母显示。
语句标识符
游标名称
否
以下示例显示语句 ID 和游标名称的创建：
EXEC SQL prepare st from
'select * from tab1';
/* duplicate */
EXEC SQL prepare ST
from
'insert into tab2
values (1,2)';
EXEC SQL declare
curname cursor
for st;
/* duplicate */
EXEC SQL declare
CURNAME cursor
for ST;
该代码产生错误，
因为语句 ID st 和 ST 是重复的，
游标名称
curname 和 CURNAME 也是相同的。
引号符号和转义字符
转义字符指示 GBase 8s ESQL/C 预处理器应将字符打印为文字字符而不是对其进行
解释。可以使用带有解释字符的转义字符来使编译器转义或忽略解释的含义。
在 ANSI SQL 中，
反斜杠字符
（\）
是转义字符。
要搜索以字符串 \abc 开始的数据，
WHERE 子句必须如下使用转义字符：
... where col1 = '\\abc';
但是，ANSI 标准指定使用反斜杠字符（\）转义单引号（' '）或双引号（" "）是无效
的。例如，以下查找引号的尝试不符合 ANSI 标准：
... where col1 = '\'';
在非嵌入式工具（例如 DB-Access）中，可以使用以下方法转义引号符号：
可以使用与转义字符相同的引号，如下所示：
... where col1 = '''';
可以使用另一种引号。例如，要查找双引号，可以将此双引号用单引号括起，如下所
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 9 -
示：
... where col1 = ' "';
下图显示一个带有 WHERE 子句的 SELECT 语句，其中包含引号括起来的双引号。
图: 具有无效 WHERE 子句的 SELECT 语句
EXEC SQL select col1 from tab1 where col1 = ' "';
对于表 1 中的 WHERE 子句，GBase 8s ESQL/C 预处理器不会处理双引号；它将此
双引号传递给 C 编译器。当 C 编译器接收带字符串 ' " ' （引号括起来的双引号），它将
第一个引号解释为字符串的开始，双引号解释为字符串的结束。编译器不会匹配剩下的引
号因此产生错误。
要使 C 编译器将双引号解释为一个字符，请在双引号之前带有 C 转义字符——反斜
杠（\）。以下示例显示表 1中查询的正确语法：
EXEC SQL select col1 from tab1 where col1 = '\"';
因为 C 和 ANSI SQL 都使用反斜杠字符作为转义字符，
当您在嵌入式查询中查找字
符反斜杠时，请留意。以下查询显示查找字符串 "\" 的正确语法（双引号作为字符串的一
部分）：
EXEC SQL select col1 from tab1 where col1 = '\"\\\\\"';
此字符串需要五个反斜杠以获取正确的释义。三个反斜杠是转义字符，一个用于双引
号，一个用于反斜杠。下表显示了它通过每个处理步骤处理后的字符串。
表 1. 转义查询字符串处理后
处理器
处理后
ESQL/C 预处理器
'\"\\\\\"'
C 编译器
'"\\"'
符合 ANSI 的数据库服务器
'"\"'
GBase 8s ESQL/C 支持单引号（'string'）或双引号（"string"）。但是，C 语言字符
串仅支持双引号中的字符串。因此，GBase 8s ESQL/C 预处理器将 GBase 8s ESQL/C源文
件中的每一条语句转换为双引号字符串。
引号字符串中的换行符
GBase 8s ESQL/C不支持引号字符串中的换行符（0x0A）。但是，如果您指定您希望
允许它，数据库服务器不允许在引号字符串中使用换行符。因此，您可以将引用的字符串
包含在动态的准备好的 SQL 语句的一部分中，因为数据库服务器而不是 GBase 8s
ESQL/C 处理准备好的语句。
可以指定您希望数据库服务器以引号字符串的形式允许每个会话或全部会话的换行
符。会话是客户端连接到数据库服务器的持续时间。
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 10 -
要允许或禁止特定会话的引号字符串中的换行符，您必须执行用户定义的例程
ifx_allow_newline(boolean)。
以下示例说明了如何启动 ifx_allow_newline() 用户定义的例程
以在引用字符串中允许换行符：
EXEC SQL execute procedure ifx_allow_newline('t');
要在引号字符串中禁用换行符，将参数更改为 f，如下所示：
EXEC SQL execute procedure ifx_allow_newline('f');
要在所有会话的引号字符串中的允许或禁用换行符，设置 onconfig 文件中的
ALLOW_NEWLINE 参数。值 0 表示禁止引用换行符。
向 ESQL/C 程序添加注释
要在 GBase 8s ESQL/C 程序中添加注释，可以使用以下任一格式：
可以在任意 GBase 8s ESQL/C 语句上使用双重破折号
（--）
。
该语句比较以 EXEC SQL
或 $ 开头并以分号结尾。该注释继续到行的末尾。
例如，以下第一行的注释说明 GBase 8s ESQL/C 语句打开 stores7 演示数据库：
EXEC SQL database stores7; -- stores7 database is open now!
printf("\nDatabase opened\n"); /* This is not an ESQL/C */
/* line so it needs a */
/* regular C notation */
/* for a comment */
可以在 GBase 8s ESQL/C 行使用标准的 C 注释，如下所示：
EXEC SQL begin work; /* You can also use a C comment here */
主机变量
主机变量是在嵌入式 SQL 语句中使用的 GBase 8s ESQL/C 或 C 变量，用于在数据
库列和 GBase 8s ESQL/C 程序之间传输数据。
当在 SQL 语句中使用主机变量时，必须先在其名称前面加上一个符号，以将其标识
为主变量。您可以使用以下符号之一：
冒号（:）
例如：将名为 hostvar 的主机变量指定为连接名称，使用以下语法：
EXEC SQL connect to :hostvar;
使用冒号（:）作为主机变量的前缀，符合 ANSI SQL 标准。
美元符号（$）
例如：将名为 hostvar 的主机变量指定为连接名称，使用以下语法：
EXEC SQL connect to $hostvar;
当在一条 SQL 语句中列出多个主机变量是，
使用逗号
（,）
将主变量分隔。
例如：
esql
命令将下行解释为两个主变量 host1 和 host2：
EXEC SQL select fname, lname into :host1, :host2 from customer;
如果省略逗号，esql 会将第二个变量解释为第一个主变量的指示变量。esql 命令将下
GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 11 -
行解释为一个主变量 host1 和一个 host1 主变量的指示变量 host2 ：
EXEC SQL select fname, lname into :host1 :host2 from customer;
在 SQL 语句之外，像常规的 C 变量一样处理主机变量。