Node.js SDK初始化OTSClient - Tablestore

Client是Table Store服務的用戶端，它為調用者提供了一系列的方法，可以用來動作表、單行資料、多行資料等。使用.NET SDK發起請求，您需要初始化一個Client執行個體，並根據需要修改ClientConfig的預設配置項。

準備工作

初始化Client前，您需要完成擷取執行個體Endpoint、安裝TablestoreNode.js SDK和配置訪問憑證的準備工作。

擷取執行個體Endpoint

建立執行個體後，您需要擷取執行個體網域名稱地址（Endpoint）用於後續通過Endpoint訪問執行個體。

Endpoint是阿里雲Tablestore服務各個執行個體的網域名稱地址，例如https://sun.cn-hangzhou.ots.aliyuncs.com，表示使用HTTPS協議通過公網網路訪問華東1（杭州）地區的sun執行個體。更多資訊，請參見服務地址。

如果未開通Tablestore服務，請進行開通。具體操作，請參見開通Table Store服務。
建立執行個體。具體操作，請參見建立執行個體。
建立執行個體後擷取執行個體的Endpoint。
1. 登入Table Store控制台。
2. 在概覽頁面，單擊執行個體名稱。
3. 在執行個體詳情頁簽的執行個體訪問地址地區即可查看該執行個體的服務地址（Endpoint）。

安裝TablestoreNode.js SDK

具體操作，請參見安裝Table StoreNode.js SDK。

配置訪問憑證

要接入阿里雲的Tablestore服務，您需要擁有一個有效存取金鑰進行簽名認證。具體操作，請參見配置訪問憑證。

初始化OTSClient

使用Tablestore的SDK時，您必須首先構造一個Client，通過調用該Client的介面來訪問Tablestore服務。

樣本

警告

阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡，否則可能導致AccessKey泄露，威脅您帳號下所有資源的安全。本樣本以將AccessKey、SecurityToken儲存在環境變數中來實現身分識別驗證為例介紹。

使用AK初始化

說明

運行本程式碼範例之前，請確保已設定環境變數OTS_AK_ENV和OTS_SK_ENV。更多資訊，請參見配置訪問憑證。

var accessKeyId = process.env.OTS_AK_ENV;
var secretAccessKey = process.env.OTS_SK_ENV;
var endpoint = 'yourEndpoint';
var instancename = 'yourInstance';

var client = new TableStore.Client({
    accessKeyId: accessKeyId,
    secretAccessKey: secretAccessKey,
    endpoint: endpoint,
    instancename: instancename,
    maxRetries:20,//最大重試次數，預設值為20次，可以省略此參數。
});

配置參數說明請參見下表。

參數	樣本	說明
endpoint	https://myinstance.cn-hangzhou.ots.aliyuncs.com	執行個體的訪問地址。具體操作，請參見擷取執行個體Endpoint。
accessKeyId	process.env.OTS_AK_ENV	通過環境變數擷取AccessKey，請確保已配置相應環境變數。
secretAccessKey	process.env.OTS_SK_ENV	通過環境變數擷取AccessKey，請確保已配置相應環境變數。
instancename	myinstance	執行個體名稱。更多資訊，請參見執行個體。
maxRetries	20	出錯時最大重試次數。

使用STS初始化

說明

運行本程式碼範例之前，請確保已設定環境變數OTS_AK_ENV、OTS_SK_ENV和 OTS_SESSION_TOKEN。更多資訊，請參見配置訪問憑證。

var accessKeyId = process.env.OTS_AK_ENV;
var secretAccessKey = process.env.OTS_SK_ENV;
var stsToken = process.env.OTS_SESSION_TOKEN;
var endpoint = 'yourEndpoint';
var instancename = 'yourInstance';

var client = new TableStore.Client({
    accessKeyId: accessKeyId,
    secretAccessKey: secretAccessKey,
    stsToken: stsToken,
    endpoint: endpoint,
    instancename: instancename,
});

配置參數說明請參見下表。

參數	樣本	說明
endpoint	https://myinstance.cn-hangzhou.ots.aliyuncs.com	執行個體的訪問地址。具體操作，請參見擷取執行個體Endpoint。
accessKeyId	process.env.OTS_AK_ENV	通過環境變數擷取AccessKey和STS Token，請確保已配置相應環境變數。
accessKeySecret	process.env.OTS_SK_ENV
stsToken	process.env.OTS_SESSION_TOKEN
instancename	myinstance	執行個體名稱。更多資訊，請參見執行個體。

常見問題

使用Table StoreSDK時出現Signature mismatch異常