TcaplusDB Client - insert命令
TcaplusDB Client的使用方法参见文档。
1. 功能说明
向表格中插入一条数据,可采用显示声明参数或传入文件两种方式操作。
目前表是PB表时,允许包含嵌套字段。目前表是TDR表时,并且包含嵌套字段时,使用该命令会报错。
相同Key的数据如果已经存在,则会报错。
2. 启始版本
3.40.0
3. 命令语法
##显示声明参数的值插入一条数据
insert into table (key1, key2, value1, vlaue2) values (1, "abc", 2, "def") [after -1] [shift none/head/tail];
##从csv格式文件中读取并插入一条数据
insert into table infile result.csv [after -1] [shift none/head/tail];
##从xml格式文件中读取并插入一条数据,该操作必须在启动client时提供tdr文件
insert into table infile result.xml [after -1] [shift none/head/tail] using tdr;
参数说明:
参数 | PB表 | TDR表 | 必填 |
---|---|---|---|
table | 表格的名字 | 表格的名字 | 是 |
key | 主键字段名 | 主键字段名 | 是 |
value | 非主键字段名 | 非主键字段名 | 至少一个或 * |
after | Generic表: 不支持 List表: n>0 表示从第n条数据插入;n=-2表示从队首插入数据;n=-1表示从队尾插入数据;n<-2不支持 |
Generic表: 不支持 List表: n>0 表示从第n条数据插入;n=-2表示从队首插入数据;n=-1表示从队尾插入数据;n<-2不支持 |
否 |
shift | 如果表格大小超过阈值(即表格的最大size),可选择:none:不淘汰数据;head:从队头淘汰;tail:从队尾淘汰数据 | 如果表格大小超过阈值(即表格的最大size),可选择:none:不淘汰数据head:从队头淘汰tail:从队尾淘汰数据 | 否 |
using tdr | 不支持 | 如果需要使用该参数,则在启动TcaplusDB Client时,就要通过启动参数指定与目标表对应的TDR文件 使用该参数时,如果导入的是XML格式的数据文件,则文件结构严格满足XML语法要求 |
否 |
infile | 从文件中读取数据 | 从文件中读取数据 | 否 |
4. 命令示例
示例使用的数据文件下载:
表定义详见示例表定义。
tcaplus>insert into test_table (gameid,itemid,name) values (1,1,abc);
insert success
insert time: 45322 us
tcaplus>insert into test_table (gameid,itemid,name,typeid,Data,uname) values (1,1,abc,1,1,abc);
insert success
insert time: 8412 us
tcaplus> Insert into table_list (uin, name, key1) values (99,99,99) after -1 shift tail;
insert success
insert time: 22464 us
tcaplus> Insert into table_list infile result.xml using tdr;
insert success
insert time: 9493 us
tcaplus> Insert into table_list infile result.csv;
insert success
insert time: 22368 us
5. 常见错误
参考常见错误文档。
6. 相关文档
[TDR Generic表][C++ SDK]插入单条数据接口说明。
[TDR Generic表][Java SDK]插入单条数据接口说明。
[TDR Generic表][Go SDK]插入单条数据接口说明。
[TDR List表][C++ SDK]插入单条数据接口说明。
[TDR List表][Java SDK]插入单条数据接口说明。
[TDR List表][Go SDK]插入单条数据接口说明。
[PB Generic表][C++ SDK]插入单条数据接口说明。
[PB Generic表][Go SDK]插入单条数据接口说明。
[PB Generic表][RESTFul API]插入单条数据接口说明。