Tablestore:範囲クエリ

前提条件

• OTSClient インスタンスが初期化されていること。詳細については、OTSClient インスタンスの初期化を参照してください。

• データテーブルが作成され、データがデータテーブルに書き込まれていること。詳細については、データテーブルの作成とデータの書き込みを参照してください。

• データテーブルの検索インデックスが作成されていること。詳細については、検索インデックスの作成を参照してください。

パラメーター

例

次のサンプルコードは、テーブル内の Col_Long 列の値が 1 以上 10 未満の行をクエリする方法の例を示しています。この例では、クエリ条件を満たす行は、Col_Long 列の値に基づいて降順で返されます。

/**
 * テーブルで、Col_Long 列の値が 1 から 10 の範囲にある行を検索します。範囲には 1 が含まれ、10 は含まれません。Tablestore は、これらの行を Col_Long 列の値に基づいて降順にソートします。
 */
client.search({
    tableName: TABLE_NAME,
    indexName: INDEX_NAME,
    searchQuery: {
        offset: 0,
        limit: 10, // 特定のデータではなく、クエリ条件を満たす行数のみをクエリするには、limit パラメーターを 0 に設定します。
        query: { // クエリタイプを TableStore.QueryType.RANGE_QUERY に設定します。
            queryType: TableStore.QueryType.RANGE_QUERY,
            query: {
                fieldName: "Col_Long",
                rangeFrom: 1,
                includeLower: true, // 範囲に rangeFrom の値を含めます。
                rangeTo: 10,
                includeUpper: false // 範囲から rangeTo の値を除外します。
            }
        },
        getTotalCount: true // クエリ条件を満たす行の総数を返すかどうかを指定します。デフォルト値: false。
    },
    columnToGet: { // 返す列を指定します。パラメーターを RETURN_SPECIFIED に設定して指定した列を返すか、RETURN_ALL に設定してすべての列を返すか、RETURN_ALL_FROM_INDEX に設定して検索インデックス内のすべての列を返すか、RETURN_NONE に設定してプライマリキー列のみを返すことができます。
        returnType: TableStore.ColumnReturnType.RETURN_ALL
    }
}, function (err, data) {
    if (err) {
        console.log('error:', err);
        return;
    }
    console.log('success:', JSON.stringify(data, null, 2));
});

FAQ

参照

• 検索インデックスでは、次のクエリタイプがサポートされています。用語クエリ、複数用語クエリ、すべて一致クエリ、一致クエリ、一致フレーズクエリ、プレフィックスクエリ、範囲クエリ、ワイルドカードクエリ、ブールクエリ、地理クエリ、ネストされたクエリ、ベクトル クエリ、存在クエリ。ビジネス要件に基づいてクエリタイプを選択してデータをクエリできます。

  クエリ条件を満たす行をソートまたはページ分割する場合は、ソートおよびページ分割機能を使用できます。詳細については、ソートとページ分割を参照してください。

  特定の列に基づいて結果セットを折りたたむ場合は、折りたたみ（重複排除）機能を使用できます。このようにして、指定されたタイプのデータはクエリ結果に一度だけ表示されます。詳細については、折りたたみ（重複排除）を参照してください。

• データテーブルのデータ（極値、合計、行の総数など）を分析する場合は、集計操作を実行するか、SQL ステートメントを実行できます。詳細については、集計とSQL クエリを参照してください。

• 行をソートする必要なく、クエリ条件を満たすすべての行をすばやく取得する場合は、ParallelScan および ComputeSplits オペレーションを呼び出して並列スキャン機能を使用できます。詳細については、並列スキャンを参照してください。