表格存储 Go SDK 支持宽表模型、时序模型和消息模型操作。
功能列表
使用 SDK 的功能之前，您需要初始化 Client。Go SDK 支持的功能明细请参见下表。
关于消息模型的更多信息，请参见消息模型。
宽表模型
功能类型 | 功能操作 | 描述信息 |
创建一个数据表用于数据存储。您可以在创建数据表时配置数据加密和主键列自增。 | ||
当要落盘加密表中数据时，您可以在创建数据表时配置数据加密。 | ||
更新数据表的配置信息，例如数据生命周期、最大版本数等。 | ||
查看一个实例下的所有表名称。 | ||
查询表的配置信息。 | ||
删除一个指定表。 | ||
向表格存储的数据表写入数据，写入方式包括单行写入、单行更新和批量写入。 | ||
从表格存储的数据表读取数据，读取方式包括单行读取、批量读取、范围读取等。 | ||
删除表格存储数据表中的数据，删除方式包括单行删除和批量删除。 | ||
在服务端对读取结果再进行一次过滤，根据过滤器（Filter）中的条件决定返回的行。使用过滤器后，只返回符合条件的数据行。 | ||
只有在数据满足更新条件的情况下才能对表中数据进行更新，否则数据更新失败并给用户报错。 | ||
将列当成一个原子计数器使用，对该列进行原子计数操作。 | ||
为数据表开启局部事务后，创建数据范围在一个分区键值内的局部事务用于数据读写操作。对局部事务中的数据进行读写操作后，您可以根据实际情况提交或者丢弃局部事务。 | ||
为数据表创建一个多元索引。 | ||
列出指定表下的多元索引。 | ||
更新多元索引的数据生命周期。 | ||
查询多元索引的描述信息，包括多元索引的字段信息和索引配置等。 | ||
删除不需要的多元索引。 | ||
按需清理多元索引中的历史数据或者延长数据保存时间。 | ||
基础查询类型包括全匹配查询、精确查询、多词精确查询、前缀查询、通配符查询、范围查询、列存在性查询、折叠（去重）、地理位置查询和嵌套类型查询。 | ||
查询条件支持包含一个或者多个子查询条件，根据子查询条件来判断数据是否满足查询条件。 | ||
使用多元索引查询数据时，您可以按照指定排列方式获取到返回数据；当返回结果行数较多时，通过使用跳转翻页或者连续翻页可以快速定位到所需数据。 | ||
可以实现求最小值、求最大值、求和、求平均值、统计行数、去重统计行数、按字段值分组、按范围分组、按地理位置分组、按过滤条件分组等操作；同时多个统计聚合功能可以组合使用，满足复杂的查询需求。 | ||
表格存储提供了匹配查询和短语匹配查询，以实现全文检索功能。查询时会根据分词情况匹配数据，并支持通过摘要与高亮功能来高亮显示查询词。 | ||
向量检索（KnnVectorQuery）使用数值向量进行近似最近邻查询，可以在大规模数据集中找到最相似的数据项。 | ||
当不关心整个结果集的顺序时，可以使用并发导出数据功能以更快的速度将命中的数据全部返回。 | ||
为数据表创建一个二级索引。 | ||
使用单行读取和范围读取的方式查询索引表中数据。如果所需属性列已包含在索引表中，可以直接从索引表读取，否则需要查找数据表以获取相关数据。 | ||
删除数据表中指定的二级索引。 | ||
为数据表创建一个通道用于实时数据消费。 | ||
列举某个数据表内所有通道的具体信息，例如通道名称、通道类型、通道ID、通道所处阶段、数据是否超期等。 | ||
获取某个通道内的具体信息，例如通道信息、通道内的Channel信息等。 | ||
删除数据表的一个通道。 | ||
为已存在的表或者索引创建映射关系。 | ||
为已存在的映射表添加或删除属性列。 | ||
删除映射关系。 | ||
列出当前数据库中的映射表列表。 | ||
查询表的描述信息，例如字段名称、字段类型等。 | ||
查询表的索引描述信息。 | ||
查询表中的数据。 | ||
使用SQL语句查询到时间类型（包括Datetime、Date和Time）数据后，您可以根据实际需要获取具体数据。 | ||
创建一个投递任务用于将表格存储数据表中的数据投递到OSS Bucket中存储。 | ||
出数据表所有的投递任务信息，例如数据表名称、投递任务名称、投递任务类型。 | ||
查询投递任务描述信息。 | ||
删除一个投递任务。 |
时序模型
功能类型 | 具体功能 | 描述信息 |
创建一个时序表用于时序数据存储。 | ||
更新时序表或时间线元数据配置。 | ||
查看实例中所有时序表的名称及其配置信息。 | ||
查询时序表描述信息，例如数据生命周期TTL配置等。 | ||
删除一个时序表。 | ||
写入时序数据到时序表，可批量写入。 | ||
查询指定时间线中符合条件的时序数据。 | ||
指定多种条件检索时间线信息，例如度量名称、数据源信息等。 | ||
更新时间线元数据，支持批量更新。 | ||
删除时间线元数据，支持批量删除。 | ||
为已存在的时序表创建分析存储。 | ||
更新时序分析存储的数据生命周期TTL配置。更新分析存储的TTL后，表格存储会自动异步清理分析存储中超过TTL的数据。 | ||
查询分析存储描述信息，例如数据生命周期配置、数据同步选项、数据同步状态、数据存储大小等。 | ||
删除时序表下的分析存储。 | ||
为时序表创建一个Lastpoint索引用于快速检索各时间线的最新时间点数据。 | ||
查询Lastpoint索引数据。 | ||
通过多元索引来检索Lastpoint索引数据。多元索引可以加速Lastpoint索引的数据检索，并提供多维查询和统计分析功能。 | ||
删除一个Lastpoint索引。 | ||
为已存在的表或者索引创建映射关系。 | ||
为已存在的映射表添加或删除属性列。 | ||
删除映射关系。 | ||
列出当前数据库中的映射表列表。 | ||
查询表的描述信息，例如字段名称、字段类型等。 | ||
查询表的索引描述信息。 | ||
查询表中的数据。 |
版本兼容性
当前最新版本为1.17.x版本，新版本对之前历史版本均兼容。
关于SDK版本迭代的更多信息，请参见Go SDK历史迭代版本。
相关文档
如需了解表格存储的错误处理方式，请参见错误处理。