Una consulta de término permite buscar datos que coincidan exactamente con el valor especificado de un campo. Este tipo de consulta es similar a las búsquedas basadas en condiciones de coincidencia de cadenas. Si la columna es de tipo TEXT, Tablestore divide la cadena en tokens y los utiliza para buscar la palabra clave. Una fila cumple las condiciones de la consulta cuando como mínimo uno de sus tokens coincide exactamente con dicha palabra clave. La palabra clave que se usa para comparar el valor de la columna no se divide en tokens durante la consulta.
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 registros 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 |
El nombre de la tabla de datos. |
|
indexName |
El nombre del índice de búsqueda. |
|
offset |
La posición desde donde inicia la consulta actual. |
|
limit |
El número máximo de filas que debe devolver la consulta actual. Si solo necesita obtener la cantidad de filas que cumplen las condiciones, sin recuperar los datos específicos, establezca el parámetro limit en 0. |
|
queryType |
El tipo de consulta. Establezca este parámetro en TableStore.QueryType.TERM_QUERY. |
|
fieldName |
El nombre de la columna que desea consultar. |
|
term |
La palabra clave que se usa para comparar el valor de la columna durante la consulta de término. Esta palabra no se divide en tokens. Se utiliza completa para compararla con el valor de la columna. Si la columna es de tipo TEXT, Tablestore divide la cadena en tokens y los utiliza para buscar la palabra clave. Una fila cumple las condiciones de la consulta cuando como mínimo uno de sus tokens coincide exactamente con dicha palabra clave. Por ejemplo, si el valor de una columna TEXT en una fila es "tablestore is cool", este se divide en los tokens "tablestore", "is" y "cool". La fila cumplirá las condiciones si usted especifica "tablestore", "is" o "cool" como palabra clave de búsqueda. |
|
getTotalCount |
Indica si se devuelve el total de filas que cumplen las condiciones de la consulta. El valor predeterminado es false, lo que significa que no se devuelve dicho total. Si establece este parámetro en true, el rendimiento de la consulta disminuye. |
|
columnToGet |
Indica si se devuelven todas las columnas de cada fila que cumple las condiciones de la consulta. Para este parámetro puede configurar los campos returnType y returnNames.
|
Ejemplo
A continuación se muestra un ejemplo de código para consultar las filas donde el valor de la columna Col_Keyword coincide exactamente con "hangzhou":
/**
* Search the table for rows in which the value of Col_Keyword exactly matches "hangzhou".
*/
client.search({
tableName: TABLE_NAME,
indexName: INDEX_NAME,
searchQuery: {
offset: 0,
limit: 10, // To query only the number of rows that meet the query conditions without specific data, set the limit parameter to 0.
query: { // Set the query type to TableStore.QueryType.TERM_QUERY.
queryType: TableStore.QueryType.TERM_QUERY,
query: {
fieldName: "Col_Keyword",
term: "hangzhou"
}
},
getTotalCount: true // Specify whether to return the total number of rows that meet the query conditions. The default value of this parameter is false, which specifies that the total number of rows that meet the query conditions is not returned.
},
columnToGet: { // Specify the columns that you want to return. You can set the parameter to RETURN_SPECIFIED to return specific columns, RETURN_ALL to return all columns, RETURN_ALL_FROM_INDEX to return all columns in the search index, or RETURN_NONE to return only the primary key columns.
returnType: TableStore.ColumnReturnType.RETURN_ALL
}
}, function (err, data) {
if (err) {
console.log('error:', err);
return;
}
console.log('success:', JSON.stringify(data, null, 2));
});Preguntas frecuentes
Preguntas frecuentes
Referencias
-
Los índices de búsqueda son compatibles con 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 los requerimientos de su negocio.
Si necesita ordenar o paginar las filas que cumplen las condiciones de la consulta, utilice la función de ordenamiento y paginación. Para 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 indicado aparecerán una sola vez en los resultados de la consulta. Para más información, consulte Collapse (distinct).
Si requiere analizar los datos de una tabla, por ejemplo, para obtener valores extremos, sumas o el total de filas, ejecute operaciones de agregación o instrucciones SQL. Para más información, consulte Aggregation y SQL query.
Cuando necesite recuperar rápidamente todas las filas que cumplen las condiciones de la consulta, sin ordenarlas, llame a las operaciones ParallelScan y ComputeSplits para usar la función de escaneo paralelo. Para más información, consulte Parallel scan.