Consulta de coincidencia total - Tablestore - Centro de documentación de Alibaba Cloud

Utilice la consulta de coincidencia total para obtener todas las filas de una tabla de datos. Esta función es útil para contar el número total de filas o recuperar una muestra aleatoria.

Requisitos previos

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

Parámetros

Parámetro	Descripción
tableName	Nombre de la tabla de datos.
indexName	Nombre del índice de búsqueda.
offset	Posición inicial de la consulta.
limit	Número máximo de filas por devolver. Para devolver solo el recuento de filas sin los datos, establezca este valor en 0.
query	Tipo de consulta. Establezca este valor en `TableStore.QueryType.MATCH_ALL_QUERY` para ejecutar una consulta de coincidencia total.
getTotalCount	Indica si se debe devolver el número total de filas que cumplen con las condiciones de la consulta. Valor predeterminado: `false`. Establecer este valor en `true` reduce el rendimiento de la consulta.
columnToGet	Columnas por devolver para cada fila coincidente. Configure este parámetro mediante `returnType` y `returnNames`. Si establece returnType en TableStore.ColumnReturnType.RETURN_SPECIFIED, configure 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.

Ejemplos

A continuación se utiliza una consulta de coincidencia total para contar el número total de filas en una tabla de datos:

/**
 * Perform a match all query to get the total row count of a data table.
 */
client.search({
    tableName: TABLE_NAME,
    indexName: INDEX_NAME,
    searchQuery: {
        offset: 0,
        limit: 10, // Set to 0 to return only the row count without data.
        query: {
            queryType: TableStore.QueryType.MATCH_ALL_QUERY
        },
        getTotalCount: true // Set to true to return the total number of matched rows. Default: false.
    },
    columnToGet: { // RETURN_SPECIFIED: specified columns only; RETURN_ALL: all columns; RETURN_ALL_FROM_INDEX: all columns in the search index; RETURN_NONE: primary key columns only.
        returnType: TableStore.ColumnReturnType.RETURN_SPECIFIED,
        returnNames: ["Col_1", "Col_2", "Col_3"]
    }
}, function (err, data) {
    if (err) {
        console.log('error:', err);
        return;
    }
    console.log('success:', JSON.stringify(data, null, 2));
});

Preguntas frecuentes

How do I query the total number of rows in a table?

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 un tipo de consulta para buscar datos según sus requisitos 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 más información, consulte Sorting and paging.

Si desea agrupar el conjunto de resultados según una columna específica, utilice la función de colapso (distinct). De esta manera, los datos del tipo especificado aparecen solo una vez en los resultados de la consulta. Para más información, consulte Collapse (distinct).
Para analizar datos en una tabla de datos, como obtener valores extremos, sumas o el número total de filas, ejecute operaciones de agregación o sentencias SQL. Para más información, consulte Aggregation y SQL query.
Si necesita obtener rápidamente todas las filas que cumplen con las condiciones de la consulta sin necesidad de ordenarlas, llame a las operaciones ParallelScan y ComputeSplits para utilizar la función de escaneo paralelo. Para más información, consulte Parallel scan.