OTSClient は Table Store のクライアントです。 呼び出し側に、テーブルを操作し、単一行または複数の行に対してデータを読み書きするための一連の方法を提供します。
エンドポイントの決定
エンドポイントは、リージョン内の Alibaba Cloud Table Store のドメインです。 以下のフォーマットに対応しています。
エンドポイントの種類 | 説明 |
---|---|
リージョンアドレス | Table Store インスタンスが存在するリージョンのアドレス です (例: https://instance.cn-hangzhou.ots.aliyuncs.com )。
|
テーブルストアのリージョンアドレス
Table Store インスタンスが存在するエンドポイントを照会するには、次の手順に従います。
- Table Store コンソールにログインします。
- インスタンスの詳細ページにアクセスします。インスタンスのエンドポイントである インスタンスアクセス URL を見つけます。
AccessKey の設定
Alibaba Cloud Table Store サービスにアクセスするには、署名認証用の有効な AccessKey (AccessKeyID と AccessKeySecret を含む) が必要です。 AccessKey を取得するには、次の手順に従います。
- Alibaba Cloud ウェブサイトで Alibaba Cloud アカウントを登録します。
- AccessKey コンソールにログインして、AccessKey を申請します。
AccessKeyID と AccessKeySecret を取得したら、Table Store のエンドポイントを使用してクライアントを作成し、OTSClient インスタンスを初期化します。
API:
/// <summary>
/// OTSClient コンストラクタ。
///</summary>
/// <param name="endPoint">Table Store サービスのアドレス 。たとえば、https://instance.cn-hangzhou.ots.aliyun.com:80 です。 「https://」で始める必要があります。 </ param>
///<param name = "accessKeyID"> Table Store の AccessKeyID です。</param>
/// <param name="accessKeySecret"> Table Store の AccessKeySecret です。 </param>
/// <param name="instanceName"> Table Store instance 名前です。 Alibaba Cloud Table Store コンソールで作成されている必要があります。 </param>
public OTSClient(string endPoint, string accessKeyID, string accessKeySecret, string instanceName);
/// <summary>
/// OTSClientConfig インスタンスを使用して OTSClient インスタンスを作成します。
/// </summary>
/// <param name="config">OTSClientConfig instance</param>
public OTSClient(OTSClientConfig config);
例
// OTSClientConfig オブジェクトを作成します。
var config = new OTSClientConfig(Endpoint, AccessKeyId, AccessKeySecret, InstanceName);
// ログ出力を無効にします (この機能はデフォルトで有効になっています)。
config.OTSDebugLogHandler = null;
config.OTSErrorLogHandler = null;
// OTSClientConfig を使用して OTSClient オブジェクト を作成します。
var otsClient = new OTSClient(config);
// OTSClient を使用してデータを挿入またはクエリします。
-
ConnectionLimit は OTSClientConfig オブジェクトで設定できます。 ConnectionLimit が設定されていない場合、デフォルト値は 300 です。
-
OTSClientConfig の OTSDebugLogHandler と OTSErrorLogHandler はロギング動作を制御し、設定可能です。
-
OTSClientConfig の RetryPolicy は再試行ロジックを制御します。 デフォルトの再試行ポリシーが提供されています。 独自の再試行ポリシーを定義できます。
マルチスレッド
-
マルチスレッドがサポートされています。
-
複数のスレッドが同じ OTSClient オブジェクトを使用することを推奨します。