Todos los productos
Search
Centro de documentos

Tablestore:Consulta de rango

Última actualización: Sep 28, 2026

Una consulta de rango recupera datos de una tabla con base en un intervalo específico. En el caso de un campo de tipo Text, se encuentra una coincidencia si algún token del valor del campo cumple la condición de rango.

Interfaz

Puede ejecutar una consulta de rango mediante la operación Search o ParallelScan. El tipo de consulta es RangeQuery.

Parámetros

Parámetro

Descripción

fieldName

El campo que se va a buscar.

from

El valor de la posición inicial.

Al establecer la condición de rango, use greaterThan para especificar mayor que (>) o greaterThanOrEqual para especificar mayor o igual que (>=).

to

El valor de la posición final.

Al establecer la condición de rango, use lessThan para especificar menor que (<) o lessThanOrEqual para especificar menor o igual que (<=).

includeLower

Indica si se incluye el valor de from en los resultados. Es de tipo Boolean.

includeUpper

Indica si se incluye el valor de to en los resultados. Es de tipo Boolean.

query

Establezca el tipo de consulta como RangeQuery.

sort

Ordena los resultados según un criterio específico. Para más información, consulte Sorting and pagination.

getTotalCount

Indica si se devuelve el número total de filas coincidentes. El valor predeterminado es false, lo que significa que no se devuelve dicho total.

Devolver el número total de filas coincidentes afecta el rendimiento de la consulta.

tableName

El nombre de la tabla de datos.

indexName

El nombre del índice de búsqueda.

columnsToGet

Indica si se devuelven todas las columnas. Incluye las configuraciones returnAll y columns.

De forma predeterminada, returnAll es false. Esto significa que no se devuelven todas las columnas. Puede usar columns para especificar qué columnas devolver. Si no usa columns, solo se devuelven las columnas de clave primaria.

Si establece returnAll en true, se devuelven todas las columnas.

Uso

Puede ejecutar una consulta de rango desde la consola, la interfaz de línea de comandos (CLI) o un kit de desarrollo de software (SDK). Antes de ejecutarla, complete las siguientes preparaciones.

Uso de la consola

  1. Vaya a la pestaña Indexes.

    1. Inicie sesión en la consola de Tablestore.

    2. En la barra de navegación superior, seleccione un resource group y una región.

    3. En la página Overview, haga clic en el nombre de la instancia que desea gestionar o haga clic en Manage Instance dentro de la columna Actions de la instancia.

    4. En la pestaña Tables de la sección Instance Details, haga clic en el nombre de la tabla de datos o en Indexes dentro de la columna Actions de dicha tabla.

  2. En la pestaña Indexes, busque el índice de búsqueda que usará para consultar los datos y haga clic en Manage Data dentro de la columna Actions.

  3. En el cuadro de diálogo Query Data, puede consultar los datos.

    1. De forma predeterminada, el sistema devuelve todas las columnas de atributos. Para devolver solo algunas, desactive All Columns y especifique las columnas de atributos deseadas. Separe varias columnas de atributos con comas (,).

      Nota

      De forma predeterminada, el sistema devuelve todas las columnas de clave primaria de la tabla de datos.

    2. Seleccione el operador lógico And, Or o Not según sus necesidades de negocio.

      Si selecciona el operador lógico And, se devuelven los datos que cumplen todas las condiciones de consulta. Si selecciona Or y especifica una sola condición, se devuelven los datos que la cumplen. Cuando selecciona Or y especifica varias condiciones, se devuelven los datos que cumplen al menos una de ellas. Por último, si selecciona Not, se devuelven los datos que no cumplen ninguna de las condiciones.

    3. Seleccione un campo de índice y haga clic en Add.

    4. Establezca el tipo de consulta del campo de índice en Range Query (RangeQuery) y especifique un rango de consulta.

      El rango de consulta es un intervalo cerrado por la izquierda y abierto por la derecha.

    5. La función de ordenamiento está deshabilitada de forma predeterminada. Si necesita ordenar los resultados por campos específicos, active Sort. Luego, especifique los campos y el orden de clasificación.

    6. La función de agregación también está deshabilitada de forma predeterminada. Si desea recopilar estadísticas sobre un campo específico, active Collect Statistics, indique el campo correspondiente y configure la información necesaria para la recopilación.

  4. Haga clic en OK.

    Los datos que cumplen las condiciones de consulta se muestran en el orden especificado dentro de la pestaña Indexes.

