Todos os produtos
Search
Central de documentação

Tablestore:SearchQuery

Última atualização: Jul 03, 2026

O SearchQuery especifica as configurações de consulta definidas ao chamar a operação Search dos índices de busca.

Estrutura de dados

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;
}

Nome

Tipo

Obrigatório

Descrição

offset

int32

Não

Posição inicial da consulta atual.

limit

int32

Não

Número máximo de linhas retornadas pela consulta atual.

query

Query

Sim

Configuração da consulta.

collapse

Collapse

Não

Colapsa os resultados retornados com base na coluna especificada.

sort

Sort

Não

Método de ordenação dos resultados.

getTotalCount

bool

Não

Especifica se o sistema deve retornar o número total de linhas que atendem às condições de consulta. O valor padrão é false, o que indica que a contagem total não será retornada.

Retornar o número total de linhas correspondentes reduz o desempenho da consulta.

token

bytes

Não

Se o Tablestore não conseguir ler todos os dados que atendem às condições de consulta, ele retorna next_token. Use next_token para continuar a leitura dos dados subsequentes.

aggs

Aggregations

Não

Configurações de agregação.

group_bys

GroupBys

Não

Configurações de agrupamento.

highlight

Highlight

Não

Configurações de destaque.

filter

SearchFilter

Não

Filtro pós-consulta aplicado aos resultados. As agregações e os agrupamentos são executados apenas nos dados filtrados.

Operações relacionadas

Search