更新时间：2026-01-06 GMT+08:00
游标对象
游标对象CursorObject包含以下方法：
|
参数名称 |
参数类型 |
是否必选 |
描述 |
|---|---|---|---|
|
query |
str |
是 |
要执行的SQL语句。 |
|
polling_time |
float |
否 |
轮询结果集的时间间隔，默认值为2。 |
|
get_schema |
bool |
否 |
指定本次查询的结果中是否包含被查询表的schema信息，默认值为True。 |
- fetchone：该接口无需参数，获取查询结果集的下一行，当存在下一行元组时，返回一个tuple数据，当游标已经在结果集末尾或没有更多结果集时，返回None。
- fetchall：该接口无需参数，获取查询结果集剩余行，返回一个list[tuple]，当游标已经在结果集末尾或者没有更多结果集时，返回一个空的list。
- fetchbatch：该接口无需参数， 当结果集格式为Arrow时，返回结果集下一页，返回的数据类型为Arrow的RecordBatch，如果不存在下一页数据，则返回None。
- nextset：该接口无需参数，将游标移动到下一个结果集的开头（如果存在），成功移动返回True，如果不存在下一个结果时返回False。
- close：该接口无需参数，关闭游标。
- 游标对象关闭后调用其他接口会抛出CursorError异常“The cursor has been closed.”。
- 当使用execute接口一次执行多条使用分号（;）隔开的语句时，首次调用fetchone、fetchall、fetchbatch接口返回的是第一条语句的数据（如果存在结果集时），如果需要切换到下一条语句结果集，请使用nextset接口。
父主题： PEP 249标准接口方法介绍
