TcaplusDB Client - select命令(遍历表)
TcaplusDB Client的使用方法参见文档。
1. 功能说明
遍历表中的所有数据,支持查看数据所有字段值或者部分字段的值。默认从slave副本遍历数据。
如果需要对查询到文件中的记录进行修改,再更新到服务端,请使用load命令。
请注意,对于List表,load命令会直接插入一条新记录,如果需要更新服务端的原有记录,请使用update命令并指定index。
请注意,保存查询结果的文件名不能以数字开头。
使用select执行的命令,没有匹配任何索引时,和dump命令是等价的。
2. 启始版本
3.40.0
3. 命令语法
select key1, key2, key3, value1, value2 [into result.csv] from table [where ...] [using tdr] [encode]
select * [into result.xml] from table using tdr [\P];
pb表指定字段查询导出(3.55版本支持):
enable delta result;
select key1, key2, key3, value1, value2 [into result.xml] from table;
参数说明:
参数 | PB表 | TDR表 | 必填项 |
---|---|---|---|
table | 表格的名字 | 表格的名字 | 是 |
value | 非主键字段名 | 非主键字段名 | 至少一个或 * |
into | 输出数据到文件(3.55版本支持指定字段导出,需提前执行enable delta result设置,enable delta result 仅在单次运行tcaplus_client期间生效,通常不需要再disable) | 输出数据到文件 | 否 |
using tdr | 不支持 | 如果需要使用该参数,则在启动TcaplusDB Client时,就要通过启动参数指定与目标表对应的TDR文件 | 否 |
where | 在3.55.0版本之后支持过滤条件 | 同PB表 | 否 |
encode | 不支持(回车字符或不可见字符已预处理) | 指定该参数后,导出命令会将含有回车字符或不可见字符的string类型字段值进行BASE64编码后,再输出 注意:只指定了 using tdr 参数时,该参数才生效 |
否 |
4. 命令示例
表定义详见示例表定义。
tcaplus> select * from test_table;
[Execute] as dump command.
[Execute] read from slave.
TimeKey,GameSvrID,GameAppID,OnlineCntIOS,OnlineCntAndroid,strstr
1,2,"",0,0,""
1,1,"",0,0,""
1,3,"",0,0,""
total 3 records successful
offset: 4294967300 shardid: 1
used time: 20226 us
5. 常见错误
参考常见错误文档。
6. 相关文档
[TDR Generic表][C++ SDK]遍历表接口说明。
[TDR Generic表][Java SDK]遍历表接口说明。
[TDR Generic表][Go SDK]遍历表接口说明。
[PB Generic表][C++ SDK]遍历表接口说明。