
# 游标对象
游标对象CursorObject包含以下方法：
- execute：执行SQL请求，如果需要执行多个SQL语句请使用分号（;）进行分隔。
表1execute接口参数 
| 参数名称         | 参数类型  | 是否必选 | 描述                                    |
|:---|:---|:---|:---|
| 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：该接口无需参数，关闭游标。
![](https://support.huaweicloud.com/sdkreference-fabric/public_sys-resources/note_3.0-zh-cn.png)
- 游标对象关闭后调用其他接口会抛出CursorError异常"The cursor has been closed."。
- 当使用execute接口一次执行多条使用分号（;）隔开的语句时，首次调用fetchone、fetchall、fetchbatch接口返回的是第一条语句的数据（如果存在结果集时），如果需要切换到下一条语句结果集，请使用nextset接口。
 
