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