更新日期：2024年09月11日
本示例中，设定将数据中的NULL 值表示为'%null%'，导出方法如下：
$ ./orato8a --user='ssbm/ssbm@maya' --table_name='message' --file='./message.tbl' --format=3
--field=';' --null_value='%null%'
export columns: 3
GBase 8a MPP Cluster 产品手册
4 管理员指南
文档版本953（2022-09-15）
南大通用数据技术股份有限公司
553
export rows: 10
export time: 0 sec
process ok!
$ cat message.tbl
1;Tom;I am Tom
2;小明;HHHH"KKKK
3;Peter;Hello!Hello!
4;Yama;send mail
5;Hellen;%null%
6;%null%;%null%
7;Seven;a book store
8;MMEE;yes
9;George;Thank you.
10;Lastman;no message
ifx_rc_insert() 函数将新的值插入到集合中。
语法
ifx_rc_insert(rchandle, value, action, jump)
参数
该函数接受以下参数。
参数
类型
用于
描述
rchandle
HINFX_RC
输入
集合缓冲区的句柄
value
元素的数据类型
输入
要插入的值
action
SQL_SMALLINT
输入
元素相对于查找位置的位置。值可能为：
SQL_INFX_RC_ABSOLUTE ：: 元素
jump ，缓冲区中的第一个元素是元素
1
SQL_INFX_RC_CURRENT：当前元素
SQL_INFX_RC_FIRST：第一个元素
SQL_INFX_RC_LAST：最后一个元素
SQL_INFX_RC_NEXT：下一个元素
SQL_INFX_RC_PRIOR：上一个元素
SQL_INFX_RC_RELATIVE：
: jump 跳
过当前元素的元素
jump
SQL_SMALLINT
输入
当 action 是 SQL_INFX_RC_ABSOLUTE
或 SQL_INFX_RC_RELATIVE 时，偏移
用法
ifx_rc_insert() 函数将新的元素插入到 action 和 jump 指定之前的位置。
函数将查找位置设
置为已插入的值的位置。无法向行插入新的元素。
下表描述了每种集合类型的允许的插入操作。
集合的类型
允许插入的位置
List
缓冲区中的任何位置
Set 或 multiset
缓冲区的末尾
如果由 action 和 jump 值的查找位置超出缓冲区的末尾，则 ifx_rc_insert() 将新的元素附
加到缓冲区的末尾。
同样地，
如果 action 和 jump 指定查找位置在缓冲区的起始位置之前，
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 184 -
则 ifx_rc_insert() 在缓冲区的开头插入新的元素。如果 action 指定一个插入的指针而不是
set 或 multiset 的末尾，则 ifx_rc_insert() 失败。
例如，如果 action 是 SQL_INFX_RC_LAST，则该函数在最后一个元素之前插入新值。要
附加新的元素，请采取以下操作：
ₒ
将查找位置设置为缓冲区的末尾，并将 action 设置为 SQL_INFX_RC_NEXT。
ₒ
将 action 设置为 SQL_INFX_RC_ABSOLUTE 或 SQL_INFX_RC_RELATIVE ，并将 jump
设置为超出缓冲区末尾的值。
要在缓冲区的开始位置插入新的值，请将 action 设置为 SQL_INFX_RC_FIRST。