OTSClient是Tablestore服務的用戶端,它為調用者提供了一系列的方法,可以用來動作表、讀寫單行資料、讀寫多行資料等。
確定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服務。
初始化對接
擷取到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對象。