gbase数据、南大通用产品文档：GBase8s使用 chkenv 实用程序检查环境变量

chkenv 实用程序检查共享或专用环境配置文件的有效性。它验证该文件中各个环境
变量的名称，但不验证它们的值。当您在环境配置文件中定义 GBase 8s 产品使用的所有
环境变量时，使用 chkenv 来提供调试信息。

filename
是要调试的环境配置文件的名称。
pathname
是环境变量文件所在的完整目录路径。

功能描述
定义一种新的过程语言。单机和集中式暂不支持创建过程语言。
语法格式
CREATE [ OR REPLACE ] [ PROCEDURAL ] LANGUAGE name;
CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE name
HANDLER call_handler [ INLINE inline_handler ] [ VALIDATOR valfunction ];
参数说明

TRUSTED
TRUSTED 说明该语言并不授权没有权限的用户访问数据。
如果在注册该语言时忽略这
个关键字，则只有超级用户权限可以使用。

PROCEDURAL
这是个没有用的字。

name
新过程语言的名称。这个名字应该在数据库的所有语言中唯一。
出于向下兼容的原因，这个名字可以用单引号包围。

HANDLER call_handler
call_handler 是一个以前注册过的函数名字，该函数将被用来执行该过程语言的函数。
过程语言的调用处理器必须用一种编译语言(比如C)书写，调用风格必须是版本1 的调用风

GBase 8c SQL 参考手册
南大通用数据技术股份有限公司
900
格，
并且注册为不接受参数并且返回language_handler 类型的函数。
language_handler 是用于
将函数声明为调用处理器的占位符。

INLINE inline_handler
inline_handler 是以前注册过的函数名字，用来在该语言中执行一个匿名代码块(DO 命
令)。如果没有指定inline_handler 函数，那么该语言不支持匿名代码块。处理器函数必须接
受一个internal 类型的参数，这将是DO 命令的内部表示，并且它通常返回void。忽略该处
理器的返回值。

VALIDATOR valfunction
valfunction 是一个以前注册过的函数名字，
在用该语言创建新函数的时候将用它来校验
新函数。如果没有声明校验函数，那么建立新函数的时候就不会检查它。
校验函数必须接受
一个类型为oid 的参数，它是将要创建的函数的OID，并且通常会返回void。
校验函数通常会检查函数体，
看看有没有语法错误，
但是它也可以查看函数的其它属性，
比如该语言是否不能处理某种参数类型。校验函数应该用ereport()函数报告错误。该函数的
返回值将被忽略。
示例
创建标准的过程语言的比较好的方法：
CREATE LANGUAGE plperl;
对于pg_pltemplate 还不知道的语言，需要下面这样的序列：
CREATE FUNCTION plsample_call_handler() RETURNS language_handler
AS '$libdir/plsample'
LANGUAGE C;
CREATE LANGUAGE plsample
HANDLER plsample_call_handler;

sword GCIServerVersion(
void *hndlp,
CIError *errhp,
sb1 *bufp,
ub4 bufsz,
ub1 hndltype
)；

得到服务器的版本号。



GBase 8s GCI 接口使用指南

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

参数
输入
/输出


hndlp
输入
当前连接服务的上下文句柄
errhp
输入
错误信息句柄，该接口调用失败时将错误码及错误信息写入该句柄
bufp
输入
返回结果集的缓冲区地址
bufsz
输入
返回结果集的缓冲区的大小
hndltype
输入
保留参数， 目前不使用(仅用于和Oracle保持兼容)

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