TableStoreClient是Tablestore服務的用戶端,它為調用者提供了一系列的方法,可以用來動作表、讀寫單行資料、讀寫多行資料等。如果要使用時序模型,您需要初始化TimeseriesClient。
確定Endpoint
Endpoint是阿里雲Tablestore服務在各個地區的網域名稱地址,您可以通過以下方式查詢Endpoint:
说明 關於Endpoint的更多資訊,請參見服務地址。
配置密鑰
要接入阿里雲的Tablestore服務,您需要擁有一個有效存取金鑰進行簽名認證。目前支援下面三種方式:
- 阿里雲帳號的AccessKey ID和AccessKey Secret。建立步驟如下:
- 在阿里雲官網註冊阿里雲帳號。
- 建立AccessKey ID和AccessKey Secret。具體操作,請參見擷取AccessKey。
- 被授予訪問Tablestore許可權RAM使用者的AccessKey ID和AccessKey Secret。建立步驟如下:
- 使用阿里雲帳號前往存取控制RAM,建立一個新的RAM使用者或者使用已經存在的RAM使用者。
- 使用阿里雲帳號授予RAM使用者訪問Tablestore的許可權。
- RAM使用者被授權後,即可使用自己的AccessKey ID和AccessKey Secret訪問。
- 從STS擷取的臨時訪問憑證。擷取步驟如下:
- 應用的伺服器通過訪問RAM/STS服務,擷取一個臨時的AccessKey ID、AccessKey Secret和SecurityToken發送給使用方。
- 使用方使用上述臨時密鑰訪問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")