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 |
|
to |
El valor de la posición final. Al establecer la condición de rango, use |
|
includeLower |
Indica si se incluye el valor de |
|
includeUpper |
Indica si se incluye el valor de |
|
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 De forma predeterminada, Si establece |
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.
-
Cuenta con una cuenta de Alibaba Cloud o un usuario de RAM con permisos para operar en Tablestore. Para saber cómo otorgar estos permisos a un usuario de RAM, consulte Use a RAM policy to grant permissions to a RAM user.
Si desea usar los SDK de Tablestore o el CLI de Tablestore para ejecutar una consulta, debe haber creado un par de AccessKey para su cuenta de Alibaba Cloud o usuario de RAM. Para más información, consulte Create an AccessKey.
Se creó una tabla de datos. Para más información, consulte Operations on tables.
Se creó un índice de búsqueda para la tabla de datos. Para más información, consulte Create a search index.
Si va a utilizar los SDK de Tablestore, inicialice una instancia de OTSClient. Para más información, consulte Initialize a Tablestore client.
Si va a utilizar el CLI de Tablestore, descargue e inicie dicha herramienta. Además, configure la información de la instancia a la que desea acceder y de la tabla de datos. Para más información, consulte Download the Tablestore CLI, Start the Tablestore CLI and configure access information y Data table operations.
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.