Todos os produtos
Search
Central de documentação

Tablestore:ScanQuery

Última atualização: Jul 03, 2026

O ScanQuery especifica as configurações de varredura definidas ao chamar a operação ParallelScan.

Estrutura de dados

message ScanQuery {
    optional Query query = 1;
    optional int32 limit = 2;
    optional int32 alive_time = 3;  //unit is second
    optional bytes token = 4;
    optional int32 current_parallel_id = 5;
    optional int32 max_parallel = 6;
}

Parâmetro

Tipo

Obrigatório

Descrição

query

Query

Sim

Condições da consulta. Métodos compatíveis: consulta por termo, consulta difusa, consulta por intervalo, consulta por localização geográfica e consulta aninhada.

limit

int32

Não

Número máximo de linhas que cada chamada do ParallelScan pode retornar.

alive_time

int32

Não

Período de validade da tarefa de varredura paralela atual. Esse período também defina a validade do token. Valor padrão: 60. Unidade: segundos. Recomendamos usar o valor padrão.

Se nenhuma nova requisição ocorrer dentro desse período, não será possível consultar mais dados. A validade do token é renovada a cada requisição enviada.

token

bytes

Não

Token usado para paginar os resultados da consulta.

A resposta do ParallelScan inclui o token da próxima página. Use esse token para recuperar os dados subsequentes.

current_parallel_id

int32

Sim

ID da tarefa de varredura paralela na requisição. Valores válidos: [0, max_parallel).

max_parallel

int32

Sim

Número máximo de tarefas de varredura paralela por requisição. Esse limite varia conforme o volume de dados. Volumes maiores exigem mais tarefas paralelas na sessão.

Operações relacionadas

ParallelScan