Table Store Go SDK 支援寬表模型、時序模型和訊息模型操作。
快速接入
快速接入Table Store Go SDK，完成環境準備、SDK 安裝和用戶端初始化。
準備環境
已安裝 Go 1.4 及以上版本。安裝包可從Go 官方下載頁擷取。
已安裝 Go 開發工具，例如 GoLand、Visual Studio Code（需安裝 Go 外掛程式）等。
安裝 SDK
在專案目錄中執行go mod init <DIRNAME>命令，產生 go.mod 檔案。然後執行如下命令安裝Table Store Go SDK。
<DIRNAME>為專案目錄路徑，以實際路徑為準。
go get github.com/aliyun/aliyun-tablestore-go-sdk/tablestoreTable Store Go SDK 提供樣本程式，涵蓋各資料模型的常見操作。可以解壓下載好的 SDK 包，在Table Store Go SDK倉庫的 sample 檔案夾中查看。
配置訪問憑證
為阿里雲帳號或RAM使用者建立AccessKey，並按如下方式將AccessKey配置到環境變數中。通過環境變數配置AccessKey可避免在代碼中寫入程式碼敏感資訊，提升安全性。
配置完成後請重啟或重新整理編譯運行環境，包括IDE、命令列介面、其它傳統型應用程式及後台服務，確保最新的系統內容變數成功載入。更多訪問憑證類型，請參見配置訪問憑證。
Linux
在命令列介面執行以下命令來將環境變數設定追加到
~/.bashrc檔案中。echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrc執行以下命令使變更生效。
source ~/.bashrc執行以下命令檢查環境變數是否生效。
echo $TABLESTORE_ACCESS_KEY_ID echo $TABLESTORE_ACCESS_KEY_SECRET
macOS
在終端中執行以下命令，查看預設 Shell 類型。
echo $SHELL根據預設 Shell 類型進行操作。
Zsh
執行以下命令來將環境變數設定追加到
~/.zshrc檔案中。echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc執行以下命令使變更生效。
source ~/.zshrc執行以下命令檢查環境變數是否生效。
echo $TABLESTORE_ACCESS_KEY_ID echo $TABLESTORE_ACCESS_KEY_SECRET
Bash
執行以下命令來將環境變數設定追加到
~/.bash_profile檔案中。echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bash_profile echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bash_profile執行以下命令使變更生效。
source ~/.bash_profile執行以下命令檢查環境變數是否生效。
echo $TABLESTORE_ACCESS_KEY_ID echo $TABLESTORE_ACCESS_KEY_SECRET
Windows
CMD
在CMD中運行以下命令設定環境變數。
setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID" setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"重啟CMD後，運行以下命令，檢查環境變數是否生效。
echo %TABLESTORE_ACCESS_KEY_ID% echo %TABLESTORE_ACCESS_KEY_SECRET%
PowerShell
在PowerShell中運行以下命令。
[Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", "YOUR_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User) [Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", "YOUR_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)運行以下命令，檢查環境變數是否生效。
[Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User) [Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)
初始化用戶端
初始化用戶端後，通過列舉執行個體下的資料表和時序表驗證串連是否正常。
新建立的執行個體預設未啟用公網訪問功能。如需通過公網訪問執行個體中的資源，在執行個體的網絡管理中開啟公網訪問。
寬表模型
package main
import (
"fmt"
"os"
"github.com/aliyun/aliyun-tablestore-go-sdk/tablestore"
)
func main() {
// yourInstanceName 填寫您的執行個體名稱
instanceName := "yourInstanceName"
// yourEndpoint 填寫您的執行個體訪問地址
endpoint := "yourEndpoint"
// 擷取環境變數裡的 AccessKey ID 和 AccessKey Secret
accessKeyId := os.Getenv("TABLESTORE_ACCESS_KEY_ID")
accessKeySecret := os.Getenv("TABLESTORE_ACCESS_KEY_SECRET")
// 初始化Table Store用戶端
client := tablestore.NewClient(endpoint, instanceName, accessKeyId, accessKeySecret)
// 列出執行個體中的資料表列表並列印到控制台
tables, err := client.ListTable()
if err != nil {
fmt.Println("Failed to list table")
} else {
for _, table := range (tables.TableNames) {
fmt.Println(table)
}
}
}時序模型
package main
import (
"fmt"
"os"
"github.com/aliyun/aliyun-tablestore-go-sdk/tablestore"
)
func main() {
// yourInstanceName 填寫您的執行個體名稱
instanceName := "yourInstanceName"
// yourEndpoint 填寫您的執行個體訪問地址
endpoint := "yourEndpoint"
// 擷取環境變數裡的 AccessKey ID 和 AccessKey Secret
accessKeyId := os.Getenv("TABLESTORE_ACCESS_KEY_ID")
accessKeySecret := os.Getenv("TABLESTORE_ACCESS_KEY_SECRET")
// 初始化Table Store用戶端
client := tablestore.NewTimeseriesClient(endpoint, instanceName, accessKeyId, accessKeySecret)
// 列出執行個體下的時序表列表並列印到控制台
timeseriesTables, err := client.ListTimeseriesTable()
if err != nil {
fmt.Println("Failed to list table")
} else {
for _, timeseriesTablesMeta := range (timeseriesTables.GetTimeseriesTableMeta()) {
fmt.Println(timeseriesTablesMeta.GetTimeseriesTableName())
}
}
}版本相容性
當前最新版本為 1.17.x，新版本對歷史版本均相容。
SDK 版本變更記錄請參見Go SDK歷史迭代版本。
常見問題
相關文檔
如需瞭解Table Store的錯誤處理方式，請參見錯誤處理。