Query the total number of rows in a table or return multiple random rows - Tablestore

La consulta de coincidencia total permite coincidir con todas las filas de una tabla. Con ella se consulta el número total de filas de la tabla o se devuelven varias filas aleatorias.

Operación de API

Para ejecutar una consulta de coincidencia total, llame a la operación Search o ParallelScan y establezca el tipo de consulta en MatchAllQuery.

Parámetros

Parámetro	Descripción
query	Tipo de la consulta. Establezca el parámetro query en MatchAllQuery.
tableName	Nombre de la tabla de datos.
indexName	Nombre del índice de búsqueda.
limit	Número máximo de filas que debe devolver la consulta actual. Si desea que la consulta actual devuelva varias filas de datos aleatorias, establezca el parámetro limit en un entero positivo. Para consultar únicamente el número de filas que cumplen las condiciones de consulta, sin obtener datos específicos, establezca el parámetro limit en 0.
columnsToGet	Indica si se devuelven todas las columnas de cada fila que cumple las condiciones de consulta. Para este parámetro, especifique los campos returnAll y columns. El valor predeterminado del campo returnAll es false, lo que indica que no se devuelven todas las columnas. En este caso, utilice el campo columns para especificar las columnas que desea devolver. Si no especifica dichas columnas, solo se devuelven las columnas de clave primaria. Si establece el campo returnAll en true, se devuelven todas las columnas.
getTotalCount	Indica si se devuelve el número total de filas que cumplen las condiciones de consulta. El valor predeterminado de este parámetro es false, por lo que no se devuelve dicho total. Si establece este parámetro en true, el rendimiento de la consulta disminuye.

Métodos

Puede usar Tablestore CLI o los SDK de Tablestore para ejecutar una consulta de coincidencia total. Antes de hacerlo, compruebe que se cumplan los siguientes requisitos previos:

Utilice una cuenta de Alibaba Cloud o un usuario de RAM con los permisos obligatorios para las operaciones de Table Store. Para otorgar permisos a un usuario de RAM, consulte Grant permissions to a RAM user by using a RAM policy.

Si utiliza un SDK o una herramienta de línea de comandos, create an AccessKey para su cuenta de Alibaba Cloud o usuario de RAM en caso de que no tenga uno.
created a data table.
Se ha creado un Search Index para la tabla de datos.
Si utiliza un SDK, initialize the Tablestore Client.
Si utiliza la herramienta de línea de comandos, descargue e inicie la herramienta. Después, configure la conexión a su instancia y seleccione la tabla de destino. Para más información, consulte Download the command-line tool, Start the tool and configure connection information y Data table operations.

Uso de Tablestore CLI

Con Tablestore CLI puede ejecutar el comando search para consultar datos mediante índices de búsqueda. Para más información, consulte Search index.

Ejecute el comando search para consultar datos con el índice de búsqueda search_index y devolver todas las columnas indexadas de cada fila que cumpla las condiciones de consulta.
```
search -n search_index --return_all_indexed
```

Introduzca las condiciones de consulta cuando el sistema lo solicite:

{
    "Offset": -1,
    "Limit": 10,
    "Collapse": null,
    "Sort": null,
    "GetTotalCount": true,
    "Token": null,
    "Query": {
        "Name": "MatchAllQuery",
        "Query": {
        }
    }
}

Uso de los SDK de Tablestore

Es posible ejecutar una consulta de coincidencia total con los siguientes SDK de Tablestore: Tablestore SDK for Java, Tablestore SDK for Go, Tablestore SDK for Python, Tablestore SDK for Node.js, Tablestore SDK for .NET y Tablestore SDK for PHP. En este ejemplo se utiliza el SDK de Tablestore para Java.

A continuación se muestra un ejemplo que coincide con todas las filas de un índice de búsqueda. Devuelve hasta 10 filas y el número total de filas coincidentes.

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

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(new MatchAllQuery());
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());

Facturación

La consulta de datos mediante Search Index consume capacidad de procesamiento de lectura. Para más información, consulte Search Index metering and billing.

Preguntas frecuentes

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

Referencias

Search Index admite diversos tipos de consultas para buscar datos de forma multidimensional, entre ellos: term query, terms query, match all query, match query, phrase match query, range query, prefix query, suffix query, wildcard query, token-based wildcard query, boolean query, geo query, nested query, vector search, y exists query.
Al consultar datos, puede sort and paginate el conjunto de resultados o ejecutar collapsing (deduplication).
Para analizar datos, como buscar el valor máximo o mínimo, calcular una suma o contar filas, utilice las funciones statistical aggregation o SQL query.
Si necesita exportar datos rápidamente sin importar el orden del conjunto de resultados, utilice la función Parallel Scan.