随着信息技术的飞速发展,企业越来越依赖于信息化管理。尽管当前各种新的技术层出不穷,但大多数企业的业务数据依然主要存储在数据库中, 数据库是应用系统的基石,数据库中存储着大量的数据信息,数据库的稳定性、性能、扩展性,对业务的运营起着至关重要的作用。TcaplusDB作为腾讯自研的分布式NoSQL数据库,致力于帮助客户解决数据存储问题,为业务保驾护航。
以下为TcaplusDB常见入门问题(数据库使用类-1)
推荐您在代码里采用在 gameserver 里调用函数TcapErrCode::TcapErrCodeInit
和TcapErrCode::GetErrStr
函数来获取错误码,也可以本地搜索 TcaplusDB API 的头文件。
举个抢火车票例子:
排队执行调用函数SetCheckDataVersionPolicy
,其值包括:
CHECKDATAVERSION_AUTOINCREASE
:检测记录版本号,只有当该版本号与服务器端的版本号相同时,该版本号才会自增 。NOCHECKDATAVERSION_OVERWRITE
:不检测记录版本号,强制把客户端的记录版本号写入到服务器中。NOCHECKDATAVERSION_AUTOINCREASE
:不检测记录版本号,将服务器端的版本号自增。CHECKDATAVERSION_AUTOINCREASE
,推荐您使用。凡是存在1:N的使用场景,N < 1024时,优先考虑 list 表,例如存储玩家最近的100封邮件、最近的100场战斗记录等,list 表支持按照队头插入、队尾淘汰,队尾插入、队头淘汰,支持按照插入时间排序的 Top N 操作,单个 key 下的单元个数可以通过表变更修改大,因为需要兼容旧数据不能修改小。采用 listgetall 可以获取单个 key 下总的记录数目,推荐按照 offset 自己维护,limit 等于一定阈值的方式获取数据,listreplace、listdelete、listdeletebatch 时需要指定正确的 index。listaddafter 时需要指定单个 key 下的元素单元个数满时淘汰的规则,调用 SetListShiftFlag 函数设置所以 list 表有2个增加方向,2个获取方向,就是4种可能:
另外,调用GetRecordMatchCount
可以获取记录的总数。
insert 操作,当 key 不存在时会进行插入,当 key 存在时,会返回错误码:TcapErrCode::SVR_ERR_FAIL_RECORD_EXIST
。 replace 操作,当 key 不存在会进行插入,当 key 存在时,如果采用了乐观锁,则根据乐观锁的结果执行不同的操作,成功则进行替换,失败则返回错误码:TcapErrCode::SVR_ERR_FAIL_INVALID_VERSION;
如果没有采用乐观锁,直接替换。 update 操作,当 key 存在,如果采用了乐观锁,则根据乐观锁的结果执行不同的操作,成功则进行更新,失败则返回错误码:TcapErrCode::SVR_ERR_FAIL_INVALID_VERSION
,如果没有采用乐观锁,直接更新;如果key不存在时,则返回错误码:TcapErrCode::TXHDB_ERR_RECORD_NOT_EXIST
。
TcaplusDB API 接口里有 count 命令字,如果采用 tcaplus_client 可以采用 count 表名命令获取表的记录数目。
TcaplusDB 支持遍历操作,包括 generic 表、list 表的遍历操作,遍历时注意设置从 tcapsvr slave 上遍历数据(从 tcapsvr slave 上遍历数据,不会影响 tcapsvr master 对外提供服务),即接口:SetOnlyReadFromSlave(bool flag)
。