OTSClient は Table Store のクライアントです。 呼び出し側に、テーブルを操作し、単一行または複数の行に対してデータを読み書きするための一連の方法を提供します。 Java SDK を使用して Table Store へのリクエストを開始するには、OTSClient インスタンスを初期化し、必要に応じて ClientConfiguration のデフォルト設定を変更する必要があります。

エンドポイントを決定する

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

説明
「http://sun.cn-hangzhou.ots.aliyuncs.com」 HTTP プロトコルを使用してインターネット経由で杭州の sun インスタンスにアクセスします。
「https://sun.cn-hangzhou.ots.aliyuncs.com」 HTTPS プロトコルを使用してインターネット経由で杭州の sun のインスタンスにアクセスします。
重要 インスタンスにはイントラネット経由でもアクセスできます。

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

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

AccessKey を設定する

Alibaba Cloud Table Store サービスにアクセスするには、署名認証用の有効な AccessKey が必要です。 以下のタイプのアクセスキーがサポートされています。

  • プライマリアカウントの AccessKeyID と AccessKeySecret。 基本的な手順は次の通りです:

    1. Alibaba Cloud Web サイトでAlibaba Cloud アカウントを登録します。
    2. AccessKey コンソールにログインします。 AccessKey を申請します。
  • Table Store へのアクセスを許可されている RAM ユーザーの AccessKeyID および AccessKeySecret。 基本的な手順は次の通りです。

    1. プライマリアカウントを使用してRAM にアクセスします。 RAM ユーザーを作成するか、既存の RAM ユーザーを使用します。
    2. プライマリアカウントを使用して、RAM ユーザーに Table Store へのアクセスを許可します。

      認証後、RAM ユーザーの AccessKeyID と AccessKeySecret を使用してTable Store にアクセスできます。

  • 一時アクセス用の STS トークン。 トークン取得プロセスは次のとおりです。

    1. アプリケーションサーバーは RAM/STS サーバーにアクセスして、一時的なAccessKeyID、AccessKeySecrets およびトークンを取得し、ユーザーに送信します。
    2. 一時的な AccessKeyID、AccessKeySecret およびトークンを使用して Table Store にアクセスします。

初期化

AccessKeyID と AccessKeySecret を取得したら、OTSClient インスタンスを初期化する必要があります。

クライアントを作成する

Table Store SDK を使用する場合は、クライアントを構築してから、クライアント API を呼び出して Table Store サービスにアクセスする必要があります。 クライアント API 機能は、Table Store が提供する RESTful API に似ています。

Table Store SDK の最新バージョンには、SyncClient と AsyncClient の2種類のクライアントがあり、それぞれ同期 API と非同期 API 用に設計されています。

同期 API 呼び出しが完了すると、リクエスが実行されます。 同期 API を呼び出して、Table Store のさまざまな機能について学ぶことができます。 同期 API と比較して、非同期 API はより優れた柔軟性を提供します。 高いパフォーマンス要件がある場合は、ビジネスニーズに応じて、非同期 API の使用とマルチスレッドの使用のどちらかを選択できます。

SyncClient と AsyncClient はどちらもセキュアスレッドで、管理スレッドと接続リソースが含まれています。 あまりにも多くのクライアントを作成することは推奨しません。 通常、グローバルクライアント 1 つで十分です。

サンプルコード

  1. デフォルト設定を使用して SyncClient を作成します。
            final String endPoint = ""; 
            final String accessKeyId = ""; 
            final String accessKeySecret = ""; 
            final String instanceName = "";
    
            SyncClient client = new SyncClient(endPoint, accessKeyId, accessKeySecret, instanceName);
    					
  2. カスタム設定を使用して SyncClient を作成します。
    // ClientConfiguration は複数の設定項目を提供します。 一般的に使用される項目は次のとおりです。
            ClientConfiguration clientConfiguration = new ClientConfiguration();
            // 接続確立タイムアウトを設定します。
            clientConfiguration.setConnectionTimeoutInMillisecond(5000);
            // ソケットのタイムアウトを設定します。
            clientConfiguration.setSocketTimeoutInMillisecond(5000);
            // 再試行ポリシーを設定します。 これが設定されていない場合は、デフォルトの再試行ポリシーが使用されます。
            clientConfiguration.setRetryStrategy(new AlwaysRetryStrategy());
            SyncClient client = new SyncClient(endPoint, accessId, accessKey,
                    instanceName, clientConfiguration);

HTTPS

HTTPS 用の Java 7 にアップグレードします。

マルチスレッド

  • マルチスレッドがサポートされています。

  • そのマルチスレッドは同じ OTSClient オブジェクトを使用することを推奨します。