初始化Tablestore Client

获取实例信息

• 地域ID：实例所在地域的ID，例如华东1（杭州）的地域ID为cn-hangzhou。

• 实例名称和访问地址：每个表格存储实例对应一个访问地址（Endpoint），应用程序进行表和数据操作时需要指定访问地址，获取方式如下。

  1. 登录表格存储控制台。

  2. 在页面上方，选择资源组和地域。

  3. 在概览页面，单击实例别名或在操作列单击实例管理。

  4. 在实例详情页签，查看实例的名称和访问地址。

     重要

     新创建的实例默认未启用公网访问功能。如果您需要通过公网访问实例中的资源，则必须开启实例的公网访问功能。

安装Tablestore SDK

在项目目录中执行go mod init <DIRNAME>命令生成go.mod文件后，执行如下命令安装表格存储Go SDK。

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

更多关于安装Tablestore SDK的信息，请参见安装Tablestore SDK。

配置访问凭证

使用Tablestore SDK发起请求访问表格存储，您需要配置访问凭证，阿里云服务会通过访问凭证验证您的身份信息和访问权限。

本文以阿里云账号的AccessKey为例为您介绍如何配置访问凭证。AccessKey的获取方式，请参见如何获取AccessKey。

直接在代码中保存访问凭证容易导致信息泄露，建议您将访问凭证保存在系统环境变量中。

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

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

更多关于配置访问凭证的信息，请参见配置访问凭证。

宽表模型

以下示例代码用于初始化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")

	// 初始化表格存储客户端
	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")

	// 初始化表格存储客户端
	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())
        }
    }
}