Use Tablestore SDK for Node.js to perform a range query - Tablestore

Recupera las filas cuyo valor de campo se encuentra dentro de un rango específico. En los campos TEXT, Tablestore divide el valor del campo en tokens; una fila coincide cuando como mínimo un token está dentro del rango.

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 data tables 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.

Ejemplos

A continuación se muestra un ejemplo que recupera las filas donde Col_Long es mayor o igual a 1 y menor que 10 (1 <= Col_Long < 10), ordenadas por Col_Long en orden descendente.

client.search({
    tableName: TABLE_NAME,
    indexName: INDEX_NAME,
    searchQuery: {
        offset: 0,
        limit: 10,          // Set to 0 to return only the row count, not the data.
        query: {
            queryType: TableStore.QueryType.RANGE_QUERY,
            query: {
                fieldName: "Col_Long",
                rangeFrom: 1,
                includeLower: true,     // >= rangeFrom (equivalent to >=)
                rangeTo: 10,
                includeUpper: false     // < rangeTo (equivalent to <)
            }
        },
        getTotalCount: true // Returns the total row count. May affect query performance.
    },
    columnToGet: {
        // RETURN_ALL: all columns
        // RETURN_SPECIFIED: columns listed in returnNames
        // RETURN_ALL_FROM_INDEX: all columns in the search index
        // RETURN_NONE: primary key columns only
        returnType: TableStore.ColumnReturnType.RETURN_ALL
    }
}, function (err, data) {
    if (err) {
        console.log('error:', err);
        return;
    }
    console.log('success:', JSON.stringify(data, null, 2));
});

Parámetros

Parámetro	Descripción
tableName	El nombre de la tabla de datos.
indexName	El nombre del índice de búsqueda.
offset	La cantidad de filas que se omiten antes de devolver los resultados. Valor predeterminado: 0.
limit	El número máximo de filas que se devuelven. Establezca este valor en 0 para devolver solo el conteo de filas, sin los datos.
queryType	El tipo de consulta. Establezca este parámetro en `TableStore.QueryType.RANGE_QUERY` para las consultas de rango.
fieldName	El nombre del campo que se va a consultar.
rangeFrom	El límite inferior del rango de consulta. La inclusión de este valor depende de `includeLower`.
rangeTo	El límite superior del rango de consulta. La inclusión de este valor depende de `includeUpper`.
includeLower	Indica si se incluye `rangeFrom` en los resultados. El valor `true` equivale a `>=`; `false` equivale a `>`.
includeUpper	Indica si se incluye `rangeTo` en los resultados. El valor `true` equivale a `<=`; `false` equivale a `<`.
getTotalCount	Indica si se devuelve el número total de filas que coinciden con la consulta. Valor predeterminado: false. Si establece este parámetro en `true`, el rendimiento de la consulta podría verse afectado.
columnToGet	Las columnas que se van a devolver. Establezca `returnType` en uno de los valores compatibles y use `returnNames` para especificar las columnas cuando `returnType` se configure como `RETURN_SPECIFIED`. Si establece returnType en TableStore.ColumnReturnType.RETURN_SPECIFIED, debe configurar returnNames para especificar las columnas que desea devolver. Si establece el parámetro returnType en TableStore.ColumnReturnType.RETURN_ALL, se devuelven todas las columnas. Si establece el parámetro returnType en TableStore.ColumnReturnType.RETURN_ALL_FROM_INDEX, se devuelven todas las columnas del índice de búsqueda. Si establece el parámetro returnType en TableStore.ColumnReturnType.RETURN_NONE, solo se devuelven las columnas de clave primaria.

Preguntas frecuentes

Referencias

Los índices de búsqueda admiten los siguientes tipos 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, vector query y exists query. Seleccione el tipo de consulta adecuado según sus necesidades de negocio.

Si necesita ordenar o paginar las filas que cumplen con las condiciones de 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 especificado aparecen una sola vez en los resultados de la consulta. Para obtener más información, consulte Collapse (distinct).
Si necesita analizar los datos de una tabla de datos, por ejemplo, para obtener los valores extremos, la suma y el número total de filas, ejecute operaciones de agregación o instrucciones SQL. Para obtener más información, consulte Aggregation y SQL query.
Cuando requiera obtener rápidamente todas las filas que cumplen con las condiciones de consulta, sin necesidad de ordenarlas, llame a las operaciones ParallelScan y ComputeSplits para usar la función de escaneo paralelo. Para obtener más información, consulte Parallel scan.