句法:
cursor = cnx.cursor([arg=value[, arg=value]...])
MySQLCursor()
此方法根据传递的参数
返回一个对象或其子类。返回的对象是一个cursor.CursorBase
实例。有关游标对象的更多信息,请参阅
第 6.9.5 节,“cursor.MySQLCursor 类”和
第 6.9.6 节,“子类 cursor.MySQLCursor”。
可以将参数传递给该cursor()
方法以控制要创建的游标类型:
如果
buffered
是True
,则游标在执行操作后从服务器获取所有行。这在查询返回小结果集时很有用。buffered
可以单独使用,也可以与dictionary
ornamed_tuple
参数结合使用。buffered
也可以传递给connect()
为从连接对象创建的所有游标设置默认缓冲模式。请参阅 第 6.7.1 节,“连接器/Python 连接参数”。有关缓冲影响的信息,请参阅 第 6.9.6.1 节,“cursor.MySQLCursorBuffered Class”。
如果
raw
是True
,则游标在获取行时会跳过从 MySQL 数据类型到 Python 类型的转换。原始游标通常用于获得更好的性能或当你想自己进行转换时。raw
也可以传递给connect()
为从连接对象创建的所有游标设置默认原始模式。请参阅 第 6.7.1 节,“连接器/Python 连接参数”。如果
dictionary
是True
,则游标将行作为字典返回。此参数从 Connector/Python 2.0.0 开始可用。如果
named_tuple
是True
,则游标将行作为命名元组返回。此参数从 Connector/Python 2.0.0 开始可用。如果
prepared
是True
,则游标用于执行准备好的语句。此参数从 Connector/Python 1.1.2 开始可用。从 Connector/Python 8.0.17 开始,C 扩展支持这一点。该
cursor_class
参数可用于传递用于实例化新游标的类。它必须是 的子类cursor.CursorBase
。
返回的对象取决于参数的组合。例子:
如果没有缓冲而不是原始的:
MySQLCursor
如果缓冲而不是原始的:
MySQLCursorBuffered
如果没有缓冲和原始:
MySQLCursorRaw
如果缓冲和原始:
MySQLCursorBufferedRaw