gbase数据、南大通用产品文档：GBase8sifx_putenv() 函数

ifx_putenv() 函数更改现有环境变量的值，创建环境变量，或从运行时刻环境移除变
量。
语法
int ifx_putenv( envstring );
const char *envstring;
nvstring
指向形如 varname=string 的字符串的指针，其中 varname 是要添加或修改的环境变
量的名称，string 是变量值。

用法
ifx_putenv() 函数在 InetLogin 结构中添加新的环境变量，
或修改现有环境变量的值。
这些变量定义进程在其中执行的环境。如果 varname 已是环境的一部分，则 ifx_putenv()
以 string 替代现有的值；否则，ifx_putenv() 以值 string 将 varname 添加至环境。

要从运行时刻环境移除变量，则请将 varname 指定为它的缺省值。如果缺省值为
NULL，则以 ifx_putenv() 将变量设置为空字符串，可有效地移除它。如果该变量的缺省值
不为 NULL，则以 ifx_putenv() 将该变量设置为空，将变量重置为它的缺省值，但未将它
从运行时刻环境移除。

ifx_putenv() 函数先设置 GBase 8s 变量，然后是其他变量。

下列对 ifx_putenv() 函数的调用更改 GBASEDBTDIR 环境变量的值：
ifx_putenv( "gbasedbtdir=c:\gbasedbt" );

此函数仅影响当前进程的环境变量。命令处理器的环境不更改。

返回代码
0
调用 ifx_putenv() 成功。
-1
调用 ifx_putenv() 不成功。

GBase 8s ESQL/C 编程指南
南大通用数据技术股份有限公司
- 812 -

功能说明
记录集群层资源池event 信息。
表结构说明
表5- 230 表结构信息说明：
列
名
描
述
NODE_NAME
节点名称
VC_ID
虚拟集群ID
VC_NAME
虚拟集群名称
RESOURCE_POOL_ID
资源池ID 号，取值范围同字段类型取值范围
RESOURCE_POOL_NAME
资源池名称
EVENT_TIME
event 发生时间
TASK_ID
任务ID
STATEMENT
SQL 语句

GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953（2022-09-15）
南大通用数据技术股份有限公司
1471
EVENT_TYPE
event 类型，包括terminate（终止已经开始执行的
任务）和reject（终止尚未开始执行的任务）
EVENT_DESCRIPTION
发生event 的原因描述，等待超时，运行超时，资
源不足等

导出ORC 文件说明

orc 文件导出语法同8a 的常规导出：
select ... into outfile 'file_name' [option] from ...;
select ... from ... into outfile 'file_name' [option];
option 参数支持情况：
1.可正常使用的参数：outfilemode by、writemode by、filecount、filesize、character
set
2.语法可通过并正常执行，但实际不起作用，会报warnings 的参数：files/columns
terminated by、files/columns enclosed by、files/columns escaped by、lines terminated
by、lines starting by、files/columns double_enclosed by、null_value、files/columns
length、with head

orc 文件导出支持本地、ftp、sftp、hdfs 方式导出

GBase 8a MPP Cluster 产品手册
5 数据库管理指南
文档版本953（2022-09-15）
南大通用数据技术股份有限公司
1221

orc 文件导出不支持远程导出(rmt)、kafka 导出、http 导出

orc 文件导出需指定导出文件名后缀为".orc"或者".ORC"。不支持导出压缩的
orc 文件，如后缀为.orc.gz 导出的仍然为压缩的文本文件

orc 文件导出支持配置导出的orc 文件参数：stripe 大小(默认64M)、orc 文件
内部的数据压缩格式(none/zlib/zstd)、orc 文件压缩块大小(默认64k)，可通过
配置文件、global、session 参数设置实现，如：
set global gbase_export_orc_stripe_size=67108864
set global gbase_export_orc_compression_kind=zlib;
set global gbase_export_orc_compression_block_size=65536
注：数字单位均为字节

orc 文件导出支持设置导出orc 文件大小超限分裂，通过参数filesize 指定查
询结果有效数据长度大于等于filesize 值时，
分裂成新的文件(数据以行保存，
新数据文件不会跨行截断保存)。
filesize 默认值为0，
即不限制导出文件大小，
filesize 的单位默认为字节，支持K/M/G 写法，如64M/16G.

orc 文件导出支持设置并行导出ORC 文件到HDFS 的文件个数，由参数
filecount 指定，默认不限制并行导出的文件个数，即并行导出每个分片为一
个文件。如果同时指定filecount 和filesize 参数，则表示并行导出filecount
组文件，每组文件按filesize 自动分裂。只对导出到HDFS 有效。

orc 文件导出支持设置导出文件自动创建目标目录，即导出时自动创建与导
出文件同名的目标目录，可使用参数gbase_export_directory 控制，默认值为
1 表示自动创建，设置为0 时不创建文件名的同名目录。该参数支持配置文
件、global、session 设置。