Consulta de rango - Tablestore - Centro de documentación de Alibaba Cloud

La consulta de rango permite buscar datos que se encuentran dentro de un intervalo específico. Si el tipo de un campo es TEXT, los valores del campo se dividen en tokens. Una fila cumple con las condiciones de la consulta cuando como mínimo uno de sus tokens coincide con el intervalo especificado.

Requisitos previos

Se inicializó una instancia de OTSClient. Para obtener más información, consulte Initialize an OTSClient instance.
Se creó una tabla de datos y se escribieron datos en ella. Para obtener más información, consulte Create a data table y Write data.
Se creó un índice de búsqueda para la tabla de datos. Para obtener más información, consulte Create a search index.

Parámetros

Parámetro	Descripción
table_name	El nombre de la tabla de datos.
index_name	El nombre del índice de búsqueda.
offset	La posición desde donde inicia la consulta actual.
limit	El número máximo de filas que debe devolver la consulta actual. Si solo necesita consultar la cantidad de filas que cumplen con las condiciones, sin obtener los datos específicos de cada una, establezca este parámetro en 0.
get_total_count	Indica si se devuelve el total de filas que cumplen con las condiciones de la consulta. El valor predeterminado es false, lo que significa que no se devuelve dicho total. Si establece este parámetro en true, el rendimiento de la consulta disminuye.
query_type	El tipo de consulta. Para usar una consulta de rango, establezca este parámetro en `QueryTypeConst::RANGE_QUERY`.
field_name	El nombre del campo con el que desea hacer coincidir la consulta.
range_from	El valor inicial del intervalo de la consulta.
range_to	El valor final del intervalo de la consulta.
include_lower	Indica si se incluye el valor del parámetro range_from en la respuesta. Este parámetro es de tipo booleano.
include_upper	Indica si se incluye el valor del parámetro range_to en la respuesta. Este parámetro es de tipo booleano.
sort	El método que se utiliza para ordenar las filas de la respuesta. Para obtener más información, consulte Sorting and paging.
columns_to_get	Indica si se devuelven todas las columnas de cada fila que cumple con las condiciones de la consulta. Configure los campos return_type y column_names para este parámetro. Si establece return_type en `ColumnReturnTypeConst::RETURN_SPECIFIED`, use return_names para especificar las columnas que se devolverán. Si establece el parámetro return_type en `ColumnReturnTypeConst::RETURN_ALL`, se devuelven todas las columnas. Si establece return_type en `ColumnReturnTypeConst::RETURN_ALL_FROM_INDEX`, se devuelven todas las columnas del índice de búsqueda. Si establece el parámetro return_type en `ColumnReturnTypeConst::RETURN_NONE`, solo se devuelven las columnas de la clave principal.

Ejemplos

A continuación se muestra un ejemplo de código para consultar las filas cuyo valor en la columna long sea mayor o igual a 100 y menor que 101. En este caso, las filas de la respuesta se ordenan de forma ascendente según el valor de la columna keyword.

$request = array(
    'table_name' => 'php_sdk_test',
    'index_name' => 'php_sdk_test_search_index',
    'search_query' => array(
        'offset' => 0,
        'limit' => 2,
        'get_total_count' => true,
        'query' => array(
            'query_type' => QueryTypeConst::RANGE_QUERY,
            'query' => array(
                'field_name' => 'long',
                'range_from' => 100,
                'include_lower' => true,
                'range_to' => 101,
                'include_upper' => false
            )
        ),
        'sort' => array(
            array(
                'field_sort' => array(
                    'field_name' => 'keyword',
                    'order' => SortOrderConst::SORT_ORDER_ASC
                )
            ),
        )
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('double', 'long', 'keyword')
    )
);
$response = $otsClient->search($request);

Preguntas frecuentes

Referencias

Cuando utilice un índice de búsqueda para consultar datos, puede usar los siguientes métodos de consulta: term query, terms query, match all query, match query, match phrase query, prefix query, range query, wildcard query, Boolean query, geo query, nested query y exists query. Puede utilizar diferentes métodos de consulta para consultar datos desde múltiples dimensiones según sus necesidades empresariales.

Si necesita ordenar o paginar las filas que cumplen con las condiciones de la consulta, utilice la función de ordenamiento y paginación. Para obtener más información, consulte Sorting and paging.

Para agrupar el conjunto de resultados con base en una columna específica, utilice la función collapse (distinct). De esta manera, los datos del tipo indicado aparecerán una sola vez en los resultados de la consulta. Para obtener más información, consulte Collapse (distinct).
Si requiere analizar los datos de una tabla, por ejemplo, para obtener los valores extremos, la suma o el total de filas, ejecute operaciones de agregación o sentencias SQL. Para obtener más información, consulte Aggregation y SQL query.
Cuando necesite obtener rápidamente todas las filas que cumplen con las condiciones de la consulta, sin ordenarlas, llame a las operaciones ParallelScan y ComputeSplits para aprovechar la función de escaneo paralelo. Para obtener más información, consulte Parallel scan.