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 インスタンスが存在するエンドポイントを照会するには、次の手順に従います。
- Alibaba Cloud Table Store コンソールにログインします。
- 「インスタンスの詳細」にアクセスします。インスタンスのエンドポイントであるインスタンスアクセス URL を見つけます。
AccessKey を設定する
Alibaba Cloud Table Store サービスにアクセスするには、署名認証用の有効な AccessKey が必要です。 以下のタイプのアクセスキーがサポートされています。
-
プライマリアカウントの AccessKeyID と AccessKeySecret。 基本的な手順は次の通りです:
- Alibaba Cloud Web サイトでAlibaba Cloud アカウントを登録します。
- AccessKey コンソールにログインします。 AccessKey を申請します。
-
Table Store へのアクセスを許可されている RAM ユーザーの AccessKeyID および AccessKeySecret。 基本的な手順は次の通りです。
- プライマリアカウントを使用してRAM にアクセスします。 RAM ユーザーを作成するか、既存の RAM ユーザーを使用します。
- プライマリアカウントを使用して、RAM ユーザーに Table Store へのアクセスを許可します。
認証後、RAM ユーザーの AccessKeyID と AccessKeySecret を使用してTable Store にアクセスできます。
-
一時アクセス用の STS トークン。 トークン取得プロセスは次のとおりです。
- アプリケーションサーバーは RAM/STS サーバーにアクセスして、一時的なAccessKeyID、AccessKeySecrets およびトークンを取得し、ユーザーに送信します。
- 一時的な 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 を作成します。
final String endPoint = ""; final String accessKeyId = ""; final String accessKeySecret = ""; final String instanceName = ""; SyncClient client = new SyncClient(endPoint, accessKeyId, accessKeySecret, instanceName);
- カスタム設定を使用して 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 オブジェクトを使用することを推奨します。