全部產品
Search
文件中心

Tablestore:Go SDK

更新時間:Jun 28, 2025

Table Store Go SDK 支援寬表模型、時序模型和訊息模型操作。

功能列表

使用 SDK 的功能之前,您需要初始化 Client。Go SDK 支援的功能明細請參見下表。

說明

關於訊息模型的更多資訊,請參見訊息模型

寬表模型

功能類型

功能操作

描述資訊

資料表操作

建立資料表

建立一個資料表用於資料存放區。您可以在建立資料表時配置資料加密和主鍵列自增

更新表配置

更新資料表的配置資訊,例如資料生命週期、最大版本數等。

列出資料表

查看一個執行個體下的所有表名稱。

查詢表資訊

查詢表的配置資訊。

刪除資料表

刪除一個指定表。

資料操作

寫入資料

向Table Store的資料表寫入資料,寫入方式包括單行寫入、單行更新和批量寫入。

讀取資料

從Table Store的資料表讀取資料,讀取方式包括單行讀取、批量讀取、範圍讀取等。

刪除資料

刪除Table Store資料表中的資料,刪除方式包括單行刪除和大量刪除。

過濾器

在服務端對讀取結果再進行一次過濾,根據過濾器(Filter)中的條件決定返回的行。使用過濾器後,只返回合格資料行。

條件更新

只有在資料滿足更新條件的情況下才能對錶中資料進行更新,否則資料更新失敗並給使用者報錯。

原子計數器

將列當成一個原子計數器使用,對該列進行原子計數操作。

局部事務

為資料表開啟局部事務後,建立資料範圍在一個分區索引值內的局部事務用於資料讀寫操作。對局部事務中的資料進行讀寫操作後,您可以根據實際情況提交或者丟棄局部事務。

多元索引

建立多元索引

為資料表建立一個多元索引。

列出多元索引列表

列出指定表下的多元索引。

更新多元索引配置

更新多元索引的資料生命週期。

查詢多元索引描述資訊

查詢多元索引的描述資訊,包括多元索引的欄位資訊和索引配置等。

刪除多元索引

刪除不需要的多元索引。

生命週期管理

按需清理多元索引中的歷史資料或者延長資料儲存時間。

基礎查詢

基礎查詢類型包括全匹配查詢精確查詢多詞精確查詢首碼查詢萬用字元查詢範圍查詢列存在性查詢摺疊(去重)地理位置查詢巢狀型別查詢

多條件組合查詢

查詢條件支援包含一個或者多個子查詢條件,根據子查詢條件來判斷資料是否滿足查詢條件。

排序和翻頁

使用多元索引查詢資料時,您可以按照指定相片順序擷取到返回資料;當返回結果行數較多時,通過使用跳轉翻頁或者連續翻頁可以快速定位到所需資料。

統計彙總

可以實現求最小值、求最大值、求和、求平均值、統計行數、去重統計行數、按欄位值分組、按範圍分組、按地理位置分組、按過濾條件分組等操作;同時多個統計彙總功能可以組合使用,滿足複雜的查詢需求。

全文檢索索引

Tablestore提供了匹配查詢短語匹配查詢,以實現全文檢索索引功能。查詢時會根據分詞情況匹配資料,並支援通過摘要與高亮功能來高亮顯示查詢詞。

向量檢索

向量檢索(KnnVectorQuery)使用數值向量進行近似最近鄰查詢,可以在大規模資料集中找到最相似的資料項目。

並發匯出資料

當不關心整個結果集的順序時,可以使用並發匯出資料功能以更快的速度將命中的資料全部返回。

二級索引

建立二級索引

為資料表建立一個二級索引。

使用二級索引讀取資料

使用單行讀取和範圍讀取的方式查詢索引表中資料。如果所需屬性列已包含在索引表中,可以直接從索引表讀取,否則需要尋找資料表以擷取相關資料。

刪除二級索引

刪除資料表中指定的二級索引。

通道服務

建立通道

