Tous les produits
Search
Centre de documentation

Tablestore:ScanQuery

Dernière mise à jour :Aug 18, 2026

L'objet ScanQuery définit les paramètres d'analyse que vous configurez lors de l'appel à l'opération ParallelScan.

Structure des données

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

Paramètre

Type

Obligatoire

Description

query

Query

Oui

Les conditions de requête. Les méthodes de requête suivantes sont prises en charge : requête par terme, requête floue, requête par plage, requête géographique et requête imbriquée.

limit

int32

Non

Le nombre maximal de lignes pouvant être renvoyées par chaque appel à l'opération ParallelScan.

alive_time

int32

Non

La durée de validité de la tâche d'analyse parallèle actuelle. Cette durée correspond également à celle du jeton (token). La valeur par défaut est 60. L'unité est la seconde. Il est recommandé d'utiliser la valeur par défaut.

Si la requête suivante n'est pas initiée dans le délai de validité, il devient impossible d'interroger davantage de données. La durée de validité du jeton est actualisée à chaque envoi de requête.

token

bytes

Non

Le jeton utilisé pour la pagination des résultats de requête.

Les résultats de la requête ParallelScan contiennent le jeton pour la page suivante. Vous pouvez utiliser ce jeton pour récupérer la page suivante.

current_parallel_id

int32

Oui

L'ID de la tâche d'analyse parallèle dans la requête. Valeurs possibles : [0, max_parallel).

max_parallel

int32

Oui

Le nombre maximal de tâches d'analyse parallèle par requête. Ce nombre varie en fonction du volume de données. Un volume de données plus important nécessite davantage de tâches d'analyse parallèle au sein d'une session.

Opérations associées

ParallelScan