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.
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
Search Index admite diversos tipos de consulta para búsquedas de datos multidimensionales, 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 realizar 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.