Tablestore:Tablestore クライアントの初期化

アクセスするインスタンスに関する情報の取得

• リージョン ID: インスタンスのリージョン ID。 たとえば、中国 (杭州) のリージョン ID は cn-hangzhou です。

• インスタンス名と エンドポイント: 各 Tablestore インスタンスには一意のエンドポイントがあります。アプリケーションは、テーブルとデータに対する操作を実行するためにエンドポイントを指定する必要があります。エンドポイントを取得するには、次の操作を実行します。

  1. Tablestore コンソールにログインします。

  2. 上部のナビゲーションバーで、リソースグループとリージョンを選択します。

  3. [概要] ページで、インスタンスのエイリアスをクリックするか、[アクション] 列の [インスタンスの管理] をクリックします。

  4. [インスタンス詳細] タブで、インスタンス名とエンドポイントを表示します。

     重要

     デフォルトでは、新しいインスタンスではインターネットアクセスが無効になっています。インターネット経由でインスタンス内のリソースにアクセスするには、インスタンスのインターネットアクセスを有効にする必要があります。

Tablestore SDK for Go のインストール

プロジェクトディレクトリで go mod init <DIRNAME> コマンドを実行して go.mod ファイルを生成します。次に、次のコマンドを実行して Tablestore SDK for Go をインストールします。

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

Tablestore SDK のインストールの詳細については、「Tablestore SDK のインストール」をご参照ください。

アクセス認証情報の構成

Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ペアを作成し、その AccessKey ペアを環境変数として構成します。

Wide Column モデル

次のサンプルコードは、クライアントを初期化し、インスタンス内のデータテーブルのリストをクエリし、そのリストをコンソールに表示する方法の例を示しています。

package main

import (
	"fmt"
	"os"
	"github.com/aliyun/aliyun-tablestore-go-sdk/tablestore"
)

func main() {
	// インスタンスの名前を指定します。
	instanceName := "yourInstanceName"
	// インスタンスのエンドポイントを指定します。
	endpoint := "yourEndpoint"
	// 環境変数から AccessKey ID と AccessKey secret を取得します。
	accessKeyId := os.Getenv("TABLESTORE_ACCESS_KEY_ID")
	accessKeySecret := os.Getenv("TABLESTORE_ACCESS_KEY_SECRET")

	// Tablestore クライアントを初期化します。
	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() {
	// インスタンスの名前を指定します。
	instanceName := "yourInstanceName"
	// インスタンスのエンドポイントを指定します。
	endpoint := "yourEndpoint"
	// 環境変数から AccessKey ID と AccessKey secret を取得します。
	accessKeyId := os.Getenv("TABLESTORE_ACCESS_KEY_ID")
	accessKeySecret := os.Getenv("TABLESTORE_ACCESS_KEY_SECRET")

	// Tablestore クライアントを初期化します。
	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())
        }
    }
}