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