為資料表建立一個通道用於即時資料消費。

擷取表內的通道資訊

列舉某個資料表內所有通道的具體資訊,例如通道名稱、通道類型、通道ID、通道所處階段、資料是否超期等。

擷取通道的具體資訊

擷取某個通道內的具體資訊,例如通道資訊、通道內的Channel資訊等。

刪除通道

刪除資料表的一個通道。

SQL查詢

建立映射關係

為已存在的表或者索引建立映射關係。

更新映射表屬性列

為已存在的映射表添加或刪除屬性列。

刪除映射表

刪除映射關係。

列出映射表名稱列表

列出當前資料庫中的映射表列表。

查詢表的描述資訊

查詢表的描述資訊,例如欄位名稱、欄位類型等。

查詢索引描述資訊

查詢表的索引描述資訊。

查詢資料

查詢表中的資料。

擷取時間類型資料

使用SQL語句查詢到時間類型(包括Datetime、Date和Time)資料後,您可以根據實際需要擷取具體資料。

資料湖投遞

建立投遞任務

建立一個投遞任務用於將Table Store資料表中的資料投遞到OSS Bucket中儲存。

列出投遞任務名稱

出資料表所有的投遞任務資訊,例如資料表名稱、投遞任務名稱、投遞任務類型。

查詢投遞任務描述資訊

查詢投遞任務描述資訊。

刪除投遞任務

刪除一個投遞任務。

時序模型

功能類型

具體功能

描述資訊

時序表操作

建立時序表

建立一個時序表用於時序資料存放區。

更新時序表

更新時序表或時間軸中繼資料配置。

列出時序表名稱

查看執行個體中所有時序表的名稱及其配置資訊。

查詢時序表描述資訊

查詢時序表描述資訊,例如資料生命週期TTL配置等。

刪除時序表

刪除一個時序表。

時序資料操作

寫入時序資料

寫入時序資料到時序表,可批量寫入。

查詢時序資料

查詢指定時間軸中合格時序資料。

時間軸操作

檢索時間軸

指定多種條件檢索時間軸資訊,例如度量名稱、資料來源資訊等。

更新時間軸

更新時間軸中繼資料,支援批次更新。

刪除時間軸

刪除時間軸中繼資料,支援大量刪除。

時序分析儲存

建立分析儲存

為已存在的時序表建立分析儲存。

更新分析儲存的資料生命週期

更新時序分析儲存的資料生命週期TTL配置。更新分析儲存的TTL後,Tablestore會自動非同步清理分析儲存中超過TTL的資料。

查詢分析儲存描述資訊

查詢分析儲存描述資訊,例如資料生命週期配置、資料同步選項、資料同步狀態、資料存放區大小等。

刪除分析儲存

刪除時序表下的分析儲存。

Lastpoint索引

建立Lastpoint索引

為時序表建立一個Lastpoint索引用於快速檢索各時間軸的最新時間點資料。

查詢Lastpoint索引資料

查詢Lastpoint索引資料。

檢索Lastpoint索引

通過多元索引來檢索Lastpoint索引資料。多元索引可以加速Lastpoint索引的資料檢索,並提供多維查詢和統計分析功能。

刪除Lastpoint索引

刪除一個Lastpoint索引。

SQL查詢

建立映射關係

為已存在的表或者索引建立映射關係。

更新映射表屬性列

為已存在的映射表添加或刪除屬性列。

刪除映射表

刪除映射關係。

列出映射表名稱列表

列出當前資料庫中的映射表列表。

查詢表的描述資訊

查詢表的描述資訊,例如欄位名稱、欄位類型等。

查詢索引描述資訊

查詢表的索引描述資訊。

查詢資料

查詢表中的資料。

版本相容性

當前最新版本為1.17.x版本,新版本對之前歷史版本均相容。

關於SDK版本迭代的更多資訊,請參見Go SDK歷史迭代版本

相關文檔

如需瞭解Table Store的錯誤處理方式,請參見錯誤處理