TableStoreClient是Tablestore服務的用戶端,它為調用者提供了一系列的方法,可以用來動作表、讀寫單行資料、讀寫多行資料等。如果要使用時序模型,您需要初始化TimeseriesClient。

確定Endpoint

Endpoint是阿里雲Tablestore服務在各個地區的網域名稱地址,您可以通過以下方式查詢Endpoint:

  1. 登入Tablestore控制台
  2. 單擊執行個體名稱進入執行個體詳情頁。
    執行個體訪問地址即是該執行個體的Endpoint。
说明 關於Endpoint的更多資訊,請參見服務地址

配置密鑰

要接入阿里雲的Tablestore服務,您需要擁有一個有效存取金鑰進行簽名認證。目前支援下面三種方式:

  • 阿里雲帳號的AccessKey ID和AccessKey Secret。建立步驟如下:
    1. 在阿里雲官網註冊阿里雲帳號
    2. 建立AccessKey ID和AccessKey Secret。具體操作,請參見擷取AccessKey
  • 被授予訪問Tablestore許可權RAM使用者的AccessKey ID和AccessKey Secret。建立步驟如下:
    1. 使用阿里雲帳號前往存取控制RAM,建立一個新的RAM使用者或者使用已經存在的RAM使用者。
    2. 使用阿里雲帳號授予RAM使用者訪問Tablestore的許可權。
    3. RAM使用者被授權後,即可使用自己的AccessKey ID和AccessKey Secret訪問。
  • 從STS擷取的臨時訪問憑證。擷取步驟如下:
    1. 應用的伺服器通過訪問RAM/STS服務,擷取一個臨時的AccessKey ID、AccessKey Secret和SecurityToken發送給使用方。
    2. 使用方使用上述臨時密鑰訪問Tablestore服務。

初始化TableStoreClient

擷取到AccessKey ID和AccessKey Secret後,您可以按照如下範例程式碼初始化TableStoreClient。

  • 介面
    //初始化``TableStoreClient``執行個體。
    //endPoint是Tablestore服務的地址(例如'https://instance.cn-hangzhou.ots.aliyun.com:80'),必須以'https://'或'http://'開頭。
    //accessKeyId是訪問Tablestore服務的AccessKeyID,通過官方網站申請或通過管理員擷取。
    //accessKeySecret是訪問Tablestore服務的AccessKeySecret,通過官方網站申請或通過管理員擷取。
    //instanceName是要訪問的執行個體名,通過官方網站控制台建立或通過管理員擷取。
    func NewClient(endPoint, instanceName, accessKeyId, accessKeySecret string, options ...ClientOption) *TableStoreClient                   
  • 樣本
    client = tablestore.NewClient("your_instance_endpoint",  "your_instance_name", "your_user_id", "your_user_key")          

初始化TimeseriesClient

擷取到AccessKey ID和AccessKey Secret後,您可以按照如下範例程式碼初始化TimeseriesClient。

  • 介面
    //初始化``TimeseriesClient``執行個體。
    //endPoint是Tablestore服務的地址(例如'https://instance.cn-hangzhou.ots.aliyun.com:80'),必須以'https://'或'http://'開頭。
    //accessKeyId是訪問Tablestore服務的AccessKeyID,通過官方網站申請或通過管理員擷取。
    //accessKeySecret是訪問Tablestore服務的AccessKeySecret,通過官方網站申請或通過管理員擷取。
    //instanceName是要訪問的執行個體名,通過官方網站控制台建立或通過管理員擷取。
    func NewTimeseriesClient(endPoint, instanceName, accessKeyId, accessKeySecret string , options ...TimeseriesClientOption) *TimeseriesClient
  • 樣本
    timeseriesClient = tablestore.NewTimeseriesClient("your_instance_endpoint",  "your_instance_name", "your_user_ak_id", "your_user_ak_key")