Доступные версии документации

Атрибуты и методы класса Cursor

Объекты класса Cursor представляют курсор СУБД, используемый для управления контекстом операции выборки.

Атрибуты класса

Доступные атрибуты класса приведены в таблице 2.

Таблица 2. Атрибуты курсора
Имя атрибутаТип доступаЗначение атрибута
description read-only

Описание столбцов запроса выборки данных в виде массива:

(<описание столбца1>) (<описание столбца2>)…

Элемент массива имеет следующую структуру:

  • name – имя столбца;

  • type_code – тип данных столбца (анализируется путем сравнения с объектами типа);

  • display_size – длина отображаемого значения (для строковых значений);

  • display_size – длина отображаемого значения (для строковых значений);

  • precision – точность (для вещественных значений);

  • scale – масштаб (для вещественных значений);

  • null_ok – допустимость NULL-значений (1 – да, 0 – нет).

Пример:

[('CHARS_COL', <type 'STRING'>, 20, 20, 0, 0, 1),
 ('VARCHARS_COL', <type 'STRING'>, 20, 20, 0, 0, 1)]
rowcount read-only

Количество реально обработанных строк:

  • выбранных (в SQL-запросах типа SELECT);

  • модифицированных (в SQL-запросах типа UPDATE, INSERT) последним вызовом executeXXX();

  • удаленных (в SQL-запросах типа DELETE).

Атрибут принимает значение -1 в случае, если над курсором не выполнен ни один вызов executeXXX() или если Python-интерфейс не может определить количество обработанных строк в последнем выполненном SQL-запросе.

arraysize read/write Количество строк, выбираемых с помощью метода fetchmany() за один вызов. Если не установлено, по умолчанию равно 1
mode read-only Уровень изоляции курсорных транзакций
name read/write Имя курсора для операций c конструкцией WHERE CURRENT OF
statement read-only Текст SQL-запроса, оттранслированного с помощью метода prepare() или выполненного с помощью метода execute()
connection read-only Ссылка на соединение, от которого создан курсор
channelid read-only Идентификатор соединения

Примечание

Атрибут объекта курсора description возвращает информацию о каждом из столбцов результата запроса. Код типа type_code должен быть проверен на равенство одному из типов python-объектов. Объекты типа могут быть равны более чем одному коду типа (например, DATETIME может быть равен кодам типа для столбцов даты, времени и временной метки).

Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter