【TcaplusDB知识库】Client工具的功能介绍

TcaplusDB提供client工具,支持使用条件过滤进行查询或更新。

Client工具在Api包的路径:release/x86_64/bin/tcaplus_client

Client命令中,可用条件过滤的命令有:

  • dump,全表扫描。
  • select,条件查询。
  • update,条件更新。
  • replace,条件替换。
  • delete,条件删除。
  • query,数组查询。

详细使用见client的help信息。

5.1 Dump

  • 全表扫描

    client 内部调用 Traverse 或 ListTraverse 接口全表扫描。

    如: dump * from user where rank < 10 limit 10;

5.2 Select

  • 主键查询

    若条件中指定了主键(但不仅只有主键),client 内部调用 Get 或 ListGet 或 ListGetAll 接口进行查询。

    如: select * from list_user where id = 1 and name = 'aka' and $.LastAccessTime < '2021-10-01';

  • Partkey查询

    若条件中指定了部分key字段(可能还有其他条件),client 内部使用 IndexGetRequest 请求进行查询。

    如: select * from list_user where id = 1 and $.LastAccessTime < '2021-10-01' limit 10;

    注意,若可能返回多个记录,需使用 limit 指定数目,默认是 limit 1

  • 全表查询

    若条件中无法确定全key(主键)或者部分key,那么 client 无法使用 ListGet 或 ListGetAll 接口进行查询。 那么 client 会优先尝试使用全局索引进行全表的SQL查询,若全局索引服务不可用,client 则使用 Traverse 或 ListTraverse 接口全表扫描,即等价于Dump。

    Select 命令中,全局索引的优先级总是比全表遍历过滤查询高,在全局索引服务可用的情况下,若想强行使用全表遍历过滤,则可使用 Dump 命令。

    如:select * from list_user where $.LastAccessTime < '2021-10-01' limit 10;

    注意,若可能返回多个记录,需使用 limit 指定数目,默认是 limit 1

5.3 Update

  • 字段更新

    client 内部调用 FieldSet 或 ListReplace 接口进行记录修改,因此条件中必须给定主键,对于 List 表还必须给定 -index 的值。

    如: update list_user set rank = 0 where id = 1 and name = 'aka' and -index = 0;

  • 数组更新

    client 内部调用 UpdateItem 或 ListUpdateItem 接口进行记录修改,因此条件中必须给定主键,对于 List 表还必须给定 -index 的值。

    如: update user push gameids#[-1][$=123] where id = 1 and name = 'aka' and gameids not contains($=123);

5.4 Replace

  • 记录替换

    client 内部调用 Set 或 ListReplace 接口进行记录修改,对于 List 表还必须给定 -index 的值。

    如: replace into list_user (id, name, rank) values(1, 'aka', 100) where rank = 0 and -index = 0;

5.5 Delete

  • 记录删除

    client 内部调用 Del 或 ListDel 接口进行记录修改,因此条件中必须给定主键,对于List表还必须给定 -index 的值。

    如: delete from user where id = 1 and name = 'aka';

  • ListDelAll

    List 表,若不指定 -index,删除该主键下 List 的所有记录,但当前 ListDelAll 暂不支持条件过滤,因此条件中必须只有主键。

5.6 Query

  • 数组查询

    client 内部调用 Query 或 ListQuery 接口查询数组字段,因此条件中必须给定主键,对于List表还必须给定 -index 的值。

    如: query user get mailbox#[0 - -1][title = 'tcaplus'] where id = 1 and name = 'aka';


img

TcaplusDB是腾讯出品的分布式NoSQL数据库,存储和调度的代码完全自研。具备缓存+落地融合架构、PB级存储、毫秒级时延、无损水平扩展和复杂数据结构等特性。同时具备丰富的生态、便捷的迁移、极低的运维成本和五个九高可用等特点。客户覆盖游戏、互联网、政务、金融、制造和物联网等领域。

猜你喜欢

转载自blog.csdn.net/weixin_44545651/article/details/121476099