表格存储提供了单行插入、单行更新和批量写入的写入方式用于写入数据到数据表。当要写入数据到数据表时，您需要指定完整主键以及要增删改的属性列。在高并发应用中写入数据时，您可以配置行存在性条件或者列条件实现按照指定条件更新数据。
如果需要了解表格存储各场景的应用案例，请参见快速玩转Tablestore入门与实战。
前提条件
已初始化Client，详情请参见初始化Client。
已创建数据表并写入数据。
插入单行数据
调用PutRow接口新写入一行数据。如果该行已存在，则先删除原行数据（原行的所有列以及所有版本的数据），再写入新行数据。
接口
/**
* 插入数据到指定的行，如果该行不存在，则新增一行；如果该行存在，则覆盖原有行。
*/
putRow(params, callback)参数
参数 | 说明 |
tableName | 数据表名称。 |
primaryKey | 行的主键。主键包括主键列名、主键类型和主键值。 重要
|
condition | 使用条件更新，可以设置原行的存在性条件或者原行中某列的列值条件。更多信息，请参见条件更新。 说明
|
attributeColumns | 行的属性列。每一项的顺序是属性名、属性类型（可选）、属性值、时间戳（可选）。
|
returnContent | 表示返回类型。 returnType：设置为TableStore.ReturnType.Primarykey，表示返回主键值，主要用于主键列自增场景。 |
示例
以下示例用于插入一行数据。
var TableStore = require('../index.js');
var Long = TableStore.Long;
var client = require('./client');
var currentTimeStamp = Date.now();
var params = {
tableName: "sampleTable",
condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null),
primaryKey: [{ 'gid': Long.fromNumber(20013) }, { 'uid': Long.fromNumber(20013) }],
attributeColumns: [
{ 'col1': '表格存储' },
{ 'col2': '2', 'timestamp': currentTimeStamp },
{ 'col3': 3.1 },
{ 'col4': -0.32 },
{ 'col5': Long.fromNumber(123456789) }
],
returnContent: { returnType: TableStore.ReturnType.Primarykey }
};
client.putRow(params, function (err, data) {
if (err) {
console.log('error:', err);
return;
}
console.log('success:', data);
});详细代码请参见PutRow@GitHub。
更新单行数据
调用UpdateRow接口更新一行数据，可以增加和删除一行中的属性列，删除属性列指定版本的数据，或者更新已存在的属性列的值。如果更新的行不存在，则新增一行数据。
当UpdateRow请求中只包含删除指定的列且该行不存在时，则该请求不会新增一行数据。
接口
/**
* 更新指定行的数据。如果该行不存在，则新增一行；如果该行存在，则根据请求的内容在此行中新增、修改或者删除指定列的值。
*/
updateRow(params, callback)参数
参数 | 说明 |
tableName | 数据表名称。 |
primaryKey | 行的主键。 重要 设置的主键个数和类型必须和数据表的主键个数和类型一致。 |
condition | 使用条件更新，可以设置原行的存在性条件或者原行中某列的列值条件。更多信息，请参见条件更新。 |
updateOfAttributeColumns | 更新的属性列。
|
示例
以下示例用于更新一行数据。
var TableStore = require('../index.js');
var Long = TableStore.Long;
var client = require('./client');
var params = {
tableName: "sampleTable",
condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null),
primaryKey: [{ 'gid': Long.fromNumber(9) }, { 'uid': Long.fromNumber(90) }],
updateOfAttributeColumns: [
{ 'PUT': [{ 'col4': Long.fromNumber(4) }, { 'col5': '5' }, { 'col6': Long.fromNumber(6) }] },
{ 'DELETE': [{ 'col1': Long.fromNumber(1496826473186) }] },
{ 'DELETE_ALL': ['col2'] }
]
};
client.updateRow(params,
function (err, data) {
if (err) {
console.log('error:', err);
return;
}
console.log('success:', data);
}); 详细代码请参见UpdateRow@GitHub。
批量写入数据
调用BatchWriteRow接口在一次请求中进行批量写入操作或者一次对多张表进行写入。
BatchWriteRow操作由多个PutRow、UpdateRow、DeleteRow子操作组成，构造子操作的过程与使用PutRow接口、UpdateRow接口和DeleteRow接口时相同。
BatchWriteRow的各个子操作独立执行，表格存储会分别返回各个子操作的执行结果。
注意事项
由于批量写入可能存在部分行失败的情况，失败行的Index及错误信息在返回的BatchWriteRowResponse中，但并不抛出异常。因此调用BatchWriteRow接口时，需要检查返回值，判断每行的状态是否成功；如果不检查返回值，则可能会忽略掉部分操作的失败。
当服务端检查到某些操作出现参数错误时，BatchWriteRow接口可能会抛出参数错误的异常，此时该请求中所有的操作都未执行。
BatchWriteRow操作单次支持写入的最大行数为200行，且所有行的数据量总和不能超过4 MB。
接口
/**
* 对多个数据表中的多行数据进行增加、删除或者更新操作。
*/
batchWriteRow(params, callback)参数
本操作是PutRow、UpdateRow、DeleteRow的组合。
增加了数据表的层级结构，可以一次处理多个数据表。
tables以数据表为单位组织，后续为各个数据表的操作，设置需要写入、修改或删除的行信息。
增加了type参数，用于区分操作类型。
操作类型可以为PUT、UPDATE、DELETE。
当操作类型为PUT或UPDATE时，primaryKey和attributeColumns有效。
当操作类型为DELETE时，primaryKey有效。
示例
以下示例用于批量写入数据。
var client = require('./client');
var TableStore = require('../index.js');
var Long = TableStore.Long;
var params = {
tables: [
{
tableName: 'sampleTable',
rows: [
{
type: 'UPDATE',
condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null),
primaryKey: [{ 'gid': Long.fromNumber(20010) }, { 'uid': Long.fromNumber(20010) }],
attributeColumns: [{ 'PUT': [{ 'col1': 'test3' }, { 'col2': 'test4' }] }],
returnContent: { returnType: 1 }
},
{
type: 'PUT',
condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null),
primaryKey: [{ 'gid': Long.fromNumber(20020) }, { 'uid': Long.fromNumber(20020) }],
attributeColumns: [{ 'col1': 'test1' }, { 'col2': 'test2' }],
returnContent: { returnType: TableStore.ReturnType.Primarykey }
},
{
type: 'DELETE',
condition: new TableStore.Condition(TableStore.RowExistenceExpectation.IGNORE, null),
primaryKey: [{ 'gid': Long.fromNumber(20018) }, { 'uid': Long.fromNumber(20018) }],
}
]
}
],
};
client.batchWriteRow(params, function (err, data) {
if (err) {
console.log('error:', err);
return;
}
console.log('success:', data);
}); 详细代码请参见BatchWriteRow@GitHub。