tencent cloud

游戏数据库 TcaplusDB

产品动态
产品简介
产品概述
产品优势
应用场景
产品架构
地域介绍
购买指南
产品定价
欠费说明
快速入门
了解基本概念
创建集群
创建表格组
创建表格
获取连接信息
访问 TcaplusDB
操作指南
管理集群与表格组
管理表格
监控与告警
访问管理
标签
任务列表
使用 TcaplusDB client
使用 client 工具访问数据
client 工具命令参考
使用 TcaplusDB SDK
变更历史
SDK 下载
SDK for C++ 接口说明
TcaplusDB 错误码
SDK 安装
PB 表 C++SDK 操作方法
TDR 表 C++SDK 操作方法
使用 TcaplusDB RESTful API
RESTful API 接口说明
Go RESTful API 接口说明
Java RESTful API 接口说明
PHP RESTful API 接口说明
Python RESTful API 接口说明
RESTful API 各语言示例下载
实践教程
表结构设计
数据库交互
常见问题
信息咨询类
数据库使用类
数据库原理类
API 文档
History
Introduction
API Category
Making API Requests
Table Group APIs
Other APIs
Table APIs
Cluster APIs
Data Types
Error Codes
相关协议
服务等级协议
服务条款
词汇表
联系我们

Linux 安装手册

PDF
聚焦模式
字号
最后更新时间: 2024-12-04 10:02:30

操作场景

本文档指导您在 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 安装,安装方法如下:
1. 准备云服务器环境。 首先需要准备安装了 CentOS6- x86_64 或 CentOS7-x86_64 版本操作系统的服务器。为了编译构建 Protobuf,需要安装以下软件,安装方法请自行查询:
autoconf
automake
libtool
curl (used to download gmock)
make
g++
unzip
2. 下载 Protobuf 源码安装包,请参见 SDK 下载
3. 请根据实际需求安装指定版本的 ProtoBuf,下文以 protobuf 2.6.1 版本为例。
4. 执行以下命令,解压源码安装包,并进入源码根目录下。
tar -xzvf protobuf-2.6.1.tar.gz
cd ./protobuf-2.6.1
5. Configure 并指定安装路径前缀,推荐安装到路径/usr/local/protobuf下。
./configure --prefix=/usr/local/protobuf
6. 编译并安装。
make
make check
make install
7. 测试,使用 protoc 命令查看是否安装成功。如下所示,即表示安装成功。
# protoc --version
libprotoc 2.6.1

操作步骤

步骤1:安装 TcaplusDB SDK

首先将 TcaplusDB SDK 下载至开发服务器,然后执行命令将文件安装至指定安装目录。
tar –xzf <安装包路径> -C <安装目录>

步骤2:校验

安装完成后,根目录结构如下表所示:
目录及文件
说明
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 应用示例

步骤3:运行 example 访问 TcaplusDB

GameSvr 游戏服务器中对应数据访问逻辑的开发,可以参考 example 中的各接口示例。
1. 解压 TcaplusDB PB API 发布包。
tar -xzvf TcaplusPbApi3.36.0.152096.x86_64_release_20170712.tar.gz
2. 配置 TcaplusDB 系统连接信息。
2.1 在命令行输入如下代码进入目录:
cd TcaplusPbApi3.36.0.152096.x86_64_release_20170712/release/x86_64/examples/tcaplus/C++_common_for_pb2
2.2 在命令行输入 vi common.h 修改 common.h 头文件,根据业务情况修改如下图片内容。 DIR_URL_ARRAY:集群访问 IP 地址和端口号。 DIR_URL_COUNT:固定值,保持为1即可。 TABLE_NAME:需要访问的目标表。 APP_ID:需要访问的接入 ID。 ZONE_ID:填写需要访问的表格组 ID。 SIGNATURE:集群访问密码。

3. 修改环境配置文件。 在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 目录的绝对路径,如下图:

4. 设置环境变量,在代码目录下执行如下命令:
source envcfg.env
bash conv.sh
5. 编译二进制程序。 执行make命令编译 example 二进制,编译成功生成 mytest 可执行文件。

6. 执行二进制程序。 在命令行输入./mytest ,执行二进制程序。执行结果将在命令行标准输出中显示,若遇到错误,请查看代码目录下的 tcaplus_pb.log 日志文件。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