OTSClient は Table Store のクライアントです。 呼び出し側に、テーブルを操作し、単一行または複数の行に対してデータを読み書きするための一連の方法を提供します。

エンドポイントの決定

エンドポイントは、リージョン内の Alibaba Cloud Table Store のドメインです。 以下のフォーマットに対応しています。

エンドポイントの種類 説明
リージョンアドレス Table Store インスタンスが存在するリージョンのアドレス です (例: https://instance.cn-hangzhou.ots.aliyuncs.com)。

テーブルストアのリージョンアドレス

Table Store インスタンスが存在するエンドポイントを照会するには、次の手順に従います。

  1. Table Store コンソールにログインします。
  2. インスタンスの詳細ページにアクセスします。インスタンスのエンドポイントである インスタンスアクセス URL を見つけます。

AccessKey の設定

Alibaba Cloud Table Store サービスにアクセスするには、署名認証用の有効な AccessKey (AccessKeyID と AccessKeySecret を含む) が必要です。 AccessKey を取得するには、次の手順に従います。

  1. Alibaba Cloud ウェブサイトで Alibaba Cloud アカウントを登録します。
  2. 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 オブジェクトを使用することを推奨します。