Ejecutar una consulta de términos - Tablestore - Centro de documentación de Alibaba Cloud

Una consulta de términos es similar a una consulta de término, pero admite varios términos. Se devuelve una fila de datos si como mínimo una de las palabras clave coincide con el valor de la columna especificada. Las consultas de términos se usan de la misma manera que el operador IN en las instrucciones SQL.

Requisitos previos

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

Parámetros

Parámetro	Descripción
table_name	El nombre de la tabla de datos.
index_name	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 desea devolver en la consulta actual. Para consultar solo la cantidad de filas que cumplen las condiciones, sin recuperar los datos específicos de cada una, establezca el parámetro limit en 0.
get_total_count	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 se ve afectado.
query_type	El tipo de consulta. Establezca este parámetro en `QueryTypeConst::TERMS_QUERY`.
field_name	El nombre de la columna que desea consultar.
terms	Las palabras clave que se usan para comparar con el valor de la columna durante la consulta de términos. Se devuelve una fila de datos si como mínimo una de las palabras clave coincide con el valor de la columna.
sort	El método que se usa para ordenar las filas de la respuesta. Para obtener más información, consulte Sorting and paging.
columns_to_get	Indica si se devuelven todas las columnas de las filas que cumplen las condiciones de la consulta. Especifique los parámetros return_type y return_names. Si establece return_type en `ColumnReturnTypeConst::RETURN_SPECIFIED`, use return_names para indicar qué columnas se deben devolver. Si establece el parámetro return_type en `ColumnReturnTypeConst::RETURN_ALL`, se devuelven todas las columnas. Si establece return_type en `ColumnReturnTypeConst::RETURN_ALL_FROM_INDEX`, se devuelven todas las columnas del índice de búsqueda. Si establece el parámetro return_type en `ColumnReturnTypeConst::RETURN_NONE`, solo se devuelven las columnas de la clave principal.

Ejemplo

A continuación se muestra un ejemplo de código para consultar las filas de la tabla de datos cuyo valor en la columna keyword sea "keyword" o "php".

$request = array(
    'table_name' => 'php_sdk_test',
    'index_name' => 'php_sdk_test_search_index',
    'search_query' => array(
        'offset' => 0,
        'limit' => 5,
        'get_total_count' => true,
        'query' => array(
            'query_type' => QueryTypeConst::TERMS_QUERY,
            'query' => array(
                'field_name' => 'keyword',
                'terms' => array(
                    "keyword",
                    "php"
                )
            )
        ),
        'sort' => array(
            array(
                'field_sort' => array(
                    'field_name' => 'long',
                    'order' => SortOrderConst::SORT_ORDER_DESC,
                    'mode' => SortModeConst::SORT_MODE_AVG
                )
            )
        )
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('keyword', 'long')
    )
);
$response = $otsClient->search($request);

Preguntas frecuentes

Referencias

Cuando utiliza un índice de búsqueda para consultar datos, puede emplear los siguientes métodos 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 y exists query. Según sus necesidades de negocio, estos métodos le permiten consultar datos desde múltiples dimensiones.

Si necesita ordenar o paginar las filas que cumplen las condiciones de la consulta, utilice la función de ordenación y paginación. Para obtener 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 forma, los datos del tipo indicado aparecen una sola vez en los resultados de la consulta. Para obtener más información, consulte Collapse (distinct).
Si requiere analizar los datos de una tabla, por ejemplo, para obtener los valores extremos, la suma y el total de filas, ejecute operaciones de agregación o instrucciones SQL. Para obtener más información, consulte Aggregation y SQL query.
Para obtener rápidamente todas las filas que cumplen las condiciones de la consulta sin necesidad de ordenarlas, llame a las operaciones ParallelScan y ComputeSplits mediante la función de exploración paralela. Para obtener más información, consulte Parallel scan.