Tablestore Java SDK は、ワイドカラムモデル、時系列モデル、およびタイムラインモデルの操作をサポートしています。
機能一覧
SDK 機能を使用する前に、Tablestore クライアントを初期化する必要があります。 Java SDK でサポートされているワイドカラムモデルと時系列モデルの詳細な機能については、次の表を参照してください。 タイムラインモデルの使用方法については、「タイムラインモデル」をご参照ください。
ワイドカラムモデル
機能タイプ | 機能操作 | 説明 |
データテーブルを作成してデータを格納できます。 データテーブルを作成するときに、データの暗号化と 自動インクリメントプライマリキー列 を構成できます。 | ||
データテーブルの構成を更新します。 | ||
インスタンス内のすべてのデータテーブルの名前を表示します。 | ||
データテーブルの構成を照会します。 | ||
データテーブルを削除できます。 | ||
データテーブルに事前定義された列を追加したり、データテーブルから事前定義された列を削除したりできます。 セカンダリ インデックスを作成するときに、セカンダリ インデックスのインデックス列または属性列を、データテーブルの作成時に指定した事前定義された列に設定できます。 | ||
データの書き込み | データテーブルにデータを書き込みます。 たとえば、1 行のデータを書き込むことや、複数の行のデータを同時に書き込むことができます。 | |
データの更新 | データテーブルのデータを更新します。 たとえば、1 行のデータを更新することや、複数の行のデータを同時に更新することができます。 | |
データの読み取り | データテーブルからデータを読み取ります。 たとえば、1 行のデータを読み取る、プライマリキー値が指定された範囲内にあるデータを読み取る、複数の行のデータを読み取る、イテレータを使用してデータを読み取ることができます。 | |
データの削除 | データテーブルからデータを削除します。 たとえば、1 行のデータを削除することや、複数の行のデータを同時に削除することができます。 | |
フィルターの条件に基づいて、サーバー側で読み取り結果をフィルターします。 | ||
指定された条件が満たされた場合にのみ、テーブル内のデータを更新します。 それ以外の場合、更新は失敗し、エラーが返されます。 | ||
アトミックカウンター機能を使用すると、列をアトミックカウンターとして指定し、その列に対してアトミックカウンター操作を実行できます。 | ||
データテーブルのローカル トランザクションを有効にすると、パーティションキー値に基づいてローカル トランザクションを作成できます。 | ||
テーブル内のデータを、サイズが指定された値とほぼ同じ論理シャードに分割できます。 シャード間の分割点とシャードが存在するマシンに関する情報が返されます。 | ||
Tablestore は、増分データに関連する操作を提供します。
| ||
ビッグデータシナリオでは、複数の行のデータを同時にデータテーブルに書き込むことができます。 | ||
ビッグデータシナリオでは、複数の行のデータを同時にデータテーブルから読み取ることができます。 | ||
データテーブルの多ディメンション インデックスを作成できます。 | ||
テーブルに作成された多ディメンション インデックスを照会します。 | ||
多ディメンション インデックスの存続時間（TTL）を更新します。 | ||
多ディメンション インデックスの説明（多ディメンション インデックス内のフィールドに関する情報と多ディメンション インデックスの構成を含む）を照会します。 | ||
指定された多ディメンション インデックスを削除します。 | ||
ビジネス要件に基づいて、多ディメンション インデックスの履歴データを削除したり、データの保持期間を延長したりします。 | ||
基本的なクエリタイプには、すべて一致クエリ、用語クエリ、複数用語クエリ、プレフィックスクエリ、サフィックスクエリ、ワイルドカードクエリ、範囲クエリ、存在クエリ、折りたたみ（個別）、地理クエリ、ネストクエリなどがあります。 | ||
クエリ条件には、1 つ以上のサブ条件を含めることができます。 サブ条件が満たされると、データが返されます。 | ||
多ディメンション インデックスを使用してデータを照会する場合、返されるデータの並べ替え方法を指定できます。 返される行数が大きい場合は、オフセットベースのページングまたはトークンベースのページングを使用して、必要なデータをすばやく見つけることができます。 | ||
集計操作を実行して、行の最小値、最大値、合計、平均値、カウント、および個別カウントを取得できます。 また、集計操作を実行して、フィールド値、範囲、地理的な場所、またはフィルター別に結果をグループ化することもできます。 複雑なクエリに対して複数の集計操作を実行できます。 | ||
Tablestore は、全文検索用に 一致クエリ と 一致フレーズクエリ を提供します。 データを照会すると、トークン化結果に基づいてデータが照合されます。 ハイライト 機能を使用して、クエリ文字列をハイライト表示できます。 | ||
k 近傍法（KNN）ベクタークエリ機能を使用して、ベクターに基づいて近似最近傍探索を実行できます。 これにより、大規模なデータセットで、照会するベクターと最も類似性が高いデータ項目を見つけることができます。 | ||
結果セット全体をソートしたくない場合は、パラレル スキャン機能を使用して、一致するすべてのデータをより速く返すことができます。 | ||
データテーブルのセカンダリ インデックスを作成します。 | ||
1 行のデータを読み取るか、プライマリキー値が特定の範囲内にあるデータを読み取ることで、セカンダリ インデックスのデータを照会できます。 必要な属性列がセカンダリ インデックスに含まれている場合は、セカンダリ インデックスから直接データを読み取ることができます。 それ以外の場合、データはデータテーブルから読み取る必要があります。 | ||
データテーブルから指定されたセカンダリ インデックスを削除します。 | ||
リアルタイムのデータ消費のために、データテーブルのトンネルを作成します。 | ||
データテーブル内のすべてのトンネルに関する情報（トンネル名、トンネルタイプ、トンネル ID、トンネルステージ、データの期限切れなど）を一覧表示します。 | ||
トンネルに関する詳細情報（トンネル情報やトンネル内のチャネル情報など）を照会します。 | ||
データテーブルからトンネルを削除します。 | ||
既存のテーブルまたはインデックスのマッピングテーブルを作成します。 | ||
既存のマッピングテーブルの属性列を追加または削除します。 | ||
1 つ以上のマッピングテーブルを削除します。 | ||
現在のデータベース内のマッピングテーブルを一覧表示します。 | ||
テーブルの説明（フィールド名、フィールドタイプなど）を照会します。 | ||
テーブルのインデックスの説明を照会します。 | ||
テーブル内のデータを照会できます。 | ||
SQL 文を使用して時間タイプのデータ（Datetime、Date、Time を含む）を照会した後、要件に基づいて特定のデータを取得できます。 | ||
Tablestore データテーブルから OSS バケットにデータを配信して格納するための配信タスクを作成します。 | ||
データテーブルのすべての配信タスク情報（データテーブル名、配信タスク名、配信タスクタイプなど）を一覧表示します。 | ||
配信タスクの説明情報を照会します。 | ||
配信タスクを削除します。 |
時系列モデル
機能タイプ | 特定の機能 | 説明 |
時系列データを格納する時系列テーブルを作成します。 | ||
時系列テーブルまたは時系列メタデータの構成を更新します。 | ||
インスタンス内のすべての時系列テーブルの名前をクエリします。 | ||
TTL 構成などの時系列テーブルに関する情報をクエリします。 | ||
時系列テーブルを削除します。 | ||
時系列データを時系列テーブルにバッチで書き込みます。 | ||
特定の時系列における、指定された条件を満たす時系列データをクエリします。 | ||
メトリック名やデータソース情報など、複数の条件を指定して時系列情報を取得します。 | ||
時系列メタデータを更新します。バッチ更新がサポートされています。 | ||
時系列メタデータを削除します。バッチ削除がサポートされています。 | ||
既存の時系列テーブルの分析ストアを作成して、時系列データを低コストで保存し、時系列データをすばやくクエリおよび分析します。 | ||
時系列分析ストアの TTL 構成を更新します。分析ストアの TTL を更新すると、Tablestore は保持期間が TTL を超えるデータを分析ストアから自動的かつ非同期的にクリアします。 | ||
TTL 構成、データ同期オプション、データ同期ステータス、データストレージサイズなど、分析ストアの説明をクエリします。 | ||
時系列テーブルから分析ストアを削除します。 | ||
時系列テーブルの Lastpoint インデックスを作成して、各時系列の最新の時点データをすばやく取得します。 | ||
Lastpoint インデックスのデータをクエリできます。 | ||
Lastpoint インデックス用に作成された検索インデックスを使用して、Lastpoint インデックスのデータを取得できます。 検索インデックスを使用すると、Lastpoint インデックスのデータ取得を高速化し、多次元クエリおよび統計分析機能を提供できます。 | ||
不要になった Lastpoint インデックスを削除できます。 | ||
既存のテーブルまたはインデックスのマッピングテーブルを作成します。 | ||
既存のマッピングテーブルの属性列を追加または削除します。 | ||
1 つ以上のマッピングテーブルを削除します。 | ||
現在のデータベース内のマッピングテーブルを一覧表示します。 | ||
フィールド名やフィールドタイプなど、テーブルの説明をクエリします。 | ||
テーブルのインデックス記述をクエリします。 | ||
テーブル内のデータをクエリします。 |
バージョン互換性
Tablestore SDK for Java の最新バージョンは V5.x.x です。このセクションでは、最新バージョンと以前のバージョンの互換性について説明します。
Tablestore Java SDK V4.x.x：互換性あり
Tablestore Java SDK V2.x.x：互換性なし
詳細については、Tablestore Java SDK のバージョン履歴を参照してください。