Azure Table Storage SDK问题：续令牌失效，重复获取相同数据

使用microsoft/azure/storage-table v1.1 SDK从Azure Table拉取2000+实体时，遇到单次查询最多返回1000条的限制，尝试用续令牌处理分页，但代码持续获取相同数据，续令牌始终不变，导致do-while循环无限执行无法退出。原代码如下：

try {
    $tableClient = self::connect();
    $options = new QueryEntitiesOptions();

    do {
        $result = $tableClient->queryEntities($table, $filter, $options);
        $entities = $result->getEntities();
        
        // Process entities
        foreach ($entities as $entity) {
            // store entities in an array or process them
            $history[] = $entity;
        }

        // Get the continuation token
        $continuationToken = $result->getContinuationToken();

        // If a continuation token exists, set it for the next query
        if ($continuationToken) {
            $options->setContinuationToken($continuationToken);
        } else {
            break;  // No more data, break the loop
        }

    } while (true);

} catch (ServiceException $e) {
    echo $e->getCode() . " : " . $e->getMessage();
}

问题原因 #

v1.1版本的SDK中，QueryEntitiesOptions是引用类型，复用同一个实例设置续令牌时，SDK内部无法正确重置查询状态，导致每次查询都基于初始参数执行，返回相同结果，续令牌也不会更新。

修复方案 #

每次分页查询都创建全新的QueryEntitiesOptions实例，单独维护续令牌变量，避免状态污染：

try {
    $tableClient = self::connect();
    $continuationToken = null;
    $history = [];

    do {
        // 每次循环创建新的QueryEntitiesOptions实例
        $options = new QueryEntitiesOptions();
        if ($continuationToken) {
            $options->setContinuationToken($continuationToken);
        }

        $result = $tableClient->queryEntities($table, $filter, $options);
        $entities = $result->getEntities();
        
        // 处理实体
        foreach ($entities as $entity) {
            $history[] = $entity;
        }

        // 更新续令牌
        $continuationToken = $result->getContinuationToken();

        // 无续令牌时退出循环
        if (!$continuationToken) {
            break;
        }

    } while (true);

} catch (ServiceException $e) {
    echo $e->getCode() . " : " . $e->getMessage();
}

额外优化建议 #

为确保分页结果的一致性，建议给查询添加排序条件（比如基于Timestamp或RowKey），避免Azure Table返回无序的重复分页数据：

// 在创建options时添加排序配置
$options->setOrderBy('Timestamp asc');

内容的提问来源于stack exchange，提问作者dram95