【TcaplusDB知识库】下载使用TcaplusDB Client

湛蓝之海

【TcaplusDB知识库】下载使用TcaplusDB Client
tcaplus_client 是一个 TcaplusDB 表访问的客户端工具，C++编写，可以用于从命令行管理TcaplusDB。目前工具集成在C++ SDK中.

下载

Client	版本	下载地址
TcaplusPbApi3.36.0.192960.x86_64_release_20200115.tar.gz	3.36.0	​​下载​​
TcaplusPbApi3.46.0.199506.x86_64_release_20211129.tar.gz	3.46.0	​​下载​​

安装
下载完成 TcaplusServiceApi 安装包后，将其上传至可与 TcaplusDB网络联通的服务器中。
上传完成后，执行下列命令解压安装包。

mkdir tcaplus && tar -xf TcaplusPbApi3.46.0.199506.x86_64_release_20211129.tar.gz -C tcaplus

解压完成后，进入至 tcaplus 的 bin 目录中，并赋予可执行权限：

cd tcaplus/release/x86_64/bin chmod +x tcaplus_client

直接执行​​./tcaplus_client​​命令，会提示连接数据库所需的参数信息，用户可以根据自己的集群信息进行填写。

注意：下文示例中，app_id 代表业务 ID、zone_id 代表游戏区ID。

# ./tcaplus_client

--------------------------------------------------------------------------------

invalid parameters, please start the client as following:

./tcaplus_client -a access_id -z tablegroup_id [-s signature] -d dir_server_url [-t table_name] [-l log_file.xml] [-T tdr_file.tdr] [-e execute_command].

the params in [] are optional, and their order is not important.

-a(--app_id)  APP_ID or Access ID of Cluster.

-z(--zone_id)  ZONE ID or TableGroup Id.

-s(--signature)  PASSWORD.

-d(--dir)  dir server addr.

-t(--table)  table to add.

-l(--log)  log file name that must be client_log.xml, and log class name be client.

-T(--tdr)  tdr filename.

-e(--execute)  SQL command need to execute, the content should be in quotes.

e.g. ./tcaplus_client -a 2 -z 3 -s "FE6533875C8385C3" -d 172.25.40.181:9999 -T table_test.tdr -e "select a, b from table where key = 1;".

连接 TcaplusDB
使用命令连接 TcaplusDB，如下示例中，访问点信息如下:

• 业务ID：3 (集群接入ID)
  
• 连接密码：****(集群/业务访问密码)
  
• 内网地址:内网端口：10.125.32.21:9999
  
• 游戏区ID：1 (表格组id)
  

# ./tcaplus_client -a 2 -z 3 -s 51BD7E6215D6F0BE -d 9.135.8.93:9999

====== Welcome to use tcaplus_client, use "help" to show usage ======

tcaplus>

在提示符之后输入 help，可看到进一步的帮助信息，通过 ​​> help 具体命令​​ 可以查看具体使用方法。

tcaplus> help;

--------------------------------------------------------------------------------

help: show usage of commands, example: "help select;".

show: get server status related information. executing "help show;" for details.

exit/quit: exit the client.

count: print record number in the database.

desc: print table field name and type.

select: query records from database.

insert: insert a new record into database.

replace: replace a record into the database.

update: update a record in the database.

delete: delete record(s) from database.

dump: dump records from database.

load: load records into the database.

--------------------------------------------------------------------------------

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