基础数据操作
表格存储的基础数据操作包括数据的写入、读取和删除。本文介绍Go SDK的数据操作方式和适用场景。
写入数据
用于向数据表中写入数据。写入方式包括单行插入、单行更新或者批量写入。写入数据时支持自定义数据版本号以及使用条件更新功能配置数据写入条件。更多信息,请参见写入数据。
写入方式 | 说明 | 适用场景 |
写入单行数据 | 调用 PutRow 接口新写入一行数据。 | 适用于写入少量数据的场景。 |
更新单行数据 | 调用 UpdateRow 接口更新一行数据。 | 适用于更新少量数据的场景。 |
批量写入数据 | 调用 BatchWriteRow 接口在一次请求中进行批量写入操作或者一次对多张表进行写入。 | 适用于增删改大量数据或者同时需要进行数据增删改操作的场景。 |
读取数据
用于从数据表中读取数据。查询方式包括单行读取、批量读取、范围读取、迭代读取和并发读取。读取数据时支持配置返回指定的列、使用过滤器功能过滤行数据以及配置返回指定版本范围或者指定版本号的数据。更多信息,请参见读取数据。
查询方式 | 说明 | 适用场景 |
读取单行数据 | 调用GetRow接口读取一行数据。 | 适用于能确定完整主键且要读取行数较少的场景。 |
批量读取数据 | 调用BatchGetRow接口一次请求读取多行数据或者一次对多张表进行读取。 BatchGetRow操作由多个GetRow子操作组成,构造子操作的过程与使用GetRow接口时相同。 | 适用于能确定完整主键,且需要读取行数较多或者要读取多个表中数据的场景。 |
范围读取数据 | 调用GetRange接口读取一个范围内的数据。 GetRange操作支持按照确定范围进行正序读取和逆序读取,可以设置要读取的行数。如果范围较大,已扫描的行数或者数据量超过一定限制,会停止扫描,并返回已获取的行和下一个主键信息。您可以根据返回的下一个主键信息,继续发起请求,获取范围内剩余的行。 | 适用于能确定完整主键范围或者主键前缀的场景。 |
删除数据
用于删除数据表中的数据。删除方式包括单行删除或者批量删除。删除数据时支持使用条件更新功能配置数据删除条件。更多信息,请参见删除数据。
删除方式 | 说明 | 适用场景 |
删除单行数据 | 调用DeleteRow接口删除一行数据。如果删除的行不存在,则不会发生任何变化。 | 适用于删除少量数据的场景。 |
批量删除数据 | 获取到要删除数据的主键信息后,根据主键信息批量删除数据。 | 适用于删除大量数据的场景。 |