OTSClient是Tablestore服務的用戶端,它為調用者提供了一系列的方法,可以用來動作表、讀寫單行資料、讀寫多行資料等。

確定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服務。

初始化對接

擷取到AccessKey ID和AccessKey Secret後,您可以按照下如下步驟進行初始化對接。

  • 介面
        /// <summary>
        /// OTSClient的建構函式。
        /// </summary>
        /// <param name="endPoint">OTS服務的地址(例如'https://instance.cn-hangzhou.ots.aliyun.com:80'),必須以'https://'開頭。</param>
        /// <param name="accessKeyID">OTS的Access Key ID,通過官方網站申請。</param>
        /// <param name="accessKeySecret">OTS的Access Key Secret,通過官方網站申請。</param>
        /// <param name="instanceName">OTS執行個體名,通過官方網站控制台建立。</param>
    public OTSClient(string endPoint, string accessKeyID, string accessKeySecret, string instanceName);
    
        /// <summary>
        /// 通過用戶端配置OTSClientConfig的執行個體來建立OTSClient執行個體。
        /// </summary>
        /// <param name="config">用戶端配置執行個體</param>
        public OTSClient(OTSClientConfig config);
                        
  • 樣本
    说明
    • OTSClientConfig中還可以設定ConnectionLimit。如果不設定,預設值為300。
    • OTSClientConfig中的OTSDebugLogHandler和OTSErrorLogHandler控制日誌行為,可以自訂。
    • OTSClientConfig中的RetryPolicy控制重試邏輯,目前有預設重試策略,也可以自訂重試策略。
        // 構造一個OTSClientConfig對象。
        var config = new OTSClientConfig(Endpoint, AccessKeyId, AccessKeySecret, InstanceName);
    
        // 禁止輸出日誌,預設是開啟的。
        config.OTSDebugLogHandler = null;
        config.OTSErrorLogHandler = null;
    
        // 使用OTSClientConfig建立一個OtsClient對象。
        var otsClient = new OTSClient(config);
    
        // 使用otsClient插入或者查詢資料。
                        

多線程

  • 支援多線程。
  • 使用多線程時,建議共用一個OTSClient對象。