`sqlite3.md`

1088 строк · 72.1 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.5/library/sqlite3.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 12.6. [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) – DB-API 2.0 интерфейс для баз данных SQLite89**Исходный код:** [Lib/sqlite3/](https://python-all.ru/src/3.5/Lib/sqlite3)1011---1213SQLite – это библиотека на C, которая предоставляет легковесную дисковую базу данных, не требующую отдельного серверного процесса, и позволяет обращаться к базе данных с помощью нестандартного варианта языка SQL. Некоторые приложения могут использовать SQLite для внутреннего хранения данных. Также можно создать прототип приложения на SQLite, а затем перенести код на более крупную базу данных, например PostgreSQL или Oracle.1415Модуль sqlite3 написан Герхардом Харингом. Он предоставляет SQL-интерфейс, соответствующий спецификации DB-API 2.0, описанной в [**PEP 249**](https://python-all.ru/3.5/library/sqlite3.html).1617Чтобы использовать модуль, сначала необходимо создать объект [`Connection`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection), который представляет базу данных. Здесь данные будут храниться в файле `example.db`:1819```python20import sqlite321conn = sqlite3.connect('example.db')22```2324Также можно указать специальное имя `:memory:` для создания базы данных в оперативной памяти.2526После получения [`Connection`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection) можно создать объект [`Cursor`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor) и вызвать его метод [`execute()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.execute) для выполнения SQL-команд:2728```python29c = conn.cursor()3031# Создать таблицу32c.execute('''CREATE TABLE stocks33             (date text, trans text, symbol text, qty real, price real)''')3435# Вставить строку данных36c.execute("INSERT INTO stocks VALUES ('2006-01-05','BUY','RHAT',100,35.14)")3738# Сохранить (зафиксировать) изменения39conn.commit()4041# Также можно закрыть соединение, если работа с ним завершена.42# Все изменения должны быть зафиксированы, иначе они будут потеряны.43conn.close()44```4546Сохранённые данные являются постоянными и доступны в последующих сеансах:4748```python49import sqlite350conn = sqlite3.connect('example.db')51c = conn.cursor()52```5354Обычно в SQL-операциях требуется использовать значения из переменных Python. Не следует собирать запрос с помощью строковых операций Python, потому что это небезопасно; это делает программу уязвимой для атак SQL-инъекций (см. [https://xkcd.com/327/](https://python-all.ru/3.5/library/sqlite3.html) – забавный пример того, что может пойти не так).5556Вместо этого используется подстановка параметров DB-API. `?` ставится в качестве заполнителя там, где требуется значение, после чего кортеж значений передаётся вторым аргументом методу [`execute()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.execute) курсора. (Другие модули баз данных могут использовать другой заполнитель, например `%s` или `:1`.) Например:5758```python59# Никогда не делайте этого – это небезопасно!60symbol = 'RHAT'61c.execute("SELECT * FROM stocks WHERE symbol = '%s'" % symbol)6263# Вместо этого сделайте так64t = ('RHAT',)65c.execute('SELECT * FROM stocks WHERE symbol=?', t)66print(c.fetchone())6768# Более крупный пример, вставляющий много записей за один раз69purchases = [('2006-03-28', 'BUY', 'IBM', 1000, 45.00),70             ('2006-04-05', 'BUY', 'MSFT', 1000, 72.00),71             ('2006-04-06', 'SELL', 'IBM', 500, 53.00),72            ]73c.executemany('INSERT INTO stocks VALUES (?,?,?,?,?)', purchases)74```7576Чтобы получить данные после выполнения запроса SELECT, можно либо рассматривать курсор как [итератор](https://python-all.ru/3.5/glossary.html#term-iterator), вызвать метод [`fetchone()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.fetchone) курсора для получения одной подходящей строки, либо вызвать [`fetchall()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.fetchall) для получения списка подходящих строк.7778В этом примере используется форма итератора:7980```python81>>> for row in c.execute('SELECT * FROM stocks ORDER BY price'):82        print(row)8384('2006-01-05', 'BUY', 'RHAT', 100, 35.14)85('2006-03-28', 'BUY', 'IBM', 1000, 45.0)86('2006-04-06', 'SELL', 'IBM', 500, 53.0)87('2006-04-05', 'BUY', 'MSFT', 1000, 72.0)88```8990> **См. также**91>92> **[https://github.com/ghaering/pysqlite](https://python-all.ru/3.5/library/sqlite3.html)**93>94> Страница pysqlite – sqlite3 разрабатывается отдельно под названием «pysqlite».95>96> **[https://www.sqlite.org](https://python-all.ru/3.5/library/sqlite3.html)**97>98> Веб-страница SQLite; документация описывает синтаксис и доступные типы данных поддерживаемого диалекта SQL.99>100> **[http://www.w3schools.com/sql/](https://python-all.ru/3.5/library/sqlite3.html)**101>102> Учебные материалы, справочник и примеры для изучения синтаксиса SQL.103>104> **[**PEP 249**](https://python-all.ru/3.5/library/sqlite3.html) – спецификация API баз данных 2.0**105>106> PEP написан Марком-Андре Лембургом.107108## 12.6.1. Функции и константы модуля109110#### `sqlite3.version`111112Номер версии этого модуля в виде строки. Это не версия библиотеки SQLite.113114#### `sqlite3.version_info`115116Номер версии этого модуля в виде кортежа целых чисел. Это не версия библиотеки SQLite.117118#### `sqlite3.sqlite_version`119120Номер версии библиотеки SQLite времени выполнения в виде строки.121122#### `sqlite3.sqlite_version_info`123124Номер версии библиотеки SQLite времени выполнения в виде кортежа целых чисел.125126#### `sqlite3.PARSE_DECLTYPES`127128Эта константа предназначена для использования с параметром *detect\_types* функции [`connect()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.connect).129130Установка этого флага заставляет модуль [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) анализировать объявленный тип для каждого возвращаемого столбца. Он выделит первое слово объявленного типа, т. е. для «integer primary key» выделит «integer», а для «number(10)» выделит «number». Затем для этого столбца он заглянет в словарь преобразователей и использует зарегистрированную там функцию преобразования для этого типа.131132#### `sqlite3.PARSE_COLNAMES`133134Эта константа предназначена для использования с параметром *detect\_types* функции [`connect()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.connect).135136Установка этого параметра заставляет интерфейс SQLite разбирать имена столбцов для каждого столбца, который он возвращает. Он будет искать строку вида \[mytype\] и на основании этого определять, что 'mytype' – это тип столбца. Затем он попытается найти запись 'mytype' в словаре конвертеров и использовать найденную функцию-конвертер для возврата значения. Имя столбца, найденное в [`Cursor.description`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.description), – это только первое слово имени столбца; то есть если используется что-то вроде `'as "x [datetime]"'` в SQL, то будет извлечено всё до первого пробела: именем столбца будет просто "x".137138#### `sqlite3.connect(database[, timeout, detect_types, isolation_level, check_same_thread, factory, cached_statements, uri])`139140Открывает соединение с файлом базы данных SQLite *database*. Можно использовать `":memory:"` для открытия соединения с базой данных, которая находится в оперативной памяти, вместо файла на диске.141142Когда к базе данных обращаются несколько соединений и один из процессов изменяет базу данных, база данных SQLite блокируется до завершения этой транзакции. Параметр *timeout* задаёт, как долго соединение должно ждать снятия блокировки, прежде чем возникнет исключение. Значение по умолчанию для параметра timeout – 5.0 (пять секунд).143144По поводу параметра *isolation\_level* обратитесь к свойству [`isolation_level`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.isolation_level) объектов [`Connection`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection).145146SQLite изначально поддерживает только типы TEXT, INTEGER, REAL, BLOB и NULL. Если вы хотите использовать другие типы, необходимо добавить поддержку самостоятельно. Параметр *detect\_types* и использование пользовательских **преобразователей**, зарегистрированных с помощью функции модуля [`register_converter()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.register_converter), позволяют легко это сделать.147148*detect\_types* по умолчанию равен 0 (т.е. выключен, определение типов не выполняется). Вы можете установить его в любую комбинацию [`PARSE_DECLTYPES`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.PARSE_DECLTYPES) и [`PARSE_COLNAMES`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.PARSE_COLNAMES), чтобы включить определение типов.149150По умолчанию *check\_same\_thread* равен [`True`](https://python-all.ru/3.5/library/constants.html#True), и только создавший поток может использовать соединение. Если установлено [`False`](https://python-all.ru/3.5/library/constants.html#False), возвращаемое соединение может использоваться несколькими потоками. При использовании нескольких потоков с одним соединением операции записи должны быть сериализованы пользователем во избежание повреждения данных.151152По умолчанию модуль [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) использует свой класс [`Connection`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection) для вызова connect. Однако вы можете создать подкласс класса [`Connection`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection) и заставить [`connect()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.connect) использовать ваш класс, передав его в параметре *factory*.153154Подробности см. в разделе [Типы SQLite и Python](https://python-all.ru/3.5/library/sqlite3.html#sqlite3-types) данного руководства.155156Модуль [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) внутренне использует кэш операторов для снижения накладных расходов на разбор SQL. Если вы хотите явно задать количество операторов, кэшируемых для соединения, можно установить параметр *cached\_statements*. Текущая реализация по умолчанию кэширует 100 операторов.157158Если *uri* равно true, *database* интерпретируется как URI. Это позволяет задавать параметры. Например, чтобы открыть базу данных в режиме только для чтения, можно использовать:159160```python161db = sqlite3.connect('file:path/to/database?mode=ro', uri=True)162```163164Дополнительную информацию об этой возможности, включая список распознаваемых параметров, можно найти в [документации SQLite URI](https://python-all.ru/3.5/library/sqlite3.html).165166Изменено в версии 3.4: Добавлен параметр *uri*.167168#### `sqlite3.register_converter(typename, callable)`169170Регистрирует вызываемый объект для преобразования байтовой строки из базы данных в пользовательский тип Python. Вызываемый объект будет вызываться для всех значений базы данных, имеющих тип *typename*. Обратитесь к параметру *detect\_types* функции [`connect()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.connect) для понимания работы определения типов. Обратите внимание: регистр *typename* и имени типа в запросе должен совпадать!171172#### `sqlite3.register_adapter(type, callable)`173174Регистрирует вызываемый объект для преобразования пользовательского типа Python *type* в один из поддерживаемых типов SQLite. Вызываемый объект *callable* принимает в качестве единственного параметра значение Python и должен возвращать значение одного из следующих типов: int, float, str или bytes.175176#### `sqlite3.complete_statement(sql)`177178Возвращает [`True`](https://python-all.ru/3.5/library/constants.html#True), если строка *sql* содержит одно или несколько полных SQL-выражений, завершающихся точкой с запятой. При этом не проверяется синтаксическая корректность SQL, только отсутствие незакрытых строковых литералов и завершение выражения точкой с запятой.179180Это можно использовать для создания оболочки для SQLite, как в следующем примере:181182```python183# Минимальная оболочка SQLite для экспериментов184185import sqlite3186187con = sqlite3.connect(":memory:")188con.isolation_level = None189cur = con.cursor()190191buffer = ""192193print("Enter your SQL commands to execute in sqlite3.")194print("Enter a blank line to exit.")195196while True:197    line = input()198    if line == "":199        break200    buffer += line201    if sqlite3.complete_statement(buffer):202        try:203            buffer = buffer.strip()204            cur.execute(buffer)205206            if buffer.lstrip().upper().startswith("SELECT"):207                print(cur.fetchall())208        except sqlite3.Error as e:209            print("An error occurred:", e.args[0])210        buffer = ""211212con.close()213```214215#### `sqlite3.enable_callback_tracebacks(flag)`216217По умолчанию трассировки не отображаются для пользовательских функций, агрегатов, преобразователей, колбэков авторизатора и т.д. Для отладки можно вызвать эту функцию, установив для *flag* значение `True`. После этого трассировки будут отображаться из колбэков на `sys.stderr`. Используйте [`False`](https://python-all.ru/3.5/library/constants.html#False), чтобы снова отключить эту возможность.218219## 12.6.2. Объекты соединения220221#### `class sqlite3.Connection`222223Соединение с базой данных SQLite обладает следующими атрибутами и методами:224225#### `isolation_level`226227Возвращает или задаёт текущий уровень изоляции. [`None`](https://python-all.ru/3.5/library/constants.html#None) для режима автоподтверждения или одно из значений «DEFERRED», «IMMEDIATE» или «EXCLUSIVE». Подробное объяснение см. в разделе [Управление транзакциями](https://python-all.ru/3.5/library/sqlite3.html#sqlite3-controlling-transactions).228229#### `in_transaction`230231[`True`](https://python-all.ru/3.5/library/constants.html#True), если транзакция активна (есть незафиксированные изменения), иначе [`False`](https://python-all.ru/3.5/library/constants.html#False). Атрибут только для чтения.232233Новое в версии 3.2.234235#### `cursor(factory=Cursor)`236237Метод cursor принимает один необязательный параметр *factory*. Если он указан, это должен быть вызываемый объект, возвращающий экземпляр [`Cursor`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor) или его подклассов.238239#### `commit()`240241Этот метод фиксирует текущую транзакцию. Если не вызвать этот метод, все изменения, сделанные после последнего вызова `commit()`, не будут видны из других подключений к базе данных. Если вы не видите данные, которые записали в базу, проверьте, не забыли ли вызвать этот метод.242243#### `rollback()`244245Этот метод откатывает все изменения в базе данных, сделанные после последнего вызова [`commit()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.commit).246247#### `close()`248249Это закрывает подключение к базе данных. Обратите внимание, что это не вызывает автоматически [`commit()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.commit). Если просто закрыть подключение к базе данных, не вызвав предварительно [`commit()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.commit), изменения будут потеряны!250251#### `execute(sql[, parameters])`252253Это нестандартное сокращение, которое создаёт объект курсора вызовом метода [`cursor()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.cursor), затем вызывает метод [`execute()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.execute) курсора с переданными *параметрами* и возвращает курсор.254255#### `executemany(sql[, parameters])`256257Это нестандартное сокращение, которое создаёт объект курсора вызовом метода [`cursor()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.cursor), затем вызывает метод [`executemany()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.executemany) курсора с переданными *параметрами* и возвращает курсор.258259#### `executescript(sql_script)`260261Это нестандартное сокращение, которое создаёт объект курсора вызовом метода [`cursor()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.cursor), затем вызывает метод [`executescript()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.executescript) курсора с переданным *sql\_script* и возвращает курсор.262263#### `create_function(name, num_params, func)`264265Создаёт пользовательскую функцию, которую затем можно использовать в SQL-выражениях под именем функции *name*. *num\_params* – количество параметров, которые принимает функция (если *num\_params* равно -1, функция может принимать любое количество аргументов), а *func* – это вызываемый объект Python, который вызывается как SQL-функция.266267Функция может возвращать любой из типов, поддерживаемых SQLite: bytes, str, int, float и `None`.268269Пример:270271```python272import sqlite3273import hashlib274275def md5sum(t):276    return hashlib.md5(t).hexdigest()277278con = sqlite3.connect(":memory:")279con.create_function("md5", 1, md5sum)280cur = con.cursor()281cur.execute("select md5(?)", (b"foo",))282print(cur.fetchone()[0])283```284285#### `create_aggregate(name, num_params, aggregate_class)`286287Создаёт пользовательскую агрегатную функцию.288289Класс агрегата должен реализовывать метод `step`, который принимает количество параметров *num\_params* (если *num\_params* равно -1, функция может принимать любое количество аргументов), и метод `finalize`, который возвращает окончательный результат агрегата.290291Метод `finalize` может возвращать любой из типов, поддерживаемых SQLite: bytes, str, int, float и `None`.292293Пример:294295```python296import sqlite3297298class MySum:299    def __init__(self):300        self.count = 0301302    def step(self, value):303        self.count += value304305    def finalize(self):306        return self.count307308con = sqlite3.connect(":memory:")309con.create_aggregate("mysum", 1, MySum)310cur = con.cursor()311cur.execute("create table test(i)")312cur.execute("insert into test(i) values (1)")313cur.execute("insert into test(i) values (2)")314cur.execute("select mysum(i) from test")315print(cur.fetchone()[0])316```317318#### `create_collation(name, callable)`319320Создаёт collation с указанными *name* и *callable*. Вызываемый объект будет получать два строковых аргумента. Он должен возвращать -1, если первый меньше второго, 0, если они равны, и 1, если первый больше второго. Обратите внимание, что это управляет сортировкой (ORDER BY в SQL), поэтому сравнения не влияют на другие операции SQL.321322Обратите внимание, что вызываемый объект будет получать свои параметры в виде байтовых строк Python, которые обычно закодированы в UTF-8.323324Следующий пример показывает пользовательскую коллацию, которая сортирует «в обратном порядке»:325326```python327import sqlite3328329def collate_reverse(string1, string2):330    if string1 == string2:331        return 0332    elif string1 < string2:333        return 1334    else:335        return -1336337con = sqlite3.connect(":memory:")338con.create_collation("reverse", collate_reverse)339340cur = con.cursor()341cur.execute("create table test(x)")342cur.executemany("insert into test(x) values (?)", [("a",), ("b",)])343cur.execute("select x from test order by x collate reverse")344for row in cur:345    print(row)346con.close()347```348349Чтобы удалить коллацию, вызовите `create_collation` с `None` в качестве вызываемого объекта:350351```python352con.create_collation("reverse", None)353```354355#### `interrupt()`356357Этот метод можно вызвать из другого потока, чтобы прервать любые запросы, которые могут выполняться в подключении. Запрос будет прерван, а вызывающий код получит исключение.358359#### `set_authorizer(authorizer_callback)`360361Эта процедура регистрирует колбэк. Колбэк вызывается при каждой попытке доступа к столбцу таблицы в базе данных. Колбэк должен возвращать `SQLITE_OK`, если доступ разрешён, `SQLITE_DENY`, если весь SQL-запрос должен быть прерван с ошибкой, и `SQLITE_IGNORE`, если столбец должен рассматриваться как значение NULL. Эти константы доступны в модуле [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3).362363Первый аргумент колбэка указывает, какой тип операции требуется авторизовать. Второй и третий аргументы будут аргументами или [`None`](https://python-all.ru/3.5/library/constants.html#None) в зависимости от первого аргумента. Четвёртый аргумент – имя базы данных («main», «temp» и т.д.), если применимо. Пятый аргумент – имя самого внутреннего триггера или представления, ответственного за попытку доступа, или [`None`](https://python-all.ru/3.5/library/constants.html#None), если эта попытка доступа происходит непосредственно из входного SQL-кода.364365Обратитесь к документации SQLite за возможными значениями первого аргумента и значением второго и третьего аргументов в зависимости от первого. Все необходимые константы доступны в модуле [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3).366367#### `set_progress_handler(handler, n)`368369Эта процедура регистрирует колбэк. Колбэк вызывается каждые *n* инструкций виртуальной машины SQLite. Это полезно, если требуется получать вызовы от SQLite во время длительных операций, например для обновления графического интерфейса.370371Чтобы очистить ранее установленный обработчик прогресса, вызовите метод с [`None`](https://python-all.ru/3.5/library/constants.html#None) для *handler*.372373#### `set_trace_callback(trace_callback)`374375Регистрирует *trace\_callback*, который будет вызываться для каждого SQL-выражения, фактически выполняемого серверной частью SQLite.376377Единственный аргумент, передаваемый колбэку, – это выполняемый оператор (в виде строки). Возвращаемое значение колбэка игнорируется. Обратите внимание, что бэкенд выполняет не только операторы, переданные методам [`Cursor.execute()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.execute). Другие источники включают управление транзакциями модуля Python и выполнение триггеров, определённых в текущей базе данных.378379Передача [`None`](https://python-all.ru/3.5/library/constants.html#None) в качестве *trace\_callback* отключает трассировочный колбэк.380381Новое в версии 3.3.382383#### `enable_load_extension(enabled)`384385Эта процедура разрешает или запрещает механизму SQLite загружать расширения SQLite из разделяемых библиотек. Расширения SQLite могут определять новые функции, агрегатные функции или целые реализации виртуальных таблиц. Одним из известных расширений является расширение полнотекстового поиска, распространяемое с SQLite.386387Загружаемые расширения по умолчанию отключены. См. [\[1\]](https://python-all.ru/3.5/library/sqlite3.html#f1).388389Новое в версии 3.2.390391```python392import sqlite3393394con = sqlite3.connect(":memory:")395396# включить загрузку расширений397con.enable_load_extension(True)398399# Загрузить расширение полнотекстового поиска.400con.execute("select load_extension('./fts3.so')")401402# в качестве альтернативы можно загрузить расширение с помощью вызова API:403# con.load_extension("./fts3.so")404405# снова отключить загрузку расширения406con.enable_load_extension(False)407408# пример из вики SQLite409con.execute("create virtual table recipe using fts3(name, ingredients)")410con.executescript("""411    insert into recipe (name, ingredients) values ('broccoli stew', 'broccoli peppers cheese tomatoes');412    insert into recipe (name, ingredients) values ('pumpkin stew', 'pumpkin onions garlic celery');413    insert into recipe (name, ingredients) values ('broccoli pie', 'broccoli cheese onions flour');414    insert into recipe (name, ingredients) values ('pumpkin pie', 'pumpkin sugar flour butter');415    """)416for row in con.execute("select rowid, name, ingredients from recipe where name match 'pie'"):417    print(row)418```419420#### `load_extension(path)`421422Эта процедура загружает расширение SQLite из разделяемой библиотеки. Перед использованием этой процедуры необходимо включить загрузку расширений с помощью [`enable_load_extension()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.enable_load_extension).423424Загружаемые расширения по умолчанию отключены. См. [\[1\]](https://python-all.ru/3.5/library/sqlite3.html#f1).425426Новое в версии 3.2.427428#### `row_factory`429430Этот атрибут можно заменить на вызываемый объект, который принимает курсор и исходную строку в виде кортежа и возвращает реальную результирующую строку. Таким образом можно реализовать более продвинутые способы возврата результатов, например возврат объекта, который также может обращаться к столбцам по имени.431432Пример:433434```python435import sqlite3436437def dict_factory(cursor, row):438    d = {}439    for idx, col in enumerate(cursor.description):440        d[col[0]] = row[idx]441    return d442443con = sqlite3.connect(":memory:")444con.row_factory = dict_factory445cur = con.cursor()446cur.execute("select 1 as a")447print(cur.fetchone()["a"])448```449450Если возврата кортежа недостаточно и требуется доступ к столбцам по имени, рассмотрите возможность установки [`row_factory`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.row_factory) в высокооптимизированный тип [`sqlite3.Row`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Row). [`Row`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Row) обеспечивает как доступ по индексу, так и регистронезависимый доступ по имени с почти нулевыми накладными расходами памяти. Вероятно, это будет лучше, чем собственное решение на основе словаря или даже на основе db\_row.451452#### `text_factory`453454С помощью этого атрибута можно управлять тем, какие объекты возвращаются для типа данных `TEXT`. По умолчанию этот атрибут имеет значение [`str`](https://python-all.ru/3.5/library/stdtypes.html#str), и модуль [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) возвращает объекты Unicode для `TEXT`. Если вместо этого нужно возвращать байтовые строки, можно установить значение [`bytes`](https://python-all.ru/3.5/library/functions.html#bytes).455456Также можно установить его в любой другой вызываемый объект, принимающий единственный параметр – байтовую строку и возвращающий результирующий объект.457458См. следующий пример для иллюстрации:459460```python461import sqlite3462463con = sqlite3.connect(":memory:")464cur = con.cursor()465466AUSTRIA = "\xd6sterreich"467468# по умолчанию строки возвращаются как Unicode469cur.execute("select ?", (AUSTRIA,))470row = cur.fetchone()471assert row[0] == AUSTRIA472473# но можно заставить sqlite3 всегда возвращать байтовые строки...474con.text_factory = bytes475cur.execute("select ?", (AUSTRIA,))476row = cur.fetchone()477assert type(row[0]) is bytes478# байтовые строки будут в кодировке UTF-8, если только в базу не попал мусор479# база данных...480assert row[0] == AUSTRIA.encode("utf-8")481482# можно также реализовать собственный text_factory...483# здесь реализован такой, который добавляет "foo" ко всем строкам484con.text_factory = lambda x: x.decode("utf-8") + "foo"485cur.execute("select ?", ("bar",))486row = cur.fetchone()487assert row[0] == "barfoo"488```489490#### `total_changes`491492Возвращает общее количество строк базы данных, которые были изменены, вставлены или удалены с момента открытия подключения к базе данных.493494#### `iterdump()`495496Возвращает итератор для дампа базы данных в текстовом формате SQL. Полезно при сохранении базы данных в памяти для последующего восстановления. Эта функция предоставляет те же возможности, что и команда `.dump` в оболочке **sqlite3**.497498Пример:499500```python501# Преобразовать файл existing_db.db в SQL-дамп dump.sql502import sqlite3503504con = sqlite3.connect('existing_db.db')505with open('dump.sql', 'w') as f:506    for line in con.iterdump():507        f.write('%s\n' % line)508```509510## 12.6.3. Объекты курсора511512#### `class sqlite3.Cursor`513514Экземпляр [`Cursor`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor) имеет следующие атрибуты и методы.515516#### `execute(sql[, parameters])`517518Выполняет SQL-выражение. SQL-выражение может быть параметризованным (т. е. с использованием плейсхолдеров вместо литералов SQL). Модуль [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) поддерживает два вида плейсхолдеров: вопросительные знаки (стиль qmark) и именованные плейсхолдеры (именованный стиль).519520Вот пример обоих стилей:521522```python523import sqlite3524525con = sqlite3.connect(":memory:")526cur = con.cursor()527cur.execute("create table people (name_last, age)")528529who = "Yeltsin"530age = 72531532# Это стиль qmark:533cur.execute("insert into people values (?, ?)", (who, age))534535# А это именованный стиль:536cur.execute("select * from people where name_last=:who and age=:age", {"who": who, "age": age})537538print(cur.fetchone())539```540541[`execute()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.execute) выполняет только одно SQL-выражение. При попытке выполнить с его помощью несколько выражений будет вызвано исключение [`Warning`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Warning). Используйте [`executescript()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.executescript), если нужно выполнить несколько SQL-выражений одним вызовом.542543#### `executemany(sql, seq_of_parameters)`544545Выполняет SQL-команду для всех последовательностей параметров или отображений, найденных в последовательности *seq\_of\_parameters*. Модуль [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) также позволяет использовать [итератор](https://python-all.ru/3.5/glossary.html#term-iterator), возвращающий параметры, вместо последовательности.546547```python548import sqlite3549550class IterChars:551    def __init__(self):552        self.count = ord('a')553554    def __iter__(self):555        return self556557    def __next__(self):558        if self.count > ord('z'):559            raise StopIteration560        self.count += 1561        return (chr(self.count - 1),) # это кортеж из одного элемента562563con = sqlite3.connect(":memory:")564cur = con.cursor()565cur.execute("create table characters(c)")566567theIter = IterChars()568cur.executemany("insert into characters(c) values (?)", theIter)569570cur.execute("select c from characters")571print(cur.fetchall())572```573574Вот более короткий пример с использованием [генератора](https://python-all.ru/3.5/glossary.html#term-generator):575576```python577import sqlite3578import string579580def char_generator():581    for c in string.ascii_lowercase:582        yield (c,)583584con = sqlite3.connect(":memory:")585cur = con.cursor()586cur.execute("create table characters(c)")587588cur.executemany("insert into characters(c) values (?)", char_generator())589590cur.execute("select c from characters")591print(cur.fetchall())592```593594#### `executescript(sql_script)`595596Это нестандартный удобный метод для выполнения нескольких SQL-выражений за один раз. Сначала он выполняет оператор `COMMIT`, а затем выполняет SQL-скрипт, переданный в качестве параметра.597598*sql\_script* может быть экземпляром [`str`](https://python-all.ru/3.5/library/stdtypes.html#str).599600Пример:601602```python603import sqlite3604605con = sqlite3.connect(":memory:")606cur = con.cursor()607cur.executescript("""608    create table person(609        firstname,610        lastname,611        age612    );613614    create table book(615        title,616        author,617        published618    );619620    insert into book(title, author, published)621    values (622        'Dirk Gently''s Holistic Detective Agency',623        'Douglas Adams',624        1987625    );626    """)627```628629#### `fetchone()`630631Извлекает следующую строку результата запроса, возвращая одну последовательность или [`None`](https://python-all.ru/3.5/library/constants.html#None), если данные закончились.632633#### `fetchmany(size=cursor.arraysize)`634635Извлекает следующий набор строк результата запроса, возвращая список. Пустой список возвращается, когда строк больше нет.636637Количество строк, извлекаемых за один вызов, задаётся параметром *size*. Если он не указан, количество строк определяется атрибутом arraysize курсора. Метод должен пытаться извлечь столько строк, сколько указано параметром size. Если это невозможно из-за того, что указанное количество строк недоступно, может быть возвращено меньше строк.638639Обратите внимание, что параметр *size* связан с производительностью. Для оптимальной производительности обычно лучше использовать атрибут arraysize. Если используется параметр *size*, рекомендуется сохранять одно и то же значение от одного вызова [`fetchmany()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.fetchmany) к следующему.640641#### `fetchall()`642643Извлекает все (оставшиеся) строки результата запроса, возвращая список. Обратите внимание, что атрибут arraysize курсора может влиять на производительность этой операции. Пустой список возвращается, если строк нет.644645#### `close()`646647Закрывает курсор сейчас (а не при вызове `__del__`).648649Курсор станет непригодным к использованию; будет выброшено исключение [`ProgrammingError`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.ProgrammingError) при любой попытке выполнить операцию с курсором.650651#### `rowcount`652653Хотя класс [`Cursor`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor) модуля [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) реализует этот атрибут, собственная поддержка определения «затронутых строк»/«выбранных строк» в движке базы данных работает непредсказуемо.654655Для выражений [`executemany()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.executemany) количество изменений суммируется в [`rowcount`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.rowcount).656657В соответствии со спецификацией Python DB API, атрибут [`rowcount`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.rowcount) «равен -1, если над курсором не выполнялось `executeXX()` или количество строк последней операции не может быть определено интерфейсом». Это включает выражения `SELECT`, потому что количество строк, полученных запросом, нельзя определить, пока не будут извлечены все строки.658659В SQLite версий до 3.6.5 [`rowcount`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.rowcount) устанавливается в 0, если выполнить `DELETE FROM table` без условия.660661#### `lastrowid`662663Этот атрибут только для чтения возвращает rowid последней изменённой строки. Он устанавливается только при выполнении оператора `INSERT` с помощью метода [`execute()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.execute). Для операций, отличных от `INSERT`, или при вызове [`executemany()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.executemany), [`lastrowid`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.lastrowid) устанавливается в [`None`](https://python-all.ru/3.5/library/constants.html#None).664665#### `arraysize`666667Атрибут чтения/записи, управляющий количеством строк, возвращаемых [`fetchmany()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.fetchmany). Значение по умолчанию – 1, то есть при каждом вызове будет извлечена одна строка.668669#### `description`670671Этот атрибут только для чтения содержит имена столбцов последнего запроса. Для совместимости с Python DB API он возвращает 7-кортеж для каждого столбца, где последние шесть элементов каждого кортежа равны [`None`](https://python-all.ru/3.5/library/constants.html#None).672673Он также устанавливается для операторов `SELECT`, не имеющих подходящих строк.674675#### `connection`676677Этот атрибут только для чтения предоставляет [`Connection`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection) базы данных SQLite, используемый объектом [`Cursor`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor). Объект [`Cursor`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor), созданный вызовом [`con.cursor()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.cursor), будет иметь атрибут [`connection`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.connection), ссылающийся на *con*:678679```python680>>> con = sqlite3.connect(":memory:")681>>> cur = con.cursor()682>>> cur.connection == con683True684```685686## 12.6.4. Объекты строк687688#### `class sqlite3.Row`689690Экземпляр [`Row`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Row) служит высокооптимизированной [`row_factory`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.row_factory) для объектов [`Connection`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection). Он старается имитировать кортеж в большинстве своих возможностей.691692Он поддерживает доступ по имени столбца и индексу, итерацию, представление, проверку равенства и [`len()`](https://python-all.ru/3.5/library/functions.html#len).693694Если два объекта [`Row`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Row) имеют одинаковые столбцы и их члены равны, они считаются равными.695696#### `keys()`697698Этот метод возвращает список имён столбцов. Сразу после запроса это первый элемент каждого кортежа в [`Cursor.description`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor.description).699700Изменено в версии 3.5: Добавлена поддержка срезов.701702Предположим, мы инициализируем таблицу, как в приведённом выше примере:703704```python705conn = sqlite3.connect(":memory:")706c = conn.cursor()707c.execute('''create table stocks708(date text, trans text, symbol text,709 qty real, price real)''')710c.execute("""insert into stocks711          values ('2006-01-05','BUY','RHAT',100,35.14)""")712conn.commit()713c.close()714```715716Теперь подключаем [`Row`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Row):717718```python719>>> conn.row_factory = sqlite3.Row720>>> c = conn.cursor()721>>> c.execute('select * from stocks')722<sqlite3.Cursor object at 0x7f4e7dd8fa80>723>>> r = c.fetchone()724>>> type(r)725<class 'sqlite3.Row'>726>>> tuple(r)727('2006-01-05', 'BUY', 'RHAT', 100.0, 35.14)728>>> len(r)7295730>>> r[2]731'RHAT'732>>> r.keys()733['date', 'trans', 'symbol', 'qty', 'price']734>>> r['qty']735100.0736>>> for member in r:737...     print(member)738...7392006-01-05740BUY741RHAT742100.074335.14744```745746## 12.6.5. Исключения747748#### `exception sqlite3.Warning`749750Подкласс [`Exception`](https://python-all.ru/3.5/library/exceptions.html#Exception).751752#### `exception sqlite3.Error`753754Базовый класс остальных исключений в этом модуле. Он является подклассом [`Exception`](https://python-all.ru/3.5/library/exceptions.html#Exception).755756#### `exception sqlite3.DatabaseError`757758Исключение, вызываемое для ошибок, связанных с базой данных.759760#### `exception sqlite3.IntegrityError`761762Исключение возникает при нарушении реляционной целостности базы данных, например, при неудачной проверке внешнего ключа. Оно является подклассом [`DatabaseError`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.DatabaseError).763764#### `exception sqlite3.ProgrammingError`765766Исключение вызывается при ошибках программирования, например, таблица не найдена или уже существует, синтаксическая ошибка в SQL-запросе, указано неверное количество параметров и т.д. Является подклассом [`DatabaseError`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.DatabaseError).767768## 12.6.6. Типы SQLite и Python769770### 12.6.6.1. Введение771772SQLite изначально поддерживает следующие типы: `NULL`, `INTEGER`, `REAL`, `TEXT`, `BLOB`.773774Следующие типы Python можно передавать в SQLite без каких-либо проблем:775776| Тип Python | Тип SQLite |777| --- | --- |778| [`None`](https://python-all.ru/3.5/library/constants.html#None) | `NULL` |779| [`int`](https://python-all.ru/3.5/library/functions.html#int) | `INTEGER` |780| [`float`](https://python-all.ru/3.5/library/functions.html#float) | `REAL` |781| [`str`](https://python-all.ru/3.5/library/stdtypes.html#str) | `TEXT` |782| [`bytes`](https://python-all.ru/3.5/library/functions.html#bytes) | `BLOB` |783784Так по умолчанию типы SQLite преобразуются в типы Python:785786| Тип SQLite | Тип Python |787| --- | --- |788| `NULL` | [`None`](https://python-all.ru/3.5/library/constants.html#None) |789| `INTEGER` | [`int`](https://python-all.ru/3.5/library/functions.html#int) |790| `REAL` | [`float`](https://python-all.ru/3.5/library/functions.html#float) |791| `TEXT` | зависит от [`text_factory`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.text_factory), по умолчанию [`str`](https://python-all.ru/3.5/library/stdtypes.html#str) |792| `BLOB` | [`bytes`](https://python-all.ru/3.5/library/functions.html#bytes) |793794Система типов модуля [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) расширяема двумя способами: можно хранить дополнительные типы Python в базе данных SQLite с помощью адаптации объектов, а также можно позволить модулю [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) преобразовывать типы SQLite в различные типы Python с помощью конвертеров.795796### 12.6.6.2. Использование адаптеров для хранения дополнительных типов Python в базах данных SQLite797798Как описывалось ранее, SQLite изначально поддерживает только ограниченный набор типов. Чтобы использовать другие типы Python с SQLite, необходимо **адаптировать** их к одному из поддерживаемых модулем sqlite3 типов для SQLite: NoneType, int, float, str, bytes.799800Существует два способа разрешить модулю [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) адаптировать пользовательский тип Python к одному из поддерживаемых.801802#### 12.6.6.2.1. Самостоятельная адаптация объекта803804Это хороший подход, если вы пишете класс сами. Предположим, у вас есть такой класс:805806```python807class Point:808    def __init__(self, x, y):809        self.x, self.y = x, y810```811812Теперь нужно сохранить точку в одном столбце SQLite. Сначала нужно выбрать один из поддерживаемых типов для представления точки. Давайте просто используем str и разделим координаты точкой с запятой. Затем нужно определить в классе метод `__conform__(self, protocol)`, который должен возвращать преобразованное значение. Параметр *протокол* будет равен `PrepareProtocol`.813814```python815import sqlite3816817class Point:818    def __init__(self, x, y):819        self.x, self.y = x, y820821    def __conform__(self, protocol):822        if protocol is sqlite3.PrepareProtocol:823            return "%f;%f" % (self.x, self.y)824825con = sqlite3.connect(":memory:")826cur = con.cursor()827828p = Point(4.0, -3.2)829cur.execute("select ?", (p,))830print(cur.fetchone()[0])831```832833#### 12.6.6.2.2. Регистрация вызываемого адаптера834835Другой вариант – создать функцию, которая преобразует тип в строковое представление, и зарегистрировать её с помощью [`register_adapter()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.register_adapter).836837```python838import sqlite3839840class Point:841    def __init__(self, x, y):842        self.x, self.y = x, y843844def adapt_point(point):845    return "%f;%f" % (point.x, point.y)846847sqlite3.register_adapter(Point, adapt_point)848849con = sqlite3.connect(":memory:")850cur = con.cursor()851852p = Point(4.0, -3.2)853cur.execute("select ?", (p,))854print(cur.fetchone()[0])855```856857Модуль [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) имеет два адаптера по умолчанию для встроенных типов Python [`datetime.date`](https://python-all.ru/3.5/library/datetime.html#datetime.date) и [`datetime.datetime`](https://python-all.ru/3.5/library/datetime.html#datetime.datetime). Теперь предположим, что мы хотим сохранить объекты [`datetime.datetime`](https://python-all.ru/3.5/library/datetime.html#datetime.datetime) не в формате ISO, а в виде временной метки Unix.858859```python860import sqlite3861import datetime862import time863864def adapt_datetime(ts):865    return time.mktime(ts.timetuple())866867sqlite3.register_adapter(datetime.datetime, adapt_datetime)868869con = sqlite3.connect(":memory:")870cur = con.cursor()871872now = datetime.datetime.now()873cur.execute("select ?", (now,))874print(cur.fetchone()[0])875```876877### 12.6.6.3. Преобразование значений SQLite в пользовательские типы Python878879Написание адаптера позволяет отправлять пользовательские типы Python в SQLite. Но чтобы сделать это действительно полезным, нужно обеспечить обратное преобразование из SQLite в Python.880881Вступают конвертеры.882883Вернемся к классу `Point`. Мы сохраняли координаты x и y, разделенные точкой с запятой, в виде строк в SQLite.884885Сначала определим функцию-конвертер, которая принимает строку в качестве параметра и создает из нее объект `Point`.886887> **Примечание**888>889> Функции-конвертеры **всегда** вызываются с объектом [`bytes`](https://python-all.ru/3.5/library/functions.html#bytes), независимо от того, с каким типом данных значение было отправлено в SQLite.890891```python892def convert_point(s):893    x, y = map(float, s.split(b";"))894    return Point(x, y)895```896897Теперь нужно сообщить модулю [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3), что выбираемые из базы данные на самом деле являются точкой. Есть два способа сделать это:898899- Неявно, через объявленный тип900- Явно, по имени колонки901902Оба способа описаны в разделе [Функции и константы модуля](https://python-all.ru/3.5/library/sqlite3.html#sqlite3-module-contents), в записях для констант [`PARSE_DECLTYPES`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.PARSE_DECLTYPES) и [`PARSE_COLNAMES`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.PARSE_COLNAMES).903904Следующий пример иллюстрирует оба подхода.905906```python907import sqlite3908909class Point:910    def __init__(self, x, y):911        self.x, self.y = x, y912913    def __repr__(self):914        return "(%f;%f)" % (self.x, self.y)915916def adapt_point(point):917    return ("%f;%f" % (point.x, point.y)).encode('ascii')918919def convert_point(s):920    x, y = list(map(float, s.split(b";")))921    return Point(x, y)922923# Зарегистрировать адаптер924sqlite3.register_adapter(Point, adapt_point)925926# Зарегистрировать конвертер927sqlite3.register_converter("point", convert_point)928929p = Point(4.0, -3.2)930931#########################932# 1) Использование объявленных типов933con = sqlite3.connect(":memory:", detect_types=sqlite3.PARSE_DECLTYPES)934cur = con.cursor()935cur.execute("create table test(p point)")936937cur.execute("insert into test(p) values (?)", (p,))938cur.execute("select p from test")939print("with declared types:", cur.fetchone()[0])940cur.close()941con.close()942943#######################944# 1) Использование имён столбцов945con = sqlite3.connect(":memory:", detect_types=sqlite3.PARSE_COLNAMES)946cur = con.cursor()947cur.execute("create table test(p)")948949cur.execute("insert into test(p) values (?)", (p,))950cur.execute('select p as "p [point]" from test')951print("with column names:", cur.fetchone()[0])952cur.close()953con.close()954```955956### 12.6.6.4. Адаптеры и преобразователи по умолчанию957958В модуле datetime есть адаптеры по умолчанию для типов date и datetime. Они отправляются в SQLite как даты/временные метки в формате ISO.959960Преобразователи по умолчанию зарегистрированы под именем «date» для [`datetime.date`](https://python-all.ru/3.5/library/datetime.html#datetime.date) и под именем «timestamp» для [`datetime.datetime`](https://python-all.ru/3.5/library/datetime.html#datetime.datetime).961962Таким образом, в большинстве случаев можно использовать даты и временные метки из Python без лишних усилий. Формат адаптеров также совместим с экспериментальными функциями даты/времени SQLite.963964Следующий пример демонстрирует это.965966```python967import sqlite3968import datetime969970con = sqlite3.connect(":memory:", detect_types=sqlite3.PARSE_DECLTYPES|sqlite3.PARSE_COLNAMES)971cur = con.cursor()972cur.execute("create table test(d date, ts timestamp)")973974today = datetime.date.today()975now = datetime.datetime.now()976977cur.execute("insert into test(d, ts) values (?, ?)", (today, now))978cur.execute("select d, ts from test")979row = cur.fetchone()980print(today, "=>", row[0], type(row[0]))981print(now, "=>", row[1], type(row[1]))982983cur.execute('select current_date as "d [date]", current_timestamp as "ts [timestamp]"')984row = cur.fetchone()985print("current_date", row[0], type(row[0]))986print("current_timestamp", row[1], type(row[1]))987```988989Если временная метка, хранящаяся в SQLite, имеет дробную часть длиннее 6 знаков, её значение будет усечено до микросекундной точности преобразователем временных меток.990991## 12.6.7. Управление транзакциями992993По умолчанию модуль [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) неявно начинает транзакции перед инструкцией языка манипулирования данными (DML) (т.е. `INSERT`/`UPDATE`/`DELETE`/`REPLACE`) и неявно фиксирует транзакции перед инструкцией, не являющейся DML и не являющейся запросом (т.е. любой, кроме `SELECT` или упомянутых выше).994995Итак, если вы находитесь в транзакции и выполняете команду, например `CREATE TABLE ...`, `VACUUM`, `PRAGMA`, модуль [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) неявно зафиксирует транзакцию перед выполнением этой команды. Для этого есть две причины. Первая заключается в том, что некоторые из этих команд не работают внутри транзакций. Вторая причина в том, что sqlite3 необходимо отслеживать состояние транзакции (активна ли транзакция или нет). Текущее состояние транзакции доступно через атрибут [`Connection.in_transaction`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.in_transaction) объекта соединения.996997Вы можете управлять тем, какие инструкции `BEGIN` sqlite3 неявно выполняет (или не выполняет вовсе) с помощью параметра *isolation\_level* вызова [`connect()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.connect) или с помощью свойства `isolation_level` соединений.998999Если вам нужен **режим автоматической фиксации**, установите `isolation_level` в `None`.10001001В противном случае оставьте его по умолчанию, что приведет к простой инструкции “BEGIN”, или установите одно из поддерживаемых уровней изоляции SQLite: “DEFERRED”, “IMMEDIATE” или “EXCLUSIVE”.10021003## 12.6.8. Эффективное использование [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3)10041005### 12.6.8.1. Использование сокращенных методов10061007Используя нестандартные методы `execute()`, `executemany()` и `executescript()` объекта [`Connection`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection), код можно писать более кратко, поскольку не нужно явно создавать (часто излишние) объекты [`Cursor`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor). Вместо этого объекты [`Cursor`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Cursor) создаются неявно, и эти сокращенные методы возвращают объекты курсора. Таким образом, можно выполнить оператор `SELECT` и итерироваться по нему напрямую, используя всего один вызов объекта [`Connection`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection).10081009```python1010import sqlite310111012persons = [1013    ("Hugo", "Boss"),1014    ("Calvin", "Klein")1015    ]10161017con = sqlite3.connect(":memory:")10181019# Создать таблицу1020con.execute("create table person(firstname, lastname)")10211022# Заполнить таблицу1023con.executemany("insert into person(firstname, lastname) values (?, ?)", persons)10241025# Выводит содержимое таблицы.1026for row in con.execute("select firstname, lastname from person"):1027    print(row)10281029print("I just deleted", con.execute("delete from person").rowcount, "rows")1030```10311032### 12.6.8.2. Доступ к столбцам по имени вместо индекса10331034Одна из полезных возможностей модуля [`sqlite3`](https://python-all.ru/3.5/library/sqlite3.html#module-sqlite3) – встроенный класс [`sqlite3.Row`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Row), предназначенный для использования в качестве фабрики строк.10351036Строки, обёрнутые этим классом, можно получать как по индексу (как кортежи), так и по имени без учёта регистра:10371038```python1039import sqlite310401041con = sqlite3.connect(":memory:")1042con.row_factory = sqlite3.Row10431044cur = con.cursor()1045cur.execute("select 'John' as name, 42 as age")1046for row in cur:1047    assert row[0] == row["name"]1048    assert row["name"] == row["nAmE"]1049    assert row[1] == row["age"]1050    assert row[1] == row["AgE"]1051```10521053### 12.6.8.3. Использование соединения в качестве контекстного менеджера10541055Объекты соединения можно использовать как менеджеры контекста, которые автоматически фиксируют или откатывают транзакции. В случае исключения транзакция откатывается; в противном случае транзакция фиксируется:10561057```python1058import sqlite310591060con = sqlite3.connect(":memory:")1061con.execute("create table person (id integer primary key, firstname varchar unique)")10621063# При успешном выполнении con.commit() вызывается автоматически.1064with con:1065    con.execute("insert into person(firstname) values (?)", ("Joe",))10661067# con.rollback() вызывается после завершения блока with с исключением,1068# исключение все равно возбуждается, и его необходимо перехватить1069try:1070    with con:1071        con.execute("insert into person(firstname) values (?)", ("Joe",))1072except sqlite3.IntegrityError:1073    print("couldn't add Joe twice")1074```10751076## 12.6.9. Распространенные проблемы10771078### 12.6.9.1. Многопоточность10791080В старых версиях SQLite были проблемы с совместным использованием соединений между потоками. Именно поэтому модуль Python запрещает совместное использование соединений и курсоров между потоками. Если всё же попытаться это сделать, во время выполнения будет возбуждено исключение.10811082Единственное исключение – вызов метода [`interrupt()`](https://python-all.ru/3.5/library/sqlite3.html#sqlite3.Connection.interrupt), который имеет смысл вызывать только из другого потока.10831084Сноски10851086| \[1\] | *([1](https://python-all.ru/3.5/library/sqlite3.html#id1), [2](https://python-all.ru/3.5/library/sqlite3.html#id2))* Модуль sqlite3 по умолчанию не собирается с поддержкой загружаемых расширений, поскольку на некоторых платформах (в частности Mac OS X) библиотеки SQLite скомпилированы без этой возможности. Чтобы получить поддержку загружаемых расширений, необходимо передать параметр –enable-loadable-sqlite-extensions программе configure. |1087| --- | --- |1088