更新时间: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标准接口方法介绍

