本文档指导您在 Linux 系统环境下安装和使用 TcaplusDB PB 表。
Linux 2.6、Suse 12 64 位。
安装和使用 TcaplusDB PB 前需安装 Protobuf,TcaplusDB 当前支持 Protocol Buffers 2.6.1 版本以及3.5.0版本。
Protobuf 是 Google 推出的一种混合语言数据标准,是一种轻便的结构化数据存储格式。TcaplusDB 系统支持使用 Protobuf 格式定义文件(.proto)定义数据表。使用 TcaplusDB PB API 之前,需要在开发服务器上安装 Protobuf,推荐使用源代码进行 Protobuf 安装,安装方法如下:
tar -xzvf protobuf-2.6.1.tar.gz
cd ./protobuf-2.6.1
/usr/local/protobuf
下。./configure --prefix=/usr/local/protobuf
make
make check
make install
# protoc --version
libprotoc 2.6.1
首先将 TcaplusDB SDK 下载至开发服务器,然后执行命令将文件安装至指定安装目录。
tar –xzf <安装包路径> -C <安装目录>,
安装完成后,根目录结构如下表所示:
目录及文件 | 说明 |
---|---|
include/tcaplus_service/ | TCAPLUS 服务化 API 头文件 |
lib/libtcaplusserviceapi.a | TCAPLUS 服务化 API 库文件 |
include/tcaplus_service/protobuf/ | Protobuf API 头文件 |
lib/libtcaplusprotobufapi.a | TCAPLUS Protobuf API 库文件 |
examples/tcaplus/ProtoBuf | TCAPLUS Protobuf API 应用示例 |
GameSvr 游戏服务器中对应数据访问逻辑的开发,可以参考 example 中的各接口示例。
tar -xzvf TcaplusPbApi3.36.0.152096.x86_64_release_20170712.tar.gz
cd TcaplusPbApi3.36.0.152096.x86_64_release_20170712/release/x86_64/examples/tcaplus/C++_common_for_pb2
TcaplusPbApi3.36.0.152096.x86_64_release_20170712/release/x86_64/examples/tcaplus
目录下有分别通过异步方式以及协程方式调用 API 的示例,此处以协程方式调用 Set 接口设置数据为例:cd TcaplusPbApi3.18.0.152096.x86_64_release_20170712/release/x86_64/examples/tcaplus/C++_pb2_coroutine_simpletable/SingleOperation/set
协程方式 Set 示例的所有代码都在该目录中。修改 envcfg.env 文件,将 PROTOBUF_HOME 环境变量设置为本机 protobuf 的安装路径(--prefix指定),并将 TCAPLUS_HOME 环境变量设置为 Tcaplus PB API 包下 release/x86_64 目录的绝对路径,如下图:source envcfg.env
bash conv.sh
make
命令编译 example 二进制,编译成功生成 mytest 可执行文件。./mytest
,执行二进制程序。执行结果将在命令行标准输出中显示,若遇到错误,请查看代码目录下的 tcaplus_pb.log 日志文件。
本页内容是否解决了您的问题?