# cursor.fetchall()
#### 功能描述
获取查询结果的所有（剩余）行，并将它们作为元组列表返回，适用于结果集较小的情况。
- 场景1：假设有一个查询返回了5条记录，调用cursor.fetchall()会得到一个包含这5个元组的列表。每个元组对应一行数据，字段按查询顺序排列。
- 场景2：假设有一个查询返回了5条记录，先调用fetchone()会返回结果集的第一行数据，游标向前移动一行。然后再调用cursor.fetchall()，则会将结果集剩余4行数据作为元组列表返回。
 
![](https://support.huaweicloud.com/distributed-devg-v10-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
- 游标状态：调用fetchall()后，游标将处于结果集末尾，再次调用会返回空列表。
- 内存风险：大数据量时需谨慎使用，避免内存溢出。
 
#### 原型
```
cursor.fetchall()
```
#### 参数
无
#### 返回值
元组列表，为结果集的所有结果。如果结果集没有数据时，则返回空列表。
#### 示例
请参见[数据库建连、执行SQL并返回结果](https://support.huaweicloud.com/distributed-devg-v10-gaussdb/gaussdb-12-0236.html)。