Python-SDK的单行数据操作

表格存储的 SDK 提供了 PutRow、GetRow、UpdateRow 和 DeleteRow 等单行操作的接口。

插入一行数据（PutRow）


插入数据到指定的行。

接口"""
        说明：写入一行数据。返回本次操作消耗的CapacityUnit。
        ``table_name``是对应的表名。
        ``row``是行数据，包括主键和属性列。
        ``condition``表示执行操作前做条件检查，满足条件才执行，是tablestore.metadata.Condition类的实例。目前只支持对行的存在性进行检查，检查条件包括：'IGNORE'，'EXPECT_EXIST'和'EXPECT_NOT_EXIST'。
        ``return_type``表示返回类型，是tablestore.metadata.ReturnType类的实例，目前仅支持返回PrimaryKey，一般用于主键列自增中。
        返回：本次操作消耗的CapacityUnit和需要返回的行数据。
        ``consumed``表示消耗的CapacityUnit，是tablestore.metadata.CapacityUnit类的实例。
        ``return_row``表示返回的行数据，可能包括主键、属性列。
        """
        def put_row(self, table_name, row, condition = None, return_type = None)




示例


插入一行数据。 ## 主键的第一个主键列是gid，值是整数1，第二个主键列是uid，值是整数101。
    primary_key = [('gid',1), ('uid',101)]
    ## 属性列包括四个：
    ##                        第一个属性列的名字是name，值是字符串John，版本没有指定，使用系统当前时间作为版本号。
    ##                        第二个属性列的名字是mobile，值是整数15100000000，版本没有指定，使用系统当前时间作为版本号。
    ##                        第三个属性列的名字是address，值是二进制的China，版本没有指定，使用系统当前时间作为版本号。
    ##                        第四个属性列的名字是age，值是29.7，版本号为1498184687。
    attribute_columns = [('name','John'), ('mobile',15100000000),('address', bytearray('China')),('female', False), ('age', 29.7, 1498184687000)]
    ## 通过primary_key和attribute_columns构造Row
    row = Row(primary_key, attribute_columns)
    # 行条件检查为：期望行不存在。如果行存在就会报错：Condition Update Failed。
    condition = Condition(RowExistenceExpectation.EXPECT_NOT_EXIST)
    try :
        # 调用put_row方法，如果没有指定ReturnType，则return_row为None。
        consumed, return_row = client.put_row(table_name, row, condition)
        # 打印出此次请求消耗的写CU。
        print ('put row succeed, consume %s write cu.' % consumed.write)
    # 客户端异常，一般为参数错误或者网络异常。
    except OTSClientError as e:
        print "get row failed, http_status:%d, error_message:%s" % (e.get_http_status(), e.get_error_message())
    # 服务端异常，一般为参数错误或者流控错误。
    except OTSServiceError as e:
        print "get row failed, http_status:%d, error_code:%s, error_message:%s, request_id:%s" % (e.get_http_status(), e.get_error_code(), e.get_error_message(), e.get_request_id())

提示：

• 
  RowExistenceExpectation.IGNORE 表示不管此行是否已经存在，都会插入新数据，如果之前有会被覆盖。
• 
  RowExistenceExpectation.EXPECT_EXIST 表示只有此行存在时，才会插入新数据，此时，原有数据也会被覆盖。
• 
  RowExistenceExpectation.EXPECT_NOT_EXIST 表示只有此行不存在时，才会插入数据，否则不执行。
• 上述示例程序中属性列age的版本为1498184687000，这个值2017年06月23日，如果当前时间 - max_time_deviation（创建表时指定）大于1498184687000值，则PutRow的时候会被禁止。
• 
  若执行成功，则不会抛异常，否则会抛异常。
• 
  详细代码：PutRow@GitHub。

• 
  查询一行数据时，默认返回这一行所有列的数据。如果想只返回特定行，可以通过 columns_to_get 参数限制。如果将 col0 和 col1 加入到 columns_to_get 中，则只返回 col0 和 col1 的值。
• 
  详细代码：GetRow@GitHub。