表格存储 .NET SDK 写入单行数据 - 表格存储

本文介绍如何通过 .NET SDK 在表格存储的数据表中写入单行数据。

前提条件

方法说明

public PutRowResponse PutRow(PutRowRequest request)

异步方法：

public Task<PutRowResponse> PutRowAsync(PutRowRequest request)

PutRowRequest参数说明

名称	类型	说明
tableName（必选）	string	数据表名称。
primaryKey（必选）	PrimaryKey	主键信息，包括主键列名称和主键值。主键列数据类型包括 STRING、INTEGER 和 BINARY。主键个数和类型必须与数据表的主键保持一致。
columns（可选）	AttributeColumns	属性列信息，包括属性列名称、属性列值和数据版本号。属性列数据类型包括 STRING、INTEGER、BINARY、DOUBLE 和 BOOLEAN。数据版本号即时间戳，默认由系统自动生成，也可以自己指定，详情请参见数据版本和生命周期。
condition（必选）	Condition	写入条件，详情请参见条件更新。

示例代码

以下示例代码在 test_table 表中写入一行数据，该行数据的主键值为 row1。

try
{
    // 构造主键
    PrimaryKey primaryKey = new PrimaryKey
    {
        { "id", new ColumnValue("row1") }
    };
    // 写入行数据时必须配置写入条件 （RowExistenceExpectation.IGNORE，表示不做行存在性判断）
    Condition condition = new Condition(RowExistenceExpectation.IGNORE);

    // 调用 PutRow 方法写入行数据
    PutRowRequest putRowRequest = new PutRowRequest("test_table", condition, primaryKey, null);
    PutRowResponse putRowResponse = client.PutRow(putRowRequest);
    Console.WriteLine($"* RequestId: {putRowResponse.RequestID}");
    Console.WriteLine($"* Read CU Cost: {putRowResponse.ConsumedCapacityUnit.Read}");
    Console.WriteLine($"* Write CU Cost: {putRowResponse.ConsumedCapacityUnit.Write}");
}
catch (Exception ex)
{
    Console.WriteLine($"Put row failed, exception: {ex.Message}");
}

添加属性列。

AttributeColumns columns = new AttributeColumns
{
    { "col1", new ColumnValue("val1") }
};

// 构建 PutRowRequest
PutRowRequest putRowRequest = new PutRowRequest("test_table", condition, primaryKey, columns);

表格存储：写入单行数据

前提条件

方法说明

示例代码

相关文档