TcaplusDB Client - select命令(查询全局索引)
TcaplusDB Client的使用方法参见文档。
1. 功能说明
根据用户指定的部分全局索引字段的值,查询所有符合条件的数据。支持整条数据的所有字段值或部分字段的值。如果没有匹配的记录,将会返回错误。
查询全局索引前,必须已经为该表创建了全局索引。创建方法参见:创建全局索引。
请注意,保存查询结果的文件名不能以数字开头。
2. 启始版本
3.46.0
3. 命令语法
select key1, key2, key3, value1, value2 [into result.csv] from table [where index_key1 = 1 and index_key2 = "abc"] [\P] [\G] [\S] [using tdr] [encode]
select * [into result.xml] from table [where index_key1 = 1 and index_key2 = "abc"] using tdr [\P];
参数说明:
参数 | PB表 | TDR表 | 必填项 |
---|---|---|---|
table | 表格的名字 | 表格的名字 | 是 |
index_key | 索引字段名,可以指定部分索引字段的值 | 索引字段名,可以指定部分索引字段的值 | 是 |
key/value | 字段名 | 字段名 | 至少一个或 * |
\P | 打印时延数据 | 打印时延数据 | 否 |
\G | 竖排打印 | 竖排打印 | 否 |
\S | 从从副本读取数据 | 从从副本读取数据 | 否,不填默认从主副本读取数据 |
\N | 不打印字段名 | 不打印字段名 | 否,不填默认打印字段名 |
\A | 将查询结果追加写到结果文件 | 将查询结果追加写到结果文件 | 否,不填默认将查询结果覆盖写到结果文件 |
into | 输出数据到文件 | 输出数据到文件 | 否 |
using tdr | 不支持 | 如果需要使用该参数,则在启动TcaplusDB Client时,就要通过启动参数指定与目标表对应的TDR文件 | 否 |
encode | 不支持(回车字符或不可见字符已预处理) | 指定该参数后,导出命令会将含有回车字符或不可见字符的string类型字段值进行BASE64编码后,再输出 注意:只指定了 using tdr 参数时,该参数才生效 |
否 |
4. 命令示例
假设已经对表格的name和uname两个字段创建了全局索引。 表定义详见示例表定义。
tcaplus> select * from test_table where name='testname' and uname='ab';
+------+------+----------+------+----+-----+
|gameid|itemid|name |typeid|Data|uname|
+------+------+----------+------+----+-----+
|1234 |12323 |"testname"|0 |9 |"ab" |
+------+------+----------+------+----+-----+
1 records selectd, select time: 9802 us
tcaplus> select uname from test_table where name='testname' and uname='ab';
+------+------+----------+-----+
|gameid|itemid|name |uname|
+------+------+----------+-----+
|1234 |12323 |"testname"|"ab" |
+------+------+----------+-----+
1 records selectd, select time: 9457 us
5. 常见错误
参考常见错误文档。
6. 相关文档
[TDR Generic表][C++ SDK]查询全局索引接口说明。
[TDR Generic表][Go SDK]查询全局索引接口说明。
[PB Generic表][C++ SDK]查询全局索引接口说明。