Python pymysql 获取查询结果字段名及元数据的方法

南乔

发布时间：2026-10-13| 3人浏览过

原创

本文介绍在 Python 中使用 pymysql 库执行 SQL 查询后，如何获取返回结果的字段列表。通过解析 pymysql 源码，指出 cursor.description 属性可直接提供字段信息，无需额外处理。同时说明利用 cur.rowcount 可快速获取记录数，避免使用 len() 函数。

前言

在使用 fetchall() 或 fetchone() 获取查询结果时，pymysql 返回的数据并不直接包含字段名称信息，这与某些其他语言（如 PHP）的体验不同。经过对 pymysql 源码的查阅，发现获取字段信息的过程实际上非常直接，只需访问 cursor.description 属性即可。

具体实现示例如下：

db = pymysql.connect(...)
cur = db.cursor()
cur.execute(sql)
print(cur.description)
result = cur.fetchall()
data_dict=[]
for field in cur.description:
 data_dict.append(field[0])
print(data_dict)

在 pymysql 的源码文件 pymysql/cursors.py 中，查看 class Cursor 的定义，可以看到相关的代码结构：

def __init__(self, connection):
 self.connection = connection
 self.description = None
 self.rownumber = 0
 self.rowcount = -1
 self.arraysize = 1
 self._executed = None
 self._result = None
 self._rows = None
 self._warnings_handled = False

因此，通过访问 cur.rowcount 属性，可以迅速获取查询结果中的记录数量，无需再通过 len() 函数来计算长度。

总结

以上内容即为关于 pymysql 获取字段列表及元数据的核心要点。希望本文能帮助大家解决相关开发中的疑问。如有任何问题，欢迎留言交流，感谢支持。