您的位置:首页 > 其它

[TcaplusDB知识库]TcaplusDB客户端及常用命令

2021-05-29 11:26 465 查看

数据库大都支持命令行访问,TcaplusDB也不例外,通过安装TcaplusDB客户端,您可以方便快捷地从命令行管理与访问数据库。

TcaplusDB客户端

首先在 TcaplusServiceApi3.36下载最新的TcaplusDB API 3.36程序包并解压该文件,该步骤应在安装TcaplusDB应用程序的同一VPC中的CVM上执行所有操作。安装客户端命令如下:

# 解压TcaplusDB API包
tar -zxvf TcaplusServiceApi3.36.0.192960.x86_64_release_20200115.tar.gz

# 重命名TcaplusDB目录
mv TcaplusServiceApi3.36.0.192960.x86_64_release_20200115 TcaplusDBServiceApi3.0

# 找到TcaplusDB客户端
cd TcaplusDBServiceApi3.0/release/x86_64/bin

# 连接TcaplusDB应用
./tcaplus_client -a {APP ID} -z {ZONE ID} -s {TcaplusDB PASSWORD} -d {Tcapdir IP}:{Tcapdir PORT}

# 例子:
./tcaplus_client -a 21 -z 1 -s "Changeme12" -d 10.0.0.2:9999

上述命令中TcaplusDB_client连接参数获取方式如下:

1) 在腾讯云打开表控制台,进入集群列表页面, 从页面获取Tcapdir IP(对应: Private Address/内网地址), Tcapdir PORT(对应:Private Port/内网端口),获取Zone ID (对应页面 : Table Group ID/表格组ID) 。

2) 点击上述截图的集群ID,进入应用详情页面, 获取 APP ID(对应: Access ID/接入ID), 以及TcaplusDB password(对应:Connection Password/连接密码)。 具体截图如下所示:

TcaplusDB客户端命令

TcaplusDB提供了一种类似SQL的查询语言,使您能像使用关系数据库一样操作TcaplusDB表。

命令含义 
desc {table name} 描述表字段  
count {table_name} 返回表记录数目  
clean {table_name} 清空(truncate)表, 此操作高度敏感,需要开白使用  
select 查询表记录,示例: select * from BattleInfo where game_id = 100 and area_id=200 \G; \G标记符类似MySQL命令行格式化查询输出  
update 更新表记录,若该记录不存在,则会插入该条记录,示例: update BattleInfo set player_number = 10 where game_id = 100 and area_id=200;  
delete 删除1条或多条记录,where语句需指定全部主键字段或索引字段。示例: delete from BattleInfo where game_id = 100 and area_id=200;  
dump 遍历表并将数据导出到文本文件,示例:dump * from BattleInfo into BattleInfo.csv;  
load 从文本文件导入数据到表,示例:load BattleInfo from BattleInfo.csv;  

注意: 使用tcaplus_client在操作PB类型(protobuf)的表时有一些限制,如下所示:

  • load: 不支持, 预计Q2支持;

    select:部分不支持,预计Q2支持,如下:

    基于索引字段作为where查询条件暂不支持;
  • select *不支持显示嵌套字段的值, 需要用点分模式指定嵌套字段才行如select pay.amount from …;
  • update: 部分不支持,对于repeated类型的字段无法用update 更新插入;
  • insert: 暂不支持, 可用update替代,预计Q2支持。

  • 您可以通过运行help或help +命令获得更多的TcaplusDB语法。 请注意,上表中未列出的命令正在逐步淘汰或不建议使用。

    tcaplus_client命令支持详情:

    tcaplus_client命令帮助示例:

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

    内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
    标签: