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

数据库大都支持命令行访问，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级存储、毫秒级时延、无损水平扩展和复杂数据结构等特性。同时具备丰富的生态、便捷的迁移、极低的运维成本和五个九高可用等特点。客户覆盖游戏、互联网、政务、金融、制造和物联网等领域。