产品概述
产品优势
应用场景
产品架构
地域介绍
#创建 TcaplusRestClient 对象#endpoint: restful API, such as http://x.x.x.x:80client = TcaplusRestClient(endpoint, access_id, access_passwd)#SetTargetTable 指定想要访问的目标表client.SetTargetTable(table_group_id=1, table_name='game_players')#发送数据访问请求，以 AddRecord 为例record = {'player_id': 10805514, 'player_name': 'Calvin', 'player_email': 'calvin@test.com', 'game_server_id': 10,'login_timestamp': ['2019-12-12 15:00:00'], 'logout_timestamp': ['2019-12-12 16:00:00'], 'is_online': False, 'pay': {'pay_id': 10101, 'amount': 1000, 'method': 1}}status, resp = client.AddRecord(record, custom_headers=None, return_values=None, table_group_id=None, table_name=None)
table_group_id, table_name = client.GetTargetTable()
status, resp = client.AddRecord(record, custom_headers=None, return_values=None, table_group_id=1, table_name='game_players')
@param keys (必须) - 查询目标记录的主键字段(Primary key)字典@param select_fields (可选) - 返回结果中所包含的非主键字段名数组, 嵌套字段可以通过点分路径的方式指定@param custom_headers (可选) - 用户需要指定的 http header@param table_group_id (可选) - 表所在集群表格组 id@param table_name (可选) - 目标表 table_namedef GetRecord(self, keys, select_fields=[], custom_headers=None, table_group_id=None, table_name=None)
@param record (必须) - 待插入的目标记录 json 对象@param custom_headers (可选) - 用户需要指定的 http header@param table_group_id (可选) - 表所在集群表格组 id@param table_name (可选) - 目标表 table_namedef AddRecord(self, record, custom_headers=None, return_values=None, table_group_id=None, table_name=None)
@param record (必须) - 待设置的目标记录 json 对象，该操作包含插入和修改的语义@param custom_headers (可选) - 用户需要指定的 http header@param table_group_id (可选) - 表所在集群表格组 id@param table_name (可选) - 目标表 table_namedef SetRecord(self, record, custom_headers=None, return_values=None, table_group_id=None, table_name=None)
@param record (必须) - 待删除的目标记录 json 对象，可以只需要设置主键字段@param custom_headers (可选) - 用户需要指定的 http header@param table_group_id (可选) - 表所在集群表格组 id@param table_name (可选) - 目标表 table_namedef DeleteRecord(self, record, custom_headers=None, return_values=None, table_group_id=None, table_name=None)
@param keys (必须) - 查询目标记录的主键字段(Primary key)字典@param select_fields (必须) - 返回结果中所包含的非主键字段名数组，嵌套字段可以通过点分路径的方式指定@param custom_headers (可选) - 用户需要指定的 http header@param table_group_id (可选) - 表所在集群表格组 id@param table_name (可选) - 目标表table_namedef FieldGetRecord(self, keys, select_fields, custom_headers=None, table_group_id=None, table_name=None)
@param record (必须) - 待设置的目标记录 json 对象，该操作包含插入和修改的语义@param field_path (必须) - 待设置的字段名(路径)数组, 嵌套字段可以通过点分路径的方式指定@param custom_headers (可选) - 用户需要指定的 http header@param table_group_id (可选) - 表所在集群表格组 id@param table_name (可选) - 目标表 table_namedef FieldSetRecord(self, record, field_path, custom_headers=None, return_values=None, table_group_id=None, table_name=None)
@param record (必须) - 待自增、自减的记录，必须保证记录中包含主键，待自增、自减的记录必须是整数类型@param custom_headers (可选) - 用户需要指定的 http header@param table_group_id (可选) - 表所在集群表格组 id@param table_name (可选) - 目标表 table_namedef FieldIncRecord(self, record, custom_headers=None, return_values=None, table_group_id=None, table_name=None)
@param index_keys (必须) - 查询目标记录的索引键字典@param index_name (必须) - 查询的索引名称@param select_fields (可选) - 返回结果中所包含的非主键字段名数组, 嵌套字段可以通过点分路径的方式指定@param custom_headers (可选) - 用户需要指定的 http header@param table_group_id (可选) - 表所在集群表格组 id@param table_name (可选) - 目标表 table_name@param limit (可选) -限制返回的记录条数@param offset (可选) -设定返回记录数的起始偏移量def PartkeyGetRecord(self, index_keys, index_name, select_fields=[], custom_headers=None, table_group_id=None, table_name=None, limit=None, offset=None)
256KB, limit 的设置依赖于单条记录大小。推荐设置策略：#索引键情况{'player_id': 39775502, 'player_name': 'Sara'}#请求不设置 limit 和 offset，响应包如下{u'ErrorCode': 0, u'ErrorMsg': u'Succeed', u'MultiRecords': [{u'RecordVersion': 1, u'Record': {u'logout_timestamp': [u'2019-12-12 16:00:00'], u'player_name': u'Sara', u'login_timestamp': [u'2019-12-12 15:00:00'], u'pay': {u'amount': 100, u'pay_id': 1, u'method': 1}, u'game_server_id': 1, u'player_email': u'sara@test.com', u'is_online': True, u'player_id': 39775502}}, {u'RecordVersion': 1, u'Record': {u'logout_timestamp': [u'2019-12-12 16:10:00'], u'player_name': u'Sara', u'login_timestamp': [u'2019-12-12 15:10:00'], u'pay': {u'amount': 200, u'pay_id': 2}, u'game_server_id': 2, u'player_email': u'sara@163.com', u'is_online': True, u'player_id': 39775502}}, {u'RecordVersion': 1, u'Record': {u'logout_timestamp': [u'2019-12-12 16:20:00'], u'player_name': u'Sara', u'login_timestamp': [u'2019-12-12 15:20:00'], u'pay': {u'amount': 300, u'pay_id': 3, u'method': 1}, u'game_server_id': 3, u'player_email': u'sara@gmail.com', u'is_online': True, u'player_id': 39775502}}], u'RemainNum': 0, u'TotalNum': 3}#请求设置 limit 和 offset, 其中 limit 设置为2，响应包如下{u'ErrorCode': 0, u'ErrorMsg': u'Succeed', u'MultiRecords': [{u'RecordVersion': 1, u'Record': {u'logout_timestamp': [u'2019-12-12 16:00:00'], u'player_name': u'Sara', u'login_timestamp': [u'2019-12-12 15:00:00'], u'pay': {u'amount': 100, u'pay_id': 1, u'method': 1}, u'game_server_id': 1, u'player_email': u'sara@test.com', u'is_online': True, u'player_id': 39775502}}, {u'RecordVersion': 1, u'Record': {u'logout_timestamp': [u'2019-12-12 16:10:00'], u'player_name': u'Sara', u'login_timestamp': [u'2019-12-12 15:10:00'], u'pay': {u'amount': 200, u'pay_id': 2}, u'game_server_id': 2, u'player_email': u'sara@163.com', u'is_online': True, u'player_id': 39775502}}], u'RemainNum': 1, u'TotalNum': 3}
RemainNum和TotalNum这两个标识来判断数据是否获取完全。Was this page helpful?
You can also Contact sales or Submit a Ticket for help.
Help us improve! Rate your documentation experience in 5 mins.
Feedback