.NET-SDK的单行数据操作

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

插入一行数据（PutRow）


插入数据到指定的行。

接口/// <summary>
        /// 指定表名、主键和属性，写入一行数据。返回本次操作消耗的CapacityUnit。
        /// </summary>
        /// <param name="request">插入数据的请求</param>
        /// <returns>本次操作消耗的CapacityUnit</returns>
        public PutRowResponse PutRow(PutRowRequest request);
        /// <summary>
        /// PutRow的异步形式。
        /// </summary>
        public Task<PutRowResponse> PutRowAsync(PutRowRequest request);




示例 1


插入一行数据。 // 定义行的主键，必须与创建表时的TableMeta中定义的一致
        var primaryKey = new PrimaryKey();
        primaryKey.Add("pk0", new ColumnValue(0));
        primaryKey.Add("pk1", new ColumnValue("abc"));
        // 定义要写入该行的属性列
        var attribute = new AttributeColumns();
        attribute.Add("col0", new ColumnValue(0));
        attribute.Add("col1", new ColumnValue("a"));
        attribute.Add("col2", new ColumnValue(true));
        try
        {
            // 构造插入数据的请求对象，RowExistenceExpectation.IGNORE表示不管此行是否存在都执行
            var request = new PutRowRequest("SampleTable", new Condition(RowExistenceExpectation.IGNORE),
                                    primaryKey, attribute);
            // 调用PutRow接口插入数据
            otsClient.PutRow(request);
            // 如果没有抛出异常，则说明执行成功
            Console.WriteLine("Put row succeeded.");
        }
        catch (Exception ex)
        {
            // 如果抛出异常，则说明执行失败，打印出错误信息
            Console.WriteLine("Put row failed, exception:{0}", ex.Message);
        }

提示：

• 
  Condition.IGNORE、Condition.EXPECT_EXIST 和 Condition.EXPECT_NOT_EXIST 从 3.0.0 版本开始被废弃，请替换为 new Condition (RowExistenceExpectation.IGNORE)、new Condition (RowExistenceExpectation.EXPECT_EXIST) 和 new Condition (RowExistenceExpectation.EXPECT_NOT_EXIST)。
• 
  RowExistenceExpectation.IGNORE 表示不管此行是否已经存在，都会插入新数据，如果之前有会被覆盖。
• 
  RowExistenceExpectation.EXPECT_EXIST 表示只有此行存在时，才会插入新数据，此时，原有数据也会被覆盖。
• 
  RowExistenceExpectation.EXPECT_NOT_EXIST 表示只有此行不存在时，才会插入数据，否则不执行。
• 
  从 2.2.0 版本开始，Condition 不仅支持行条件，也支持列条件。
• 
  详细代码：PutRow@GitHub。

• 
  条件不仅支持单个条件，也支持多个条件组合。例如，col1 大于 5 且 pk2 小于’xyz’时插入数据。
• 
  属性列和主键列都支持条件。
• 
  当条件中的列在某行不存在时，可以通过 RelationCondition 中的 PassIfMissing 控制，默认是 true。
• 
  详细代码：ConditionPutRow@GitHub。

• 
  每一个异步调用都会启动一个线程，如果连续启动了很多异步调用，且每个都耗时比较大的时候，可能会出现超时。
• 
  详细代码：PutRowAsync@GitHub。

• 
  查询一行数据时，默认返回这一行所有列的数据。如果想只返回特定行，可以通过 columnsToGet 参数限制。如果将 col0 和 col1 加入到 columnsToGet 中，则只返回 col0 和 col1 的值。
• 
  查询时也支持按条件过滤，比如当 col0 的值大于 24 时才返回结果。
• 
  当 columnsToGet 和 condition 同时使用时，顺序是 columnsToGet 先生效，然后再去返回的列中进行过滤。
• 
  当某列不存在时的行为，可以通过 PassIfMissing 控制。
• 
  详细代码：GetRow@GitHub。

• 
  更新一行数据也支持条件语句。
• 
  详细代码：UpdateRow@GitHub。

• 
  删除一行数据也支持条件语句。
• 
  详细代码：DeleteRow@GitHub。