更新日期：2024年09月11日
功能
枚举型变量，用于指定HDFS 传输协议。
http：HTTP 传输协议；
https：HTTPS 传输协议；
rpc：RPC 传输协议。
与其它枚举型变量相同，参数值支持大写、小写及大小混合形式，比如以下
方式为合法的参数值：
http, Http, HTTP, https, Https, HTTPS，rpc，Rpc，RPC
当指定不同的HDFS 传输协议时，应根据实际配置指定HDFS 文件URL 中
的端口号，与传输协议匹配。
Hadoop 默认配置各协议端口如下：
HTTP 协议端口：50070；
HTTPS 协议端口：50470；
RPC 协议端口：9000。
表6- 81 参数值范围说明表
默认值
最小值
最大值
HTTP
无
无
需要额外配置以下参数：
1.
配置HDFS 访问协议为RPC 和正确的端口号，需要同时在gcluster 和gnode
的配置文件的[gbased]段中添加以下参数。
gbase_hdfs_protocol=RPC;
gbase_hdfs_port=8020;
-- 其中8020 为实际的HDFS 的RPC 端口号。
2.
如果HDFS 环境支持NameNode 高可用，还需要同时在gcluster 和gnode 的
配置文件的[gbased]段中添加以下参数。
gbase_hdfs_namenodes='hdfs_nn1:8020,hdfs_nn2:8020' -- 其中hdfs_nn1 和hdfs_nn2 为实际的
HDFS 的两个NameNode 节点的主机名。
3.
如果HDFS 环境要求使用Kerberos 认证，还需要同时在gcluster 和gnode 的
配置文件的[gbased]段中添加以下参数。
GBase 8a MPP Cluster 产品手册
6 附录
文档版本953（2022-04-10）
南大通用数据技术股份有限公司
1595
gbase_hdfs_auth_mode=KERBEROS;
gbase_hdfs_principal='principal' -- 其中‘principal’为有效的Kerberos 主体名。
gbase_hdfs_keytab='keytab' --
其中‘keytab’为与Kerberos 主体名相对应的密钥文件名。
sword GCIAttrSet(
dvoid *trgthndlp,
ub4 trghndltyp,
dvoid *attributep,
ub4 size,
ub4 attrtype,
GCIError *errhp
)；
设置句柄上的属性值。
参数
输入
/输出
trgthndlp
输入
需要设置属性的句柄指针
trghndltyp
输入
需要设置的句柄的类型， 可取以下值：
GCI_HTYPE_SVCCTX上下文句柄
GCI_HTYPE_SESSION连接信息句柄
GCI_HTYPE_STMT语句句柄
GCI_HTYPE_DIRPATH_CTX直接文件操作上下文
GCI_DTYPE_PARAM参数信息句柄
attributep
输入
要设置的属性值指针，取值情况如下所示：
GCI_HTYPE_SVCCTX
GCI_ATTR_SERVER - GCIServer结构句柄
GCI_ATTR_SESSION - GCISession结构句柄
GCI_HTYPE_SESSION
GCI_ATTR_USERNAME - 字符串指针
GCI_ATTR_PASSWORD - 字符串指针
GCI_HTYPE_STMT
GCI_ATTR_PREFETCH_ROWS - 无符号整形指针
GCI_HTYPE_DIRPATH_CTX
GCI_ATTR_BUF_SIZE – 无符号整形指针
GCI_ATTR_NAME – 字符串指针
GCI_ATTR_NUM_COLS – 无符号短整形指针
GCI_ATTR_SCHEMA_NAME – 字符串指针
GCI_ATTR_DIRPATH_INPUT – 无符号单字节整形指针
GCI_DTYPE_PARAM
GCI_ATTR_NAME – 字符串指针
GCI_ATTR_DATA_TYPE – 无符号短整形指针
GCI_ATTR_DATA_SIZE – 无符号整形指针
size
输入
保留参数， 目前不使用(仅用于和Oracle保持兼容)
GBase 8s GCI 接口使用指南
南大通用数据技术股份有限公司 40
attrtype
输入
要设置的句柄属性， 不同类型的句柄有不同的属性：
GCI_HTYPE_SVCCTX
GCI_ATTR_SERVER - 在上下文句柄中附加一个连接句柄
GCI_ATTR_SESSION - 在上下文句柄中附加一个连接信息句柄
GCI_HTYPE_SESSION
GCI_ATTR_USERNAME - 在连接句柄中设置登录的用户名
GCI_ATTR_PASSWORD - 在连接句柄中设置登录的口令
GCI_HTYPE_STMT
GCI_ATTR_PREFETCH_ROWS - 在语句句柄上设置预取的结果
集行数
GCI_HTYPE_DIRPATH_CTX
GCI_ATTR_BUF_SIZE – 直接文件操作时缓冲区的大小
GCI_ATTR_NAME – 直接文件操作时的表名
GCI_ATTR_NUM_COLS – 直接文件操作时表的列数
GCI_ATTR_SCHEMA_NAME – 保留参数，用于兼容Oracle，无实
际功能
GCI_ATTR_DIRPATH_INPUT – 保留参数，用于兼容Oracle，无实
际功能
GCI_DTYPE_PARAM
GCI_ATTR_NAME – 直接文件操作时设置列的名称
GCI_ATTR_DATA_TYPE – 直接文件操作时设置列的数据类型
GCI_ATTR_DATA_SIZE – 直接文件操作时设置列的数据类型大
小，以字节计
errhp
输入
错误信息句柄，该接口调用失败时将错误码和错误信息写入该句柄
如果执行成功， 则返回GCI_SUCCESS，否则返回GCI_ERROR。