Интерфейс модуля
Здесь необходимо сказать о том, что должен предоставлять модуль для удовлетворения требований DB-API 2.0.
Доступ к базе данных осуществляется с помощью объекта-соединения (connection object). DB-API-совместимый модуль должен предоставлять функцию-конструктор connect() для класса объектов-соединений. Конструктор должен иметь следующие именованные параметры:
- dsn Название источника данных в виде строки
- user Имя пользователя
- password Пароль
- host Адрес хоста, на котором работает СУБД
- database Имя базы данных.
Методы объекта-соединения будут рассмотрены чуть позже.
Модуль определяет константы, содержащие его основные характеристики:
- apilevel Версия DB-API ("1.0" или "2.0").
- threadsafety Целочисленная константа, описывающая возможности модуля при использовании потоков управления:
- 0 Модуль не поддерживает потоки.
- 1 Потоки могут совместно использовать модуль, но не соединения.
- 2 Потоки могут совместно использовать модуль и соединения.
- 3 Потоки могут совместно использовать модуль, соединения и курсоры. (Под совместным использованием здесь понимается возможность использования упомянутых ресурсов без применения семафоров).
- paramstyle Тип используемых пометок при подстановке параметров. Возможны следующие значения этой константы:
- "format" Форматирование в стиле языка ANSI C (например, "%s", "%i").
- "pyformat" Использование именованных спецификаторов формата в стиле Python ("%(item)s")
- "qmark" Использование знаков "?" для пометки мест подстановки параметров.
- "numeric" Использование номеров позиций (":1").
- "named" Использование имен подставляемых параметров (":name").
Модуль должен определять ряд исключений для обозначения типичных исключительных ситуаций: Warning (предупреждение), Error (ошибка), InterfaceError (ошибка интерфейса), DatabaseError (ошибка, относящаяся к базе данных). А также подклассы этого последнего исключения: DataError (ошибка обработки данных), OperationalError (ошибка в работе или сбой соединения с базой данных), IntegrityError (ошибка целостности базы данных), InternalError (внутренняя ошибка базы данных), ProgrammingError (программная ошибка, например, ошибка в синтаксисе SQL-запроса), NotSupportedError (при отсутствии поддержки запрошенного свойства).
