gbase数据、南大通用产品文档：GBase8c

参数说明
通用参数

-u, --user TEXT
指定用户名称。缺省值为gbase。

-p, --port INTEGER
指定连接端口号。

-c, --cluster TEXT
指定集群名称。缺省值为gbase。

-l, --dcs_url TEXT
必选项。指定DCS 节点连接地址。格式为http://host:ip。

GBase 8c 工具参考手册
南大通用数据技术股份有限公司
50

--help
显示命令帮助信息。
以下显示各命令特定参数的描述。
add 命令参数
指定添加节点的类型，可选值为coordinator、datanode、dcs、gtm、server。

coordinator

-r, --role TEXT
协调器角色可以设置为master 或slave，如果设置为slave，则协调器将只读sql 语句路
由到复制的数据节点。

-s, --sync_mode TEXT
仅当协调器角色设置为从属时有效。如果设置为synccoordinator，则将只读sql 语句路
由到synchronousreplicated 数据节点，否则协调器可以将只读语句路由到异步replacated 数
据节点。

--agent_host TEXT

datanode

--agent_host TEXT
设置gha 代理地址。

gtm

--agent_host TEXT
设置gha 代理地址。

server
backup 和restore 命令参数
指定备份/恢复范围类型，可选值为all、dcs、topo。

GBase 8c 工具参考手册
南大通用数据技术股份有限公司
51

all

-p, --config TEXT
必选项。指定配置文件所在的路径。
create 命令参数

-P, --path TEXT
必选项。指定包文件路径。

-v, --version TEXT
必选项。指定包文件的版本号。
expand 和shrink 命令参数

datanode
指定扩容或缩容数据节点。

-u, --uuid TEXT
必选项。指定uuid。

-j, --parallel_jobs INTEGER
指定可并行进行任务的数量。
当用户指定的并行度数值大于0 时，gs_redis 工具并行度参数使用用户指定的数值；但
当用户不指定-j 参数或并行度小于1 时，gs_redis 的并行度参数使用默认规则数值。
get 命令参数

constant
获取集群的常量信息。

expand
获取集群的扩容信息。

GBase 8c 工具参考手册
南大通用数据技术股份有限公司
52

service
获取DCS 管理的集群名称。

sync-priority
获取集群的同步备节点信息。

sync-strict
获取集群的强同步信息。
install 命令参数

-p, --config TEXT
必选项。指定yml 配置文件的路径。

-f, --force_install / -F, --no-force_install
指定此项，表示不检查旧集群是否存在，而强制安装集群。
install-dcs 命令参数

-e, --exist / -E, --no-exist
指定此项，表示不检查DCS 集群是否存在，执行安装。
monitor 命令参数

-H, --humanreadable / -h, --no-humanreadable
若指定该项，则以表格形式显示信息。

-I, --internaloption / -i, --not-internaloption
显示不同状态的内部专用选项。
prepare 命令参数

-t, --cluster_type TEXT
指定集群类型。可选值：multiple-nodes、single-inst。默认为multiple-nodes。

GBase 8c 工具参考手册
南大通用数据技术股份有限公司
53
rollback 和upgrade 命令参数

-t, --type TEXT
指定回退或升级的类型，可选all、ha、app。
set 命令参数

constant
设置集群常量参数。

coordinator
设置集群CN 节点参数。

datanode
设置集群DN 节点参数。

gtm
设置集群GTM 节点参数。
start 和stop 命令参数

all
启动/停止集群所有节点，包括GTM、CN、DN 节点。

coordinator
启动/停止CN 节点。

datanode
启动/停止DN 节点。

gtm
启动/停止GTM 节点。

server

GBase 8c 工具参考手册
南大通用数据技术股份有限公司
54
启动/停止Server 节点。
uninstall 命令参数

-f, --force / -F, --no-force
若指定此项，则当没有gha server 节点时强制卸载集群。无论集群处于running 还是
stopped 状态都能够进行卸载操作。

ifx_lo_from_buffer() 函数将指定字节数从用户定义的缓冲区复制至智能大对象内。


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

语法
mint ifx_lo_from_buffer(LO_ptr, size, buffer, error)
ifx_lo_t *LO_ptr;
mint size;
char *buffer;
mint *error;
LO_ptr
您想要将数据复制至其内的智能大对象的 LO-pointer 结构。
size
标识要复制至智能大对象的字节数的 mint。
buffer
指向您想要从其复制数据的用户定义的缓冲区的指针。
error
包含保存 ifx_lo_from_buffer() 设置的错误代码的 mint 的地址。

用法
ifx_lo_from_buffer() 复制多达 size 指定的大小的字节，从用户定义的缓冲复制至
LO_ptr 参数标识的智能大对象内。对智能大对象的写操作始于零字节偏移量处。要使用
ifx_lo_from_buffer() 函数，在您复制数据之前，该智能大对象必须在 sbspace 中存在。

返回代码
0
函数成功。
-1
函数不成功。

GBase
8a
MPP
Cluster 中，集群加载功能直接集成在GBase
8a
MPP
Cluster
内部，不需要额外部署外部加载工具。
数据加载具备如下一些特性和优点：
1）与集群高度集成；
2）面向用户的SQL 接口方式更符合用户的使用习惯；
3）
支持单表多数据源并行加载，
支持多加载机对单表的并行加载，
最大化
提升加载性能；
4）支持从通用数据服务器拉取数据，支持
ftp/sftp/hdfs/Kafka/http/https 等多种文件传输协议；
5）支持普通文本、gzip 压缩、snappy 压缩、lzo 压缩等多种格式数据文
件；
6）支持普通文本、定长文本、宽松模式的加载；
7）支持用户自定义列分割符、行分隔符和日期时间格式；
8）支持错误数据溯源功能，可以准确定位错误数据在源文件中的位置；
9）加载性能可以随着集群规模的扩展而持续提升。