Todos los productos
Search
Centro de documentos

Tablestore:Consulta de términos

Última actualización: Sep 29, 2026

Una consulta de términos es similar a una consulta de término, pero admite varias palabras clave. Se devuelve una fila de datos cuando el valor de la columna coincide con al menos una de las palabras clave. Las consultas de términos funcionan de la misma manera que el operador IN en las instrucciones SQL.

Operación de API

Para ejecutar una consulta de términos, llame a la operación Search o ParallelScan y establezca el tipo de consulta en TermsQuery.

Parámetros

Parámetro

Descripción

query

El tipo de consulta. Establezca el parámetro query en TermsQuery.

fieldName

El nombre del campo que desea hacer coincidir.

terms

Los términos de búsqueda que se van a hacer coincidir. Puede especificar un máximo de 1,024 términos.

Se devuelve una fila de datos cuando el valor de la columna coincide con al menos una de las palabras clave.

getTotalCount

Indica si se debe devolver el número total de filas que cumplen las condiciones de consulta. El valor predeterminado de este parámetro es false, lo que significa que no se devuelve dicho total.

Si establece este parámetro en true, el rendimiento de la consulta disminuye.

weight

El peso que desea asignar al campo consultado para calcular la puntuación de relevancia de palabras clave basada en BM25. Este parámetro se utiliza en escenarios de búsqueda de texto completo. Si especifica un peso mayor para el campo consultado, la puntuación de relevancia de palabras clave basada en BM25 será más alta. El valor de este parámetro es un número de punto flotante positivo.

Este parámetro no afecta el número de filas devueltas, pero sí influye en las puntuaciones de relevancia de palabras clave basadas en BM25 de los resultados de la consulta.

tableName

El nombre de la tabla de datos.

indexName

El nombre del índice de búsqueda.

columnsToGet

Indica si se deben devolver todas las columnas de cada fila que cumpla las condiciones de consulta. Para este parámetro, puede especificar 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 las columnas, solo se devuelven las columnas de clave primaria.

Si establece el campo returnAll en true, se devuelven todas las columnas.

Métodos

Puede usar la consola de Tablestore, Tablestore CLI o los SDK de Tablestore para ejecutar una consulta de términos. Antes de hacerlo, compruebe que se cumplan los siguientes requisitos previos:

  • Contar con una cuenta de Alibaba Cloud o un usuario de RAM que tenga permisos para operar en Tablestore. Para obtener información sobre cómo otorgar permisos de operación de Tablestore a un usuario de RAM, consulte Use a RAM policy to grant permissions to a RAM user.

    Si va a utilizar los SDK de Tablestore o Tablestore CLI para ejecutar la consulta, debe haber creado un par de AccessKey para su cuenta de Alibaba Cloud o usuario de RAM. Para obtener más información, consulte Create an AccessKey pair.

  • Tener creada una tabla de datos. Para obtener más información, consulte Operations on tables.

  • Haber creado un índice de búsqueda para la tabla de datos. Para obtener más información, consulte Create a search index.

  • Si va a utilizar los SDK de Tablestore para ejecutar la consulta, inicialice una instancia de OTSClient. Para obtener más información, consulte Initialize an OTSClient instance.

  • Si va a utilizar Tablestore CLI para ejecutar la consulta, descargue e inicie Tablestore CLI, y configure la información de la instancia a la que desea acceder. Para obtener más información, consulte Download the Tablestore CLI y Start the Tablestore CLI and configure access information.

Uso de la consola de Tablestore

  1. Vaya a la pestaña Index Management.

    1. Inicie sesión en la consola de Table Store.

    2. En la barra de navegación superior, seleccione un resource group y una región.

    3. En la página Overview, haga clic en el nombre de la instancia o en Instance Management dentro de la columna Actions.

    4. En la pestaña Instance Details y dentro de la pestaña Data Table List, haga clic en el nombre de la tabla de datos o en Index Management en la columna Actions.

  2. En la pestaña Index Management, busque el Search Index deseado y haga clic en Search dentro de la columna Actions.

  3. En el cuadro de diálogo Search, especifique las condiciones de consulta.

    1. De forma predeterminada, se devuelven todas las columnas. Para devolver columnas específicas, desactive Retrieve All Columns e introduzca los nombres de las columnas separados por comas.

      Nota

      De forma predeterminada, Table Store devuelve las columnas de clave primaria de la tabla de datos.

    2. Seleccione un operador lógico: And, Or o Not.

      Si selecciona And, la consulta devuelve los datos que cumplen todas las condiciones especificadas. Si selecciona Or, devuelve los datos que cumplen al menos una de las condiciones. Si selecciona Not, devuelve los datos que no cumplen las condiciones especificadas.

    3. Seleccione un campo indexado y haga clic en Add.

    4. Establezca el tipo de consulta del campo indexado en Terms query (TermsQuery), introduzca un valor y haga clic en Add.

      Para agregar varios valores, repita el proceso de introducir un Value y hacer clic en Add.

    5. La ordenación está deshabilitada de forma predeterminada. Para ordenar los resultados por un campo específico, active Enable Sorting, agregue el campo de ordenación y configure el criterio correspondiente.

    6. La agregación está deshabilitada de forma predeterminada. Para aplicar una agregación estadística a un campo específico, active Enable Aggregation, agregue el campo para la agregación y configure los ajustes correspondientes.

  4. Haga clic en OK.

    Los resultados de la consulta se muestran en la pestaña Index Management.

Uso de Tablestore CLI

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

  1. 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
  2. Introduzca las condiciones de consulta según las indicaciones del sistema:

    {
        "Offset": -1,
        "Limit": 10,
        "Collapse": null,
        "Sort": null,
        "GetTotalCount": true,
        "Token": null,
        "Query": {
            "Name": "TermsQuery",
            "Query": {
                "FieldName": "col_keyword",
                "Terms": ["hangzhou", "xi'an"]
            }
        }
    }

Uso de los SDK de Tablestore

Puede ejecutar una consulta de términos 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.

En el siguiente ejemplo se consultan las filas cuyo valor del campo category es exactamente igual a books o games. Se devuelven hasta 10 filas y el número total de filas coincidentes.

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

TermsQuery termsQuery = new TermsQuery();
termsQuery.setFieldName("category");
termsQuery.addTerm(ColumnValue.fromString("books"));
termsQuery.addTerm(ColumnValue.fromString("games"));

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

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

Preguntas frecuentes

Referencias