Uso de la interfaz de línea de comandos

Ejecute el comando search en la interfaz de línea de comandos para consultar datos mediante un índice de búsqueda. Para más información, consulte Search index.

  1. Ejecute el comando search para consultar datos de la tabla con el índice de búsqueda search_index. Este comando devuelve todas las columnas indexadas.

    search -n search_index --return_all_indexed
  2. Introduzca las condiciones de consulta cuando el sistema lo solicite. A continuación se muestra un ejemplo:

    {
        "Offset": -1,
        "Limit": 10,
        "Collapse": null,
        "Sort": null,
        "GetTotalCount": true,
        "Token": null,
        "Query": {
            "Name": "RangeQuery",
            "Query": {
                "FieldName": "col_long",
                "From": 1,
                "To": 100,
                "IncludeLower": true,
                "IncludeUpper": false
            }
        }
    }

Uso de un SDK

Puede ejecutar una consulta de rango con un Java SDK, Go SDK, Python SDK, Node.js SDK, .NET SDK o PHP SDK. Este tema toma como ejemplo el SDK de Java.

El siguiente ejemplo consulta los valores Long del campo price que se encuentran dentro del intervalo semiabierto [100, 500). La consulta devuelve hasta 10 filas y el número total de coincidencias.

String tableName = "example_table";
String indexName = "example_index";

RangeQuery rangeQuery = new RangeQuery();
rangeQuery.setFieldName("price");
rangeQuery.greaterThanOrEqual(ColumnValue.fromLong(100L));
rangeQuery.lessThan(ColumnValue.fromLong(500L));

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(rangeQuery);
searchQuery.setLimit(10);
searchQuery.setTrackTotalCount(SearchQuery.TRACK_TOTAL_COUNT);

SearchRequest request = new SearchRequest(tableName, indexName, searchQuery);
SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
columnsToGet.setReturnAll(true);
request.setColumnsToGet(columnsToGet);

SearchResponse response = client.search(request);
System.out.println(response.getTotalCount());
System.out.println(response.getRows());

Reglas de facturación

Cuando utiliza un índice de búsqueda para consultar datos, se le cobra por la capacidad de procesamiento de lectura consumida. Para más información, consulte Billable items of search indexes.

Preguntas frecuentes

Referencias

  • Al consultar datos con un índice de búsqueda, puede emplear los siguientes métodos de consulta: term query, terms query, match all query, match query, match phrase query, prefix query, range query, wildcard query, fuzzy query, Boolean query, geo query, nested query, KNN vector query y exists query. Seleccione los métodos adecuados según sus necesidades de negocio para consultar datos desde múltiples dimensiones.

    Mediante las funciones de ordenamiento y paginación, puede organizar o dividir en páginas las filas que cumplan las condiciones de consulta. Para más información, consulte Sorting and paging.

    La función collapse (distinct) permite agrupar el conjunto de resultados con base en una columna específica. De este modo, los datos del tipo indicado aparecen una sola vez en los resultados de la consulta. Para más información, consulte Collapse (remove duplicates).

  • Si necesita analizar los datos de una tabla, utilice la función de agregación de la operación Search o ejecute instrucciones SQL. Por ejemplo, puede obtener los valores mínimo y máximo, la suma y el número total de filas. Para más información, consulte Aggregation y SQL query.

  • Para obtener todas las filas que cumplen las condiciones de consulta sin necesidad de ordenarlas, llame a las operaciones ParallelScan y ComputeSplits. Así aprovechará la función de escaneo paralelo. Para más información, consulte Parallel scan.