Todos los productos
Search
Centro de documentos

Tablestore:ScanQuery

Última actualización: Sep 03, 2026

ScanQuery especifica la configuración de escaneo que se establece al invocar la operación ParallelScan.

Estructura de datos

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

Obligatorio

Descripción

query

Query

Sí

Condiciones de consulta. Se admiten los siguientes métodos: consulta por término, consulta difusa, consulta por rango, consulta por ubicación geográfica y consulta anidada.

limit

int32

No

Número máximo de filas que puede devolver cada llamada a ParallelScan.

alive_time

int32

No

Periodo de validez de la tarea de escaneo paralelo actual, que coincide con la vigencia del token. Valor predeterminado: 60. Unidad: segundos. Se recomienda conservar el valor predeterminado.

Si no se inicia la siguiente solicitud dentro de este periodo, no será posible consultar más datos. La vigencia del token se renueva con cada solicitud enviada.

token

bytes

No

Token que se usa para paginar los resultados de la consulta.

La respuesta de ParallelScan incluye el token correspondiente a la página siguiente, el cual permite recuperar dicha página.

current_parallel_id

int32

Sí

Identificador de la tarea de escaneo paralelo en la solicitud. Valores válidos: [0, max_parallel).

max_parallel

int32

Sí

Cantidad máxima de tareas de escaneo paralelo por solicitud. Este límite varía según el volumen de datos; a mayor volumen, se requieren más tareas paralelas en la sesión.

Operaciones relacionadas

ParallelScan