Tablestore:Term query

使用方法

• Keyword フィールドや Integer フィールドなどのテキスト以外のフィールドの場合、フィールド値はクエリ条件を満たすために term と完全に一致する必要があります。

• Text フィールドには Term クエリを使用しないことをお勧めします。これは、セマンティックトークン化が予測不可能であり、アルゴリズムの反復処理と言語の変更によって変化する可能性があるためです。現在、Text フィールドに対する Term クエリは、個々のトークンが term と完全に一致するかどうかを検索します。トークン化せずにフィールド値全体を使用して term と一致させる場合は、仮想カラム 機能を使用して Text タイプを Keyword タイプに変換してから、Keyword フィールドで Term クエリを実行できます。 Text フィールドの場合、完全に一致するトークンがある限り、クエリ条件は満たされます。 term はトークン化されません。たとえば、Text フィールドの値が「tablestore is cool」で、値が「tablestore」、「is」、「cool」の 3 つのトークンにトークン化されている場合、term が「tablestore」、「is」、または「cool」の場合、クエリ条件は満たされます。

手順

1. [インデックス] タブに移動します。

   1. Tablestore コンソール にログインします。

   2. 上部のナビゲーションバーで、リソースグループとリージョンを選択します。

   3. [概要] ページで、管理するインスタンスの名前をクリックするか、インスタンスの [アクション] 列の [インスタンスの管理] をクリックします。

   4. [インスタンスの詳細] タブの [テーブル] タブで、データテーブルの名前をクリックするか、データテーブルの [アクション] 列の [インデックス] をクリックします。

2. [インデックス] タブで、データのクエリに使用する検索インデックスを見つけ、[アクション] 列の [データの管理] をクリックします。

3. 検索 ダイアログボックスで、クエリパラメータを構成します。

   1. デフォルトでは、システムはすべての属性列を返します。特定の属性列を返すには、[すべての列] をオフにして、返す属性列を指定します。複数の属性列はカンマ (,) で区切ります。

      説明

      デフォルトでは、システムはデータテーブルのすべてのプライマリキー列を返します。

   2. ビジネス要件に基づいて、[And]、[Or]、または [Not] 論理演算子を選択します。

      [And] 論理演算子を選択すると、クエリ条件を満たすデータが返されます。 [Or] 演算子を選択して単一のクエリ条件を指定すると、そのクエリ条件を満たすデータが返されます。 Or 演算子を選択して複数のクエリ条件を指定すると、いずれかのクエリ条件を満たすデータが返されます。 [Not] 論理演算子を選択すると、クエリ条件を満たさないデータが返されます。

   3. インデックスフィールドを選択し、追加 をクリックします。

   4. [クエリタイプ] ドロップダウンリストから [TermQuery（TermQuery）] を選択し、フィールド値を指定します。

   5. デフォルトでは、ソート機能は無効になっています。特定のフィールドに基づいてクエリ結果をソートする場合は、[ソート] をオンにして、クエリ結果をソートするフィールドとソート順を指定します。

   6. デフォルトでは、集計機能は無効になっています。特定のフィールドの統計を収集する場合は、[統計を収集] をオンにして、統計を収集するフィールドを指定し、統計の収集に必要な情報を設定します。

4. [OK] をクリックします。

   クエリ条件を満たすデータが、[インデックス] タブに指定された順序で表示されます。

開発統合

Tablestore SDK または Tablestore CLI を使用して Term クエリを実行できます。

• SDK: Java、Go、Python、Node.js、.NET、PHP

• Tablestore CLI

課金ルール

検索インデックスを使用してデータをクエリする場合、消費された読み取りスループットに対して課金されます。詳細については、「検索インデックスの課金対象項目」をご参照ください。

FAQ

• 検索インデックスの Search 操作を呼び出したときにデータが見つからない場合はどうすればよいですか？

• 検索インデックス機能の Search 操作を呼び出してデータをクエリするときに、limit パラメータの値を 1000 に増やすにはどうすればよいですか？

• 検索インデックスベースのクエリでページネーションを使用すると、トークンが無効になるのはなぜですか？

参考資料

• 検索インデックスを使用してデータをクエリする場合、次のクエリメソッドを使用できます: Term クエリ、複数値完全一致検索、完全一致検索、一致検索、フレーズ一致検索、プレフィックスクエリ、サフィックスクエリ、範囲クエリ、ワイルドカード検索、あいまい検索、ブール値クエリ、ジオクエリ、ネストされたクエリ、KNN ベクタークエリ、Exists クエリ。ビジネス要件に基づいてクエリメソッドを選択し、多次元からデータをクエリできます。

• ソート機能とページング機能を使用して、クエリ条件を満たす行をソートまたはページングできます。詳細については、「ソートとページングの実行」をご参照ください。

• データテーブルのデータを分析する場合は、Search 操作の集計機能を使用するか、SQL ステートメントを実行できます。たとえば、最小値、最大値、合計、行の総数などを取得できます。詳細については、「集計」および「SQL クエリ」をご参照ください。

• 行をソートせずにクエリ条件を満たすすべての行を取得する場合は、ParallelScan 操作と ComputeSplits 操作を呼び出して並列スキャン機能を使用できます。詳細については、「並列スキャン」をご参照ください。