10.2.6 MySQLConnection.cursor() Method — MySQL Connectors 1.0

10.2.6 Метод MySQLConnection.cursor()

Синтаксис:

cursor = cnx.cursor([arg=value[, arg=value]...])

Этот метод возвращает объект MySQLCursor() или подкласс от него в зависимости от переданных аргументов. Возвращаемый объект является экземпляром cursor.CursorBase. Более подробную информацию об объектах курсора см. в разделе 10.5 «Класс cursor.MySQLCursor» и разделе 10.6 «Подклассы cursor.MySQLCursor».

Аргументы могут быть переданы методу cursor() для управления типом создаваемого курсора:

Если buffered равен True, курсор извлекает все строки с сервера после выполнения операции. Это полезно, когда запросы возвращают небольшие наборы результатов. buffered можно использовать самостоятельно или в сочетании с аргументом dictionary или named_tuple.

buffered также можно передать в connect() для установки режима буферизации по умолчанию для всех курсоров, созданных из объекта подключения. См. раздел 7.1 «Аргументы подключения Connector/Python».

Сведения о последствиях буферизации см. в разделе 10.6.1 «Класс cursor.MySQLCursorBuffered».
Если raw равен True, курсор пропускает преобразование типов данных MySQL в типы Python при извлечении строк. Сырой курсор обычно используется для повышения производительности или когда вы хотите выполнить преобразование самостоятельно.

raw также можно передать в connect() для установки режима сырых данных по умолчанию для всех курсоров, созданных из объекта подключения. См. раздел 7.1 «Аргументы подключения Connector/Python».
Если dictionary равен True, курсор возвращает строки в виде словарей. Этот аргумент доступен начиная с Connector/Python 2.0.0.
Если named_tuple равен True, курсор возвращает строки в виде именованных кортежей. Этот аргумент доступен начиная с Connector/Python 2.0.0.
Если prepared равен True, курсор используется для выполнения подготовленных заявок. Этот аргумент доступен начиная с Connector/Python 1.1.2. Расширение C поддерживает это начиная с Connector/Python 8.0.17.
Аргумент cursor_class может быть использован для передачи класса для создания нового курсора. Он должен быть подклассом cursor.CursorBase.

Возвращаемый объект зависит от комбинации аргументов. Примеры:

Если не буферизован и не сырой: MySQLCursor
Если буферизован и не сырой: MySQLCursorBuffered
Если не буферизован и сырой: MySQLCursorRaw
Если буферизован и сырой: MySQLCursorBufferedRaw