Todos los productos
Search
Centro de documentos

Tablestore:SearchQuery

Última actualización: Sep 03, 2026

SearchQuery especifica las configuraciones de consulta que se definen al llamar a la operación Search de los índices de búsqueda.

Estructura de datos

message SearchQuery {
    optional int32 offset = 1;
    optional int32 limit = 2;
    optional Query query = 4;
    optional Collapse collapse = 5;
    optional Sort sort = 6;
    optional bool getTotalCount = 8;
    optional bytes token = 9;
    optional Aggregations aggs = 10;
    optional GroupBys group_bys = 11;
    optional Highlight highlight = 12;
    optional SearchFilter filter = 14;
}

Nombre

Tipo

Obligatorio

Descripción

offset

int32

No

Posición desde la cual comienza la consulta actual.

limit

int32

No

Número máximo de filas que debe devolver la consulta actual.

query

Query

Sí

Configuración de la consulta.

collapse

Collapse

No

Colapsa los resultados devueltos según la columna especificada.

sort

Sort

No

Método de ordenamiento de los resultados.

getTotalCount

bool

No

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

Devolver el número total de filas coincidentes reduce el rendimiento de la consulta.

token

bytes

No

Si Tablestore no logra leer todos los datos que cumplen con las condiciones de consulta, devuelve next_token. Este token permite continuar la lectura de los datos subsiguientes.

aggs

Aggregations

No

Configuraciones de agregación.

group_bys

GroupBys

No

Configuraciones de agrupamiento.

highlight

Highlight

No

Configuraciones de resaltado.

filter

SearchFilter

No

Filtro posterior para la fase de consulta. Se aplica a los resultados de la consulta. Las agregaciones y los agrupamientos se ejecutan únicamente sobre los datos filtrados.

Operaciones relacionadas

Search