# Python connector API方法概览 [表1]总结了Fabric SQL Python connector API支持的接口方法及描述，每个接口方法的详细描述和示例代码请单击表中方法名称跳转至详情页查看。 表1Fabric SQL Python connector API方法概览 | 接口名 | 方法 | 功能描述 | |:---|:---|:---| | [创建Session](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0299.html) | FabricSQLClient.createSession | 创建一个Session。 | | [查询Session状态](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0300.html) | FabricSQLClient.getSessionStatus | 查询一个指定Session的状态。 | | [关闭Session](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0301.html) | FabricSQLClient.closeSession | 关闭一个指定的Session。 | | [发送SQL请求](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0302.html) | FabricSQLClient.executeQuery | 下发SQL请求，异步返回请求结果。 | | [查询请求结果](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0303.html) | FabricSQLClient.getSummary | 查询本次SQL请求的执行结果。 | | [获取结果集](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0304.html) | FabricSQLClient.getStatementResult | 查询一个语句的结果集，可以指定查询页数。 | | [取消查询](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0305.html) | FabricSQLClient.cancelExecute | 取消一个执行中的请求。 | | [删除OBS结果集文件](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0315.html) | FabricSQLClient.deleteResult | 删除指定SQL请求在OBS产生的结果集文件。 | Fabric SQL Python connector API支持部分符合PEP 249标准的接口，PEP 249（Python Enhancement Proposal 249）是Python官方定义的数据库API接口标准，全称为Python Database API Specification v2.0，PEP 249标准定义了一组连接数据库、执行SQL语句、获取元组的方法，其具体内容请参考[PEP 249 -- Python Database API Specification v2.0](https://peps.python.org/pep-0249/)。[表2]总结了符合PEP 249标准的接口方法及描述，每个接口方法的详细描述和示例代码请单击表中方法名称跳转至详情页查看。考虑到Fabric SQL服务实际的情况，提供的接口方法所需要的参数和PEP 249官方标准中可能存在差异，请以本手册中描述为准。 表2符合PEP 249标准接口方法概览 | 接口名 | 方法 | 功能描述 | |:---|:---|:---| | [创建连接](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0308.html#ZH-CN_TOPIC_0000002449509836__li070311421160) | FabricSQLConnector.connect | 创建一个连接，返回一个Connection对象。 | | [创建游标](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0309.html#ZH-CN_TOPIC_0000002482789357__li167489196491) | Connection.cursor | 使用该Connection对象创建一个Cursor对象。 | | [关闭连接](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0309.html#ZH-CN_TOPIC_0000002482789357__li5156142645016) | Connection.close | 关闭一个连接。 | | [执行SQL请求](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0310.html#ZH-CN_TOPIC_0000002449669476__li14301015185010) | Cursor.execute | 使用该Cursor对象执行SQL请求。 | | [返回一条数据](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0310.html#ZH-CN_TOPIC_0000002449669476__li513016544813) | Cursor.fetchone | 游标向后移动一行，返回该行数据。 | | [返回剩余数据](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0310.html#ZH-CN_TOPIC_0000002449669476__li11668469110) | Cursor.fetchall | 游标向后移动至结果集行尾，并返回剩余所有行数据。 | | [返回一页Arrow数据](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0310.html#ZH-CN_TOPIC_0000002449669476__li79041324191511) | Cursor.fetchbatch | 当存在Arrow格式结果集时，返回一页数据。 | | [切换下一个结果集](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0310.html#ZH-CN_TOPIC_0000002449669476__li1863391941317) | Cursor.nextset | 游标切换到下一个语句结果集（如果存在）开头。 | | [关闭游标](https://support.huaweicloud.com/sdkreference-fabric/dataartsfabric_sql_04_0310.html#ZH-CN_TOPIC_0000002449669476__li081081117154) | Cursor.close | 关闭该Cursor对象。 |