|-- C++_common_for_pb2 # Directory of sample common header files
|-- C++_pb2_asyncmode_simpletable # Sample simple PB table in async mode
|-- C++_pb2_coroutine_simpletable # Sample simple PB table in coroutine mode
Preparing environment
1. Please make sure that you have enabled the TcaplusDB service in the TcaplusDB Console and obtained the corresponding application information (such as the AppId, ZoneId, and AppKey).
2. Decompress the dependency package and install the dependencies. This document uses the TSF4G_BASE-2.7.28.164975_Win64Vc14Mt_Release.zip dependency package as an example. You should download an appropriate dependency package here as needed.
Supposing the root path for installation is D:\\Tencent\\tsf4gMT, relevant files will be installed under the D:\\Tencent\\tsf4gMT\\win64vc14MT path.
3.1. First, make sure that you have successfully created a table in the target application by using table_test.proto.
3.2. Run the proto_generate.cmd script and generate the dependent files under the current path.
table_test.pb.cc
table_test.pb.h
3.3. Open the project file pb_co_set.sln in Microsoft Visual Studio 2015.
3.4. Generate the solution.
3.5. If no errors occur, an executable file pb_co_set.exe will be generated under the examples\\tcaplus\\C++_pb2_coroutine_simpletable\\SingleOperation\\set/x64 path.
Testing
1. Copy the pb_co_set.exe and tlogconf.xml files into the same directory.
2. Switch to the administrator role and use cmd.exe or powershell.exe to run the executable file pb_co_set.exe.
3. Check the output.
4. For detailed running information, please check the log file tcaplus_pb.log.
5. To run the *_crypto sample code, please make sure that the libcrypto-1_1-x64.dll file is in the OpenSSL compilation directory under the system path.
TcaplusDB PB API Command List
TcaplusDB PB API provides various types of operations and supports async and coroutine modes. You can find the corresponding usage in the sample code. The list of TcaplusDB PB API commands are as shown below:
Command
Description
SET
Sets record by specifying all its primary keys. If the record already exists, an overwrite operation will be performed; otherwise, an insert operation will be performed.
GET
Queries record by specifying all its primary keys in TcaplusDB PB table. If the record does not exist, an error will be returned.
ADD
Inserts record by specifying all its primary keys. If the record already exists, an error will be returned.
DELETE
Deletes record by specifying all its primary keys. If the record does not exist, an error will be returned.
BATCHGET
Queries multiple records by specifying multiple set of primary keys in TcaplusDB PB table.
TRAVERSE
Traverses TcaplusDB PB table. Multiple records will be returned.
FIELDGET
Queries record by specifying all its primary keys in TcaplusDB PB table. This operation queries and transfers only the values of specified fields, which reduces the network transfer traffic. If the record does not exist, an error will be returned.
FIELDSET
Sets specified fields by specifying all primary keys of record. Only the values of specified fields will be transferred, which reduces the network traffic. If the data record already exists, an update operation will be performed; otherwise, an error will be returned.
FIELDINC
Auto-increments specified fields by specifying all primary keys of record. This command supports only fields in int32, int64, uint32, and uint64 types. It is similar to FIELDSET.
GETBYPARTKEY
Queries multiple eligible data entries by specifying certain primary keys. The specified primary key set must have an index created when the table is created; otherwise, an error will be returned.
