gbase数据、南大通用产品文档：GBase8a：告警级别，统一监控目前支持4 种告警级别，有1：

严重；2：次要；3：警告；4：提醒。


sword GCIDirPathPrepare (
GCIDirPathCtx *dpctx，

GCISvcCtx *svchp，
GCIError *errhp
)；

在转换或加载任何行之前准备直接路径加载接口。

参数
输入
/输出


dpctx
输入
加载对象的直接路径上下文句柄
svchp
输入
服务上下文
errhp
输入
错误信息句柄， 该接口调用失败时， 错误信息会存在该句柄上

如果执行成功，返回GCI_SUCCESS，否则返回GCI_ERROR。



GBase 8s GCI 接口使用指南

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

使用 TRACE 语句来控制调试输出的生成。
语法

用法
TRACE 语句生成输出，该输出会发送给 SET DEBUG FILE TO 语句指定的文
件。跟踪以下程序对象的当前值写入到调试文件：

GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1243

SPL 变量

例程参数

返回值

SQL 错误代码

ISAM 错误代码
每个执行的 TRACE 语句的输出以独立行显示。
如果在指定 DEBUG 文件以包含输出前使用 TRACE 语句，则会生成错误。
SPL 例程调用的任何例程继承跟踪状态。即，调用的例程（在相同的数据库服务
器上）假设相同的跟踪状态（ON 、OFF 或 PROCEDURE）作为调用例程。调用
的例程可设置其子句的跟踪状态，但不将该状态传递回调用的例程。
在远程数据库服务器上执行的例程不继承跟踪状态。
TRACE ON
如果指定关键字 ON，则跟踪所有语句。在使用变量（在表达式中或其它）的值
之前打印它们。将跟踪设置为 ON 表示例程主体中的例程调用和语句都被跟踪。
TRACE OFF
如果您指定关键字 OFF，则所有的跟踪都被关闭。
TRACE PROCEDURE
如果指定关键字 PROCEDURE，则仅跟踪例程调用和返回值，而非例程主体。
TRACE 语句没有 ROUTINE 或 FUNCTION 关键字。因为即使想要跟踪的 SPL
例程是一个函数，也使用 TRACE PROCEDURE 关键字。
显示表达式
可以使用具有引号引起的字符串或表达式的 TRACE 语句显示输出文件中的值或
注释。如果表达式不是字符表达式，则在写入输出文件之前计算表达式的值。
即使在例程中较早地使用了 TRACE OFF 语句，也可以使用具有表达式的
TRACE 语句。但必须首先使用 SET DEBUG 语句建立一个跟踪输出文件。

GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1244
下一个示例在使用 TRACE OFF 语句之后使用具有表达式的 TRACE 语句。该示例
使用了 UNIX™ 文件命名约定：
CREATE PROCEDURE tracing ()
DEFINE i INT;
BEGIN
ON EXCEPTION IN (1)
END EXCEPTION; -- do nothing
SET DEBUG FILE TO '/tmp/foo.trace';
TRACE OFF;
TRACE 'Forloop starts';
FOR i IN (1 TO 1000)
BEGIN
TRACE 'FOREACH starts';
FOREACH SELECT...INTO a FROM t
IF THEN
RAISE EXCEPTION 1 -- emergency 退出
END IF
END FOREACH -- 返回值
END
END FOR
END;
END PROCEDURE
显示不同格式的 TRACE 的示例
以下示例显示了几种不同格式的 TRACE 语句。该示例使用了 Windows™ 文件
命名约定：
CREATE PROCEDURE testproc()
DEFINE i INT;
SET DEBUG FILE TO 'C:\tmp\test.trace';
TRACE OFF;
TRACE 'Entering foo';
TRACE PROCEDURE;
LET i = test2();

TRACE ON;
LET i = i + 1;


GBase 8s SQL 指南：语法
南大通用数据技术股份有限公司 1245
TRACE OFF;
TRACE 'i+1 = ' || i+1;
TRACE 'Exiting testproc';

SET DEBUG FILE TO 'C:\tmp\test2.trace';

END PROCEDURE
查看跟踪输出
要查看跟踪输出，请使用文本编辑器或类似的实用程序显示或阅读文件内容。