Go SDK を使用してタームクエリを実行する方法 - Tablestore

タームクエリを使用すると、指定したキーワードと完全に一致するフィールド値をクエリできます。タームクエリは、文字列照合と同様に機能します。 TEXT 列がクエリされ、行内のトークンの少なくとも 1 つがキーワードと完全に一致する場合、その行はクエリ条件を満たします。キーワードはトークン化されません。

前提条件

OTSClient インスタンスが初期化されていること。詳細については、OTSClient インスタンスの初期化を参照してください。
データテーブルが作成され、データがデータテーブルに書き込まれていること。詳細については、データテーブルの作成とデータの書き込みを参照してください。
データテーブルの検索インデックスが作成されていること。詳細については、検索インデックスの作成を参照してください。

パラメーター

パラメーター	説明
TableName	データテーブルの名前。
IndexName	検索インデックスの名前。
Query	クエリのタイプ。クエリタイプを TermQuery に設定します。
FieldName	一致させるフィールドの名前。
Term	タームクエリを実行するときにフィールド値と一致させるために使用されるキーワード。このキーワードはトークン化されません。代わりに、キーワード全体がフィールド値との照合に使用されます。フィールドのタイプが TEXT の場合、Tablestore は文字列をトークン化し、トークンを使用してキーワードと照合します。行内のトークンの少なくとも 1 つがキーワードと完全に一致すると、行はクエリ条件を満たします。たとえば、行の TEXT タイプのフィールドの値が "tablestore is cool" の場合、値は "tablestore"、"is"、"cool" にトークン化できます。フィールドの値と一致させるキーワードとして "tablestore"、"is"、または "cool" を指定すると、行はクエリ条件を満たします。
ColumnsToGet	クエリ条件を満たす各行のすべてのフィールドを返すかどうかを指定します。 ReturnAll パラメーターと Columns パラメーターを指定できます。デフォルトでは、ReturnAll パラメーターは false に設定されており、すべてのフィールドが返されるわけではないことを示します。 ReturnAll パラメーターが false に設定されている場合、Columns パラメーターを使用して返すフィールドを指定できます。 Columns パラメーターを指定しない場合は、プライマリキーフィールドのみが返されます。 ReturnAll パラメーターを true に設定すると、すべてのフィールドが返されます。
GetTotalCount	クエリ条件を満たす行の総数を返すかどうかを指定します。このパラメーターのデフォルト値は false で、クエリ条件を満たす行の総数は返されないことを指定します。このパラメーターを true に設定すると、クエリのパフォーマンスが低下します。

例

次のサンプルコードは、データテーブル内の Col_Keyword 列の値が hangzhou と完全に一致する行をクエリする方法の例を示しています。

/**
 * テーブル内の Col_Keyword フィールドの値が "hangzhou" と完全に一致する行をクエリします。
 */
func TermQuery(client *tablestore.TableStoreClient, tableName string, indexName string) {
    searchRequest := &tablestore.SearchRequest{}
    searchRequest.SetTableName(tableName)
    searchRequest.SetIndexName(indexName)
    query := &search.TermQuery{} // クエリタイプを TermQuery に設定します。
    query.FieldName = "Col_Keyword" // クエリするフィールドの名前を指定します。
    query.Term = "hangzhou" // フィールド値と一致させるキーワードを指定します。
    searchQuery := search.NewSearchQuery()
    searchQuery.SetQuery(query)
    searchQuery.SetGetTotalCount(true)
    searchRequest.SetSearchQuery(searchQuery)
    // クエリ条件を満たす行のすべての列を返します。
    searchRequest.SetColumnsToGet(&tablestore.ColumnsToGet{
        ReturnAll:true,
    })
    searchResponse, err := client.Search(searchRequest)
    if err != nil {
        fmt.Printf("%#v", err)
        return
    }
    fmt.Println("IsAllSuccess: ", searchResponse.IsAllSuccess) // クエリ条件を満たすすべての行が返されたかどうかを確認します。
    fmt.Println("TotalCount: ", searchResponse.TotalCount) // 返された行数ではなく、クエリ条件を満たす行の総数を表示します。
    fmt.Println("RowCount: ", len(searchResponse.Rows))
    for _, row := range searchResponse.Rows {
        jsonBody, err := json.Marshal(row)
        if err != nil {
            panic(err)
        }
        fmt.Println("Row: ", string(jsonBody))
    }
}

FAQ

参考資料

検索インデックスを使用してデータをクエリする場合、次のクエリメソッドを使用できます。タームクエリ、複数タームクエリ、すべて一致クエリ、一致クエリ、一致フレーズクエリ、プレフィックスクエリ、範囲クエリ、ワイルドカードクエリ、地理クエリ、ブールクエリ、KNNベクトル検索クエリ、ネストされたクエリ、存在クエリ。検索インデックスによって提供されるクエリメソッドを使用して、ビジネス要件に基づいて複数のディメンションからデータをクエリできます。
並べ替えおよびページング機能を使用して、クエリ条件を満たす行を並べ替えたりページネーションしたりできます。詳細については、並べ替えとページングを参照してください。
折りたたみ（重複排除）機能を使用して、特定の列に基づいて結果セットを折りたたむことができます。このようにして、指定されたタイプのデータはクエリ結果に一度だけ表示されます。詳細については、折りたたみ（重複排除）を参照してください。
データテーブル内のデータを分析する場合、Search 操作の集計機能を使用するか、SQL ステートメントを実行できます。たとえば、最小値と最大値、合計、行の総数などを取得できます。詳細については、集計とSQL クエリを参照してください。
行を並べ替えることなく、クエリ条件を満たすすべての行を取得する場合、ParallelScan および ComputeSplits 操作を呼び出して並列スキャン機能を使用できます。詳細については、並列スキャンの実行を参照してください。