すべてのプロダクト
Search
ドキュメントセンター

Tablestore:.NET SDK

最終更新日:Jul 23, 2025

Tablestore SDK for .NET は、Wide Column モデルでの操作をサポートしています。

機能リスト

SDK を使用する前に、クライアントを初期化する必要があります。次の表に、Tablestore SDK for .NET でサポートされている機能を示します。

機能タイプ

操作

説明

データテーブル操作

データテーブルを作成する

データテーブルを作成してデータを格納します。データテーブルの作成時に、自動採番主キー列を構成できます。

テーブル構成を更新する

データテーブルの構成を更新します。

データテーブルを一覧表示する

インスタンス内のすべてのデータテーブルの名前を表示します。

テーブル情報を照会する

データテーブルの構成を照会します。

データテーブルを削除する

指定されたデータテーブルを削除します。

データ操作

データを書き込む

データテーブルにデータを書き込みます。

データを読み取る

データテーブルからデータを読み取ります。

データを削除する

データテーブルからデータを削除します。

フィルター

フィルターの条件に基づいてサーバー側で読み取り結果をフィルタリングし、返すデータを決定します。

条件付き更新

データが更新条件を満たす場合にのみ、テーブル内のデータを更新します。そうでない場合、データの更新は失敗し、エラーが返されます。

アトミックカウンター

アトミックカウンター機能を使用すると、列をアトミックカウンターとして指定し、その列に対してアトミックカウンター操作を実行できます。

サーチインデックス

サーチインデックスを作成する

データテーブルのサーチインデックスを作成します。

サーチインデックスを一覧表示する

テーブルに作成されたサーチインデックスを照会します。

サーチインデックスの構成を更新する

サーチインデックスの生存時間( TTL )を更新します。

サーチインデックスの説明を照会する

サーチインデックスの説明(サーチインデックス内のフィールドに関する情報とサーチインデックスの構成を含む)を照会します。

サーチインデックスを削除する

指定されたサーチインデックスを削除します。

基本的なクエリ

基本的なクエリタイプには、完全一致検索term クエリ複数値完全一致検索プレフィックスクエリ範囲クエリワイルドカード検索exists クエリ折りたたみ(重複排除)ジオクエリ、および ネストされたクエリがあります。

ブール値クエリ

クエリ条件には、1 つ以上のサブクエリ条件を含めることができ、サブクエリ条件に基づいてデータがクエリ条件を満たすかどうかを判断します。

並べ替えと改ページ

サーチインデックスを使用してデータを照会する場合は、指定された順序で返されたデータを取得します。返される行数が大きい場合は、オフセットベースの改ページまたはトークンベースの改ページを使用して必要なデータをすばやく見つけることができます。

集約

最小値の検索、最大値の検索、合計の計算、平均の計算、行数のカウント、個別行数のカウント、フィールド値によるグループ化、範囲によるグループ化、地理的な場所によるグループ化、フィルター条件によるグループ化などの操作を実行できます。複数の集約機能を組み合わせて、複雑なクエリの要件を満たすことができます。

フルテキストインデックス

Tablestore は、一致検索フレーズクエリを提供して、フルテキストインデックス機能を実装します。クエリは、トークン化に基づいてデータと一致します。

並列エクスポート

結果セット全体の順序が重要でない場合は、並列エクスポート機能を使用して、一致するすべてのデータをより高速に返します。

セカンダリインデックス

セカンダリインデックスを作成する

データテーブルのセカンダリインデックスを作成します。

セカンダリインデックスを使用してデータを読み取る

1 行のデータを読み取るか、主キー値が特定の範囲内にあるデータを読み取ることで、セカンダリインデックス内のデータを照会します。必要な属性列がセカンダリインデックスに含まれている場合は、セカンダリインデックスから直接データを読み取ることができます。そうでない場合は、データテーブルからデータを読み取る必要があります。

セカンダリインデックスを削除する

データテーブルから指定されたセカンダリインデックスを削除します。

SQL クエリ

マッピングテーブルを作成する

既存のテーブルまたはインデックスのマッピングテーブルを作成します。

マッピングテーブルの属性列を更新する

既存のマッピングテーブルに属性列を追加または削除します。

マッピングテーブルを削除する

1 つ以上のマッピングテーブルを削除します。

マッピングテーブルを一覧表示する

現在のデータベース内のマッピングテーブルを一覧表示します。

テーブルの説明を照会する

フィールド名やフィールドタイプなど、テーブルの説明を照会します。

インデックスの説明を照会する

テーブルのインデックスの説明を照会します。

データを照会する

テーブル内のデータを照会します。

バージョン互換性

Tablestore .NET SDK の最新バージョンは 6.x.x です。 最新バージョンと以前のバージョンの互換性については、以下の項目で説明します。

  • Tablestore .NET SDK V5.x.x: 互換性があります。

  • Tablestore .NET SDK V4.x.x: 互換性があります。

  • Tablestore .NET SDK V3.x.x: 互換性があります。

  • 2.x.x シリーズ SDK の非互換コンポーネントは次のとおりです。

    • いくつかの操作に互換性がありません。 Condition.IGNORE、Condition.EXPECT_EXIST、および Condition.EXPECT_NOT_EXIST パラメーターは削除されています。

    • DLL ファイル名が Aliyun.dll から Aliyun.TableStore.dll に変更されました。

詳細については、「Tablestore SDK for .NET のバージョン履歴」をご参照ください。

参照

Tablestore エラーのトラブルシューティング方法については、「エラー処理」をご参照ください。