Go初始化Tablestore Client - Tablestore

Tablestore Client是Tablestore的用戶端，它提供了一系列的方法，可以用來操作Tablestore的表和資料。本文介紹如何在Go中進行Tablestore Client的初始化。

重要

本文以阿里雲帳號的AccessKey為例為您介紹如何初始化Tablestore Client，如果您想使用RAM使用者的存取金鑰或STS臨時訪問憑證進行初始化，請參見使用RAM使用者存取金鑰訪問Table Store和使用STS臨時訪問憑證訪問Table Store。

準備工作

初始化Tablestore Client前，您需要擷取執行個體的相關資訊、安裝Tablestore SDK並配置訪問憑證。

擷取執行個體資訊

地區ID：執行個體所在地區的ID，例如華東1（杭州）的地區ID為cn-hangzhou。
執行個體名稱和訪問地址：每個Tablestore執行個體對應一個訪問地址（Endpoint），應用程式進行表和資料操作時需要指定訪問地址，擷取方式如下。
1. 登入Table Store控制台。
2. 在頁面上方，選擇資源群組和地區。
3. 在概覽頁面，單擊執行個體別名或在操作列單擊執行個體管理。
4. 在執行個體詳情頁簽，查看執行個體的名稱和訪問地址。
  重要
  新建立的執行個體預設未啟用公網訪問功能。如果您需要通過公網訪問執行個體中的資源，則必須開啟執行個體的公網訪問功能。

安裝Tablestore SDK

在專案目錄中執行go mod init <DIRNAME>命令產生go.mod檔案後，執行如下命令安裝TablestoreGo SDK。

說明

<DIRNAME>為專案目錄路徑，請以實際路徑為準。

go get github.com/aliyun/aliyun-tablestore-go-sdk/tablestore

更多關於安裝Tablestore SDK的資訊，請參見安裝Tablestore SDK。

配置訪問憑證

使用Tablestore SDK發起請求訪問Tablestore，您需要配置訪問憑證，阿里雲服務會通過訪問憑證驗證您的身份資訊和存取權限。

本文以阿里雲帳號的AccessKey為例為您介紹如何配置訪問憑證。AccessKey的擷取方式，請參見如何擷取AccessKey。

直接在代碼中儲存訪問憑證容易導致資訊泄露，建議您將訪問憑證儲存在系統內容變數中。

Windows

以管理員身份運行命令提示字元，執行以下命令。

# 配置 AccessKey ID
setx TABLESTORE_ACCESS_KEY_ID your_access_key_id /m
# 配置 AccessKey Secret
setx TABLESTORE_ACCESS_KEY_SECRET your_access_key_secret /m

macOS/Linux/Unix

# 配置 AccessKey ID
export TABLESTORE_ACCESS_KEY_ID=your_access_key_id
# 配置 AccessKey Secret
export TABLESTORE_ACCESS_KEY_SECRET=your_access_key_secret

更多關於配置訪問憑證的資訊，請參見配置訪問憑證。

初始化Client

您需要先初始化一個Client，然後調用該Client的方法來訪問Tablestore服務。TablestoreGo SDK提供了寬表模型用戶端和時序模型用戶端。

寬表模型

以下範例程式碼用於初始化Client，擷取執行個體中的所有資料表名稱並列印到控制台。

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)
        }
    }
}

時序模型

以下範例程式碼用於初始化Client，擷取執行個體中的所有時序表名稱並列印到控制台。

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())
        }
    }
}

Tablestore：初始化Tablestore Client