`sqlite3.md`

1012 строк · 65.9 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.2/library/sqlite3.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 11.6. [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) – интерфейс DB-API 2.0 для баз данных SQLite89SQLite – это библиотека на C, которая предоставляет легковесную дисковую базу данных, не требующую отдельного серверного процесса, и позволяет обращаться к базе данных с помощью нестандартного варианта языка SQL. Некоторые приложения могут использовать SQLite для внутреннего хранения данных. Также можно создать прототип приложения на SQLite, а затем перенести код на более крупную базу данных, например PostgreSQL или Oracle.1011sqlite3 написан Герхардом Херингом и предоставляет SQL-интерфейс, соответствующий спецификации DB-API 2.0, описанной в [**PEP 249**](https://python-all.ru/3.2/library/sqlite3.html).1213Чтобы использовать модуль, сначала нужно создать объект [`Connection`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection), представляющий базу данных. Здесь данные будут храниться в файле `example.db`:1415```python16import sqlite317conn = sqlite3.connect('example.db')18```1920Можно также указать специальное имя `:memory:`, чтобы создать базу данных в оперативной памяти.2122Когда у вас есть объект [`Connection`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection), можно создать объект [`Cursor`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor) и вызывать его метод [`execute()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.execute) для выполнения SQL-команд:2324```python25c = conn.cursor()2627# Создать таблицу28c.execute('''create table stocks29(date text, trans text, symbol text,30 qty real, price real)''')3132# Вставить строку данных33c.execute("""insert into stocks34          values ('2006-01-05','BUY','RHAT',100,35.14)""")3536# Сохранить (зафиксировать) изменения37conn.commit()3839# Также можно закрыть курсор, если он больше не нужен.40c.close()41```4243Обычно вашим SQL-операциям потребуется использовать значения из переменных Python. Не следует собирать запрос с помощью строковых операций Python, потому что это небезопасно; это делает вашу программу уязвимой для SQL-инъекций.4445Вместо этого используйте подстановку параметров DB-API. Поставьте `?` в качестве заполнителя там, где нужно использовать значение, а затем передайте кортеж значений вторым аргументом методу [`execute()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.execute) курсора. (В других модулях баз данных может использоваться другой заполнитель, например `%s` или `:1`.) Например:4647```python48# Никогда не делайте этого – это небезопасно!49symbol = 'IBM'50c.execute("select * from stocks where symbol = '%s'" % symbol)5152# Вместо этого сделайте так53t = ('IBM',)54c.execute('select * from stocks where symbol=?', t)5556# Более крупный пример57for t in [('2006-03-28', 'BUY', 'IBM', 1000, 45.00),58          ('2006-04-05', 'BUY', 'MSFT', 1000, 72.00),59          ('2006-04-06', 'SELL', 'IBM', 500, 53.00),60         ]:61    c.execute('insert into stocks values (?,?,?,?,?)', t)62```6364Чтобы извлечь данные после выполнения оператора SELECT, можно либо рассматривать курсор как [*итератор*](https://python-all.ru/3.2/glossary.html#term-iterator), вызывать его метод [`fetchone()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.fetchone) для получения одной подходящей строки, либо вызвать [`fetchall()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.fetchall) для получения списка всех подходящих строк.6566В этом примере используется форма итератора:6768```python69>>> c = conn.cursor()70>>> c.execute('select * from stocks order by price')71>>> for row in c:72...     print(row)73...74('2006-01-05', 'BUY', 'RHAT', 100, 35.14)75('2006-03-28', 'BUY', 'IBM', 1000, 45.0)76('2006-04-06', 'SELL', 'IBM', 500, 53.0)77('2006-04-05', 'BUY', 'MSOFT', 1000, 72.0)78>>>79```8081> **См. также**82>83> **[http://code.google.com/p/pysqlite/](https://python-all.ru/3.2/library/sqlite3.html)**84>85> Страница pysqlite – sqlite3 разрабатывается отдельно под названием «pysqlite».86>87> **[http://www.sqlite.org](https://python-all.ru/3.2/library/sqlite3.html)**88>89> Веб-страница SQLite; документация описывает синтаксис и доступные типы данных поддерживаемого диалекта SQL.90>91> **[**PEP 249**](https://python-all.ru/3.2/library/sqlite3.html) – спецификация API баз данных 2.0**92>93> PEP написан Марком-Андре Лембургом.9495## 11.6.1. Функции и константы модуля9697#### `sqlite3.version`9899Номер версии этого модуля в виде строки. Это не версия библиотеки SQLite.100101#### `sqlite3.version_info`102103Номер версии этого модуля в виде кортежа целых чисел. Это не версия библиотеки SQLite.104105#### `sqlite3.sqlite_version`106107Номер версии библиотеки SQLite времени выполнения в виде строки.108109#### `sqlite3.sqlite_version_info`110111Номер версии библиотеки SQLite времени выполнения в виде кортежа целых чисел.112113#### `sqlite3.PARSE_DECLTYPES`114115Эта константа предназначена для использования с параметром *detect\_types* функции [`connect()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.connect).116117Если установить этот флаг, модуль [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) будет анализировать объявленный тип для каждого возвращаемого столбца. Он извлечёт первое слово объявленного типа, например, для «integer primary key» извлечёт «integer», а для «number(10)» – «number». Затем для этого столбца будет выполнен поиск в словаре конвертеров и использована зарегистрированная для этого типа функция преобразования.118119#### `sqlite3.PARSE_COLNAMES`120121Эта константа предназначена для использования с параметром *detect\_types* функции [`connect()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.connect).122123Если установить этот флаг, интерфейс SQLite будет анализировать имя столбца для каждого возвращаемого столбца. Он будет искать строку вида \[mytype\] в имени столбца и затем считать, что «mytype» – это тип столбца. Далее будет выполнена попытка найти запись «mytype» в словаре конвертеров и используется найденная функция преобразования для возврата значения. Имя столбца, полученное из [`Cursor.description`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.description), – это только первое слово имени столбца; то есть если в SQL используется что-то вроде `'as "x [datetime]"'`, то будет извлечено всё до первого пробела: имя столбца будет просто «x».124125#### `sqlite3.connect(database[, timeout, detect_types, isolation_level, check_same_thread, factory, cached_statements])`126127Открывает соединение с файлом базы данных SQLite *database*. Можно использовать `":memory:"`, чтобы открыть соединение с базой данных, расположенной в оперативной памяти, а не на диске.128129Когда к базе данных обращаются несколько соединений и один из процессов изменяет базу данных, база данных SQLite блокируется до завершения этой транзакции. Параметр *timeout* задаёт, как долго соединение должно ждать снятия блокировки, прежде чем возникнет исключение. Значение по умолчанию для параметра timeout – 5.0 (пять секунд).130131По поводу параметра *isolation\_level* обратитесь к свойству [`Connection.isolation_level`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection.isolation_level) объектов [`Connection`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection).132133SQLite изначально поддерживает только типы TEXT, INTEGER, FLOAT, BLOB и NULL. Если вы хотите использовать другие типы, вам необходимо добавить поддержку для них самостоятельно. Параметр *detect\_types* и использование пользовательских **преобразователей**, зарегистрированных с помощью функции модульного уровня [`register_converter()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.register_converter), позволяют легко это сделать.134135Параметр *detect\_types* по умолчанию равен 0 (т.е. выключен, определение типов отключено); его можно установить в любую комбинацию [`PARSE_DECLTYPES`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.PARSE_DECLTYPES) и [`PARSE_COLNAMES`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.PARSE_COLNAMES) для включения определения типов.136137По умолчанию модуль [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) использует для вызова connect() свой класс [`Connection`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection). Однако можно создать подкласс класса [`Connection`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection) и заставить [`connect()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.connect) использовать ваш класс, передав его в параметре *factory*.138139Подробности см. в разделе [*Типы SQLite и Python*](https://python-all.ru/3.2/library/sqlite3.html#sqlite3-types) данного руководства.140141Модуль [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) внутренне использует кеш операторов, чтобы избежать накладных расходов на разбор SQL. Если требуется явно задать количество операторов, кешируемых для соединения, можно установить параметр *cached\_statements*. Текущая реализация по умолчанию кеширует 100 операторов.142143#### `sqlite3.register_converter(typename, callable)`144145Регистрирует вызываемый объект для преобразования байтовой строки из базы данных в пользовательский тип Python. Этот вызываемый объект будет вызываться для всех значений базы данных, имеющих тип *typename*. О том, как работает определение типа, см. параметр *detect\_types* функции [`connect()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.connect). Обратите внимание, что регистр символов в *typename* и имени типа в запросе должны совпадать!146147#### `sqlite3.register_adapter(type, callable)`148149Регистрирует вызываемый объект для преобразования пользовательского типа Python *type* в один из поддерживаемых типов SQLite. Вызываемый объект *callable* принимает в качестве единственного параметра значение Python и должен возвращать значение одного из следующих типов: int, float, str или bytes.150151#### `sqlite3.complete_statement(sql)`152153Возвращает [`True`](https://python-all.ru/3.2/library/constants.html#True), если строка *sql* содержит одно или несколько полных SQL-выражений, завершённых точкой с запятой. При этом не проверяется синтаксическая корректность SQL – только отсутствие незакрытых строковых литералов и наличие точки с запятой в конце каждого выражения.154155Это можно использовать для создания оболочки для SQLite, как в следующем примере:156157```python158# Минимальная оболочка SQLite для экспериментов159160import sqlite3161162con = sqlite3.connect(":memory:")163con.isolation_level = None164cur = con.cursor()165166buffer = ""167168print("Enter your SQL commands to execute in sqlite3.")169print("Enter a blank line to exit.")170171while True:172    line = input()173    if line == "":174        break175    buffer += line176    if sqlite3.complete_statement(buffer):177        try:178            buffer = buffer.strip()179            cur.execute(buffer)180181            if buffer.lstrip().upper().startswith("SELECT"):182                print(cur.fetchall())183        except sqlite3.Error as e:184            print("An error occurred:", e.args[0])185        buffer = ""186187con.close()188```189190#### `sqlite3.enable_callback_tracebacks(flag)`191192По умолчанию никакие трассировки в пользовательских функциях, агрегатах, преобразователях, колбэках авторизатора и т.д. Чтобы их отладить, можно вызвать эту функцию, передав *flag* равным True. После этого трассировки от колбэков будут выводиться в `sys.stderr`. Используйте [`False`](https://python-all.ru/3.2/library/constants.html#False), чтобы снова отключить эту возможность.193194## 11.6.2. Объекты соединения195196#### `class sqlite3.Connection`197198Соединение с базой данных SQLite обладает следующими атрибутами и методами:199200#### `isolation_level`201202Получает или устанавливает текущий уровень изоляции. [`None`](https://python-all.ru/3.2/library/constants.html#None) для режима автокоммита или одно из значений «DEFERRED», «IMMEDIATE» или «EXCLUSIVE». Подробное объяснение приведено в разделе [*Управление транзакциями*](https://python-all.ru/3.2/library/sqlite3.html#sqlite3-controlling-transactions).203204#### `in_transaction`205206[`True`](https://python-all.ru/3.2/library/constants.html#True), если транзакция активна (есть незафиксированные изменения), и [`False`](https://python-all.ru/3.2/library/constants.html#False) в противном случае. Атрибут только для чтения.207208Новое в версии 3.2.209210#### `cursor([cursorClass])`211212Метод cursor принимает один необязательный параметр *cursorClass*. Если он указан, это должен быть пользовательский класс курсора, наследующий от [`sqlite3.Cursor`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor).213214#### `commit()`215216Этот метод фиксирует текущую транзакцию. Если его не вызвать, все изменения, сделанные после последнего вызова `commit()`, не будут видны из других подключений к базе данных. Если вы удивляетесь, почему не видите записанные данные, проверьте, не забыли ли вызвать этот метод.217218#### `rollback()`219220Этот метод откатывает все изменения в базе данных, сделанные после последнего вызова [`commit()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection.commit).221222#### `close()`223224Этот метод закрывает подключение к базе данных. Обратите внимание, что он не вызывает автоматически [`commit()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection.commit). Если просто закрыть подключение без предварительного вызова [`commit()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection.commit), изменения будут потеряны!225226#### `execute(sql[, parameters])`227228Это нестандартный сокращённый метод, который создаёт промежуточный объект курсора вызовом метода cursor, а затем вызывает метод [`execute`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.execute) этого курсора с переданными параметрами.229230#### `executemany(sql[, parameters])`231232Это нестандартный сокращённый метод, который создаёт промежуточный объект курсора вызовом метода cursor, а затем вызывает метод [`executemany`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.executemany) этого курсора с переданными параметрами.233234#### `executescript(sql_script)`235236Это нестандартный сокращённый метод, который создаёт промежуточный объект курсора вызовом метода cursor, а затем вызывает метод [`executescript`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.executescript) этого курсора с переданными параметрами.237238#### `create_function(name, num_params, func)`239240Создаёт пользовательскую функцию, которую затем можно использовать в SQL-выражениях под именем *name*. *num\_params* – количество параметров, принимаемых функцией, а *func* – вызываемый объект Python, который будет вызываться как SQL-функция.241242Функция может возвращать любой из типов, поддерживаемых SQLite: bytes, str, int, float и None.243244Пример:245246```python247import sqlite3248import hashlib249250def md5sum(t):251    return hashlib.md5(t).hexdigest()252253con = sqlite3.connect(":memory:")254con.create_function("md5", 1, md5sum)255cur = con.cursor()256cur.execute("select md5(?)", (b"foo",))257print(cur.fetchone()[0])258```259260#### `create_aggregate(name, num_params, aggregate_class)`261262Создаёт пользовательскую агрегатную функцию.263264Класс агрегатной функции должен реализовывать метод `step`, который принимает количество параметров *num\_params*, и метод `finalize`, который возвращает конечный результат агрегации.265266Метод `finalize` может возвращать любой из типов, поддерживаемых SQLite: bytes, str, int, float и None.267268Пример:269270```python271import sqlite3272273class MySum:274    def __init__(self):275        self.count = 0276277    def step(self, value):278        self.count += value279280    def finalize(self):281        return self.count282283con = sqlite3.connect(":memory:")284con.create_aggregate("mysum", 1, MySum)285cur = con.cursor()286cur.execute("create table test(i)")287cur.execute("insert into test(i) values (1)")288cur.execute("insert into test(i) values (2)")289cur.execute("select mysum(i) from test")290print(cur.fetchone()[0])291```292293#### `create_collation(name, callable)`294295Создаёт collation с указанными *name* и *callable*. Вызываемый объект будет получать два строковых аргумента. Он должен возвращать -1, если первый меньше второго, 0, если они равны, и 1, если первый больше второго. Обратите внимание, что это управляет сортировкой (ORDER BY в SQL), поэтому сравнения не влияют на другие операции SQL.296297Обратите внимание, что вызываемый объект будет получать свои параметры в виде байтовых строк Python, которые обычно закодированы в UTF-8.298299Следующий пример показывает пользовательскую коллацию, которая сортирует «в обратном порядке»:300301```python302import sqlite3303304def collate_reverse(string1, string2):305    if string1 == string2:306        return 0307    elif string1 < string2:308        return 1309    else:310        return -1311312con = sqlite3.connect(":memory:")313con.create_collation("reverse", collate_reverse)314315cur = con.cursor()316cur.execute("create table test(x)")317cur.executemany("insert into test(x) values (?)", [("a",), ("b",)])318cur.execute("select x from test order by x collate reverse")319for row in cur:320    print(row)321con.close()322```323324Чтобы удалить сортировку, вызовите `create_collation` с параметром callable равным None:325326```python327con.create_collation("reverse", None)328```329330#### `interrupt()`331332Этот метод можно вызвать из другого потока, чтобы прервать любые запросы, которые могут выполняться в подключении. Запрос будет прерван, а вызывающий код получит исключение.333334#### `set_authorizer(authorizer_callback)`335336Эта процедура регистрирует колбэк. Колбэк вызывается при каждой попытке доступа к столбцу таблицы в базе данных. Колбэк должен возвращать `SQLITE_OK`, если доступ разрешён, `SQLITE_DENY`, если весь SQL-запрос должен быть прерван с ошибкой, и `SQLITE_IGNORE`, если столбец должен рассматриваться как значение NULL. Эти константы доступны в модуле [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3).337338Первый аргумент колбэка указывает, какой тип операции нужно авторизовать. Второй и третий аргументы будут аргументами или [`None`](https://python-all.ru/3.2/library/constants.html#None) в зависимости от первого аргумента. Четвёртый аргумент – это имя базы данных (например, «main», «temp»), если применимо. Пятый аргумент – это имя самого внутреннего триггера или представления, ответственного за попытку доступа, или [`None`](https://python-all.ru/3.2/library/constants.html#None), если эта попытка доступа происходит напрямую из входного SQL-кода.339340Обратитесь к документации SQLite для получения сведений о возможных значениях первого аргумента и значении второго и третьего аргументов в зависимости от первого. Все необходимые константы доступны в модуле [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3).341342#### `set_progress_handler(handler, n)`343344Эта процедура регистрирует колбэк. Колбэк вызывается каждые *n* инструкций виртуальной машины SQLite. Это полезно, если требуется получать вызовы от SQLite во время длительных операций, например для обновления графического интерфейса.345346Чтобы удалить ранее установленный обработчик хода выполнения, вызовите метод, передав [`None`](https://python-all.ru/3.2/library/constants.html#None) в качестве *handler*.347348#### `enable_load_extension(enabled)`349350Эта процедура разрешает или запрещает механизму SQLite загружать расширения SQLite из разделяемых библиотек. Расширения SQLite могут определять новые функции, агрегатные функции или целые реализации виртуальных таблиц. Одним из известных расширений является расширение полнотекстового поиска, распространяемое с SQLite.351352Загружаемые расширения по умолчанию отключены. См. [\[1\]](https://python-all.ru/3.2/library/sqlite3.html#f1).353354Новое в версии 3.2.355356```python357import sqlite3358359con = sqlite3.connect(":memory:")360361# включить загрузку расширений362con.enable_load_extension(True)363364# Загрузить расширение полнотекстового поиска.365con.execute("select load_extension('./fts3.so')")366367# в качестве альтернативы можно загрузить расширение с помощью вызова API:368# con.load_extension("./fts3.so")369370# снова отключить загрузку расширения371con.enable_load_extension(False)372373# пример из вики SQLite374con.execute("create virtual table recipe using fts3(name, ingredients)")375con.executescript("""376    insert into recipe (name, ingredients) values ('broccoli stew', 'broccoli peppers cheese tomatoes');377    insert into recipe (name, ingredients) values ('pumpkin stew', 'pumpkin onions garlic celery');378    insert into recipe (name, ingredients) values ('broccoli pie', 'broccoli cheese onions flour');379    insert into recipe (name, ingredients) values ('pumpkin pie', 'pumpkin sugar flour butter');380    """)381for row in con.execute("select rowid, name, ingredients from recipe where name match 'pie'"):382    print(row)383```384385#### `load_extension(path)`386387Эта процедура загружает расширение SQLite из разделяемой библиотеки. Перед использованием этой процедуры необходимо включить загрузку расширений с помощью [`enable_load_extension()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection.enable_load_extension).388389Загружаемые расширения по умолчанию отключены. См. [\[1\]](https://python-all.ru/3.2/library/sqlite3.html#f1).390391Новое в версии 3.2.392393#### `row_factory`394395Этот атрибут можно заменить на вызываемый объект, который принимает курсор и исходную строку в виде кортежа и возвращает реальную результирующую строку. Таким образом можно реализовать более продвинутые способы возврата результатов, например возврат объекта, который также может обращаться к столбцам по имени.396397Пример:398399```python400import sqlite3401402def dict_factory(cursor, row):403    d = {}404    for idx, col in enumerate(cursor.description):405        d[col[0]] = row[idx]406    return d407408con = sqlite3.connect(":memory:")409con.row_factory = dict_factory410cur = con.cursor()411cur.execute("select 1 as a")412print(cur.fetchone()["a"])413```414415Если возврата кортежа недостаточно и требуется доступ к столбцам по имени, рассмотрите возможность установки [`row_factory`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection.row_factory) на высокооптимизированный тип [`sqlite3.Row`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Row). [`Row`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Row) предоставляет как доступ по индексу, так и регистронезависимый доступ по имени к столбцам с почти нулевыми накладными расходами памяти. Вероятно, это будет лучше, чем собственное решение на основе словаря или даже решения на основе db\_row.416417#### `text_factory`418419С помощью этого атрибута можно управлять тем, какие объекты возвращаются для типа данных `TEXT`. По умолчанию этот атрибут установлен в [`str`](https://python-all.ru/3.2/library/functions.html#str), и модуль [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) возвращает объекты Unicode для `TEXT`. Если вместо этого нужно возвращать байтовые строки, можно установить его в [`bytes`](https://python-all.ru/3.2/library/functions.html#bytes).420421Из соображений эффективности существует также способ возвращать объекты [`str`](https://python-all.ru/3.2/library/functions.html#str) только для не-ASCII данных, а в остальных случаях – [`bytes`](https://python-all.ru/3.2/library/functions.html#bytes). Чтобы активировать его, установите этот атрибут в `sqlite3.OptimizedUnicode`.422423Также можно установить его в любой другой вызываемый объект, принимающий единственный параметр – байтовую строку и возвращающий результирующий объект.424425См. следующий пример для иллюстрации:426427```python428import sqlite3429430con = sqlite3.connect(":memory:")431cur = con.cursor()432433AUSTRIA = "\xd6sterreich"434435# по умолчанию строки возвращаются как Unicode436cur.execute("select ?", (AUSTRIA,))437row = cur.fetchone()438assert row[0] == AUSTRIA439440# но можно заставить sqlite3 всегда возвращать байтовые строки...441con.text_factory = bytes442cur.execute("select ?", (AUSTRIA,))443row = cur.fetchone()444assert type(row[0]) is bytes445# байтовые строки будут в кодировке UTF-8, если только в базу не попал мусор446# база данных...447assert row[0] == AUSTRIA.encode("utf-8")448449# можно также реализовать собственный text_factory...450# здесь реализован такой, который добавляет "foo" ко всем строкам451con.text_factory = lambda x: x.decode("utf-8") + "foo"452cur.execute("select ?", ("bar",))453row = cur.fetchone()454assert row[0] == "barfoo"455```456457#### `total_changes`458459Возвращает общее количество строк базы данных, которые были изменены, вставлены или удалены с момента открытия подключения к базе данных.460461#### `iterdump`462463Возвращает итератор для дампа базы данных в формате SQL-текста. Полезно при сохранении базы данных в памяти для последующего восстановления. Эта функция предоставляет те же возможности, что и команда `.dump` в оболочке **sqlite3**.464465Пример:466467```python468# Преобразовать файл existing_db.db в SQL-дамп dump.sql469import sqlite3, os470471con = sqlite3.connect('existing_db.db')472with open('dump.sql', 'w') as f:473    for line in con.iterdump():474        f.write('%s\n' % line)475```476477## 11.6.3. Объекты Cursor478479#### `class sqlite3.Cursor`480481Экземпляр [`Cursor`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor) имеет следующие атрибуты и методы.482483#### `execute(sql[, parameters])`484485Выполняет SQL-запрос. Запрос может быть параметризован (т. е. можно использовать плейсхолдеры вместо литералов SQL). Модуль [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) поддерживает два вида плейсхолдеров: вопросительные знаки (стиль qmark) и именованные плейсхолдеры (именованный стиль).486487Вот пример обоих стилей:488489```python490import sqlite3491492con = sqlite3.connect(":memory:")493cur = con.cursor()494cur.execute("create table people (name_last, age)")495496who = "Yeltsin"497age = 72498499# Это стиль qmark:500cur.execute("insert into people values (?, ?)", (who, age))501502# А это именованный стиль:503cur.execute("select * from people where name_last=:who and age=:age", {"who": who, "age": age})504505print(cur.fetchone())506```507508[`execute()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.execute) выполнит только один SQL-оператор. При попытке выполнить с его помощью более одного оператора будет выдано предупреждение. Используйте [`executescript()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.executescript), если требуется выполнить несколько операторов SQL одним вызовом.509510#### `executemany(sql, seq_of_parameters)`511512Выполняет SQL-команду для всех последовательностей параметров или отображений, найденных в последовательности *sql*. Модуль [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) также позволяет использовать [*итератор*](https://python-all.ru/3.2/glossary.html#term-iterator), возвращающий параметры, вместо последовательности.513514```python515import sqlite3516517class IterChars:518    def __init__(self):519        self.count = ord('a')520521    def __iter__(self):522        return self523524    def __next__(self):525        if self.count > ord('z'):526            raise StopIteration527        self.count += 1528        return (chr(self.count - 1),) # это кортеж из одного элемента529530con = sqlite3.connect(":memory:")531cur = con.cursor()532cur.execute("create table characters(c)")533534theIter = IterChars()535cur.executemany("insert into characters(c) values (?)", theIter)536537cur.execute("select c from characters")538print(cur.fetchall())539```540541Вот более короткий пример с использованием [*генератора*](https://python-all.ru/3.2/glossary.html#term-generator):542543```python544import sqlite3545import string546547def char_generator():548    for c in string.ascii_lowercase:549        yield (c,)550551con = sqlite3.connect(":memory:")552cur = con.cursor()553cur.execute("create table characters(c)")554555cur.executemany("insert into characters(c) values (?)", char_generator())556557cur.execute("select c from characters")558print(cur.fetchall())559```560561#### `executescript(sql_script)`562563Это нестандартный удобный метод для выполнения нескольких SQL-операторов за один раз. Сначала он выдаёт оператор `COMMIT`, а затем выполняет SQL-скрипт, полученный в качестве параметра.564565*sql\_script* может быть экземпляром [`str`](https://python-all.ru/3.2/library/functions.html#str) или [`bytes`](https://python-all.ru/3.2/library/functions.html#bytes).566567Пример:568569```python570import sqlite3571572con = sqlite3.connect(":memory:")573cur = con.cursor()574cur.executescript("""575    create table person(576        firstname,577        lastname,578        age579    );580581    create table book(582        title,583        author,584        published585    );586587    insert into book(title, author, published)588    values (589        'Dirk Gently''s Holistic Detective Agency',590        'Douglas Adams',591        1987592    );593    """)594```595596#### `fetchone()`597598Извлекает следующую строку результирующего набора запроса, возвращая одну последовательность или [`None`](https://python-all.ru/3.2/library/constants.html#None), когда данные закончились.599600#### `fetchmany(size=cursor.arraysize)`601602Извлекает следующий набор строк результата запроса, возвращая список. Пустой список возвращается, когда строк больше нет.603604Количество строк, извлекаемых за один вызов, задаётся параметром *size*. Если он не указан, количество строк определяется атрибутом arraysize курсора. Метод должен пытаться извлечь столько строк, сколько указано параметром size. Если это невозможно из-за того, что указанное количество строк недоступно, может быть возвращено меньше строк.605606Обратите внимание на вопросы производительности, связанные с параметром *size*. Для оптимальной производительности обычно лучше использовать атрибут arraysize. Если используется параметр *size*, то желательно, чтобы его значение оставалось неизменным от одного вызова [`fetchmany()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.fetchmany) к следующему.607608#### `fetchall()`609610Извлекает все (оставшиеся) строки результата запроса, возвращая список. Обратите внимание, что атрибут arraysize курсора может влиять на производительность этой операции. Пустой список возвращается, если строк нет.611612#### `rowcount`613614Хотя класс [`Cursor`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor) модуля [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) реализует этот атрибут, собственная поддержка определения «затронутых строк»/«выбранных строк» в движке базы данных отличается непредсказуемостью.615616Для инструкций [`executemany()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.executemany) количество изменений суммируется в [`rowcount`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.rowcount).617618Согласно требованиям спецификации Python DB API, атрибут [`rowcount`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.rowcount) «равен -1, если для курсора не выполнялся `executeXX()` или количество строк последней операции не может быть определено интерфейсом». Это включает инструкции `SELECT`, поскольку мы не можем определить количество строк, возвращаемых запросом, пока не будут получены все строки.619620В версиях SQLite до 3.6.5 атрибут [`rowcount`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.rowcount) устанавливается в 0, если выполнить `DELETE FROM table` без условия.621622#### `lastrowid`623624Этот доступный только для чтения атрибут возвращает rowid последней изменённой строки. Он устанавливается только в том случае, если с помощью метода [`execute()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.execute) был выполнен оператор `INSERT`. Для операций, отличных от `INSERT`, или при вызове [`executemany()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.executemany), значение [`lastrowid`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.lastrowid) устанавливается равным [`None`](https://python-all.ru/3.2/library/constants.html#None).625626#### `description`627628Этот атрибут только для чтения возвращает имена столбцов последнего запроса. Для совместимости с Python DB API он возвращает для каждого столбца кортеж из 7 элементов, где последние шесть элементов каждого кортежа равны [`None`](https://python-all.ru/3.2/library/constants.html#None).629630Он также устанавливается для инструкций `SELECT`, даже если не найдено ни одной строки.631632## 11.6.4. Объекты Row633634#### `class sqlite3.Row`635636Экземпляр [`Row`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Row) служит высокооптимизированной [`row_factory`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection.row_factory) для объектов [`Connection`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection). По большинству своих характеристик он имитирует кортеж.637638Он поддерживает доступ по имени столбца и индексу (как отображение), итерацию, представление, проверку на равенство и [`len()`](https://python-all.ru/3.2/library/functions.html#len).639640Если у двух объектов [`Row`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Row) одинаковые столбцы и их элементы равны, то эти объекты считаются равными.641642#### `keys()`643644Этот метод возвращает кортеж имён столбцов. Сразу после выполнения запроса он становится первым элементом каждого кортежа в [`Cursor.description`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor.description).645646Предположим, мы инициализируем таблицу, как в приведённом выше примере:647648```python649conn = sqlite3.connect(":memory:")650c = conn.cursor()651c.execute('''create table stocks652(date text, trans text, symbol text,653 qty real, price real)''')654c.execute("""insert into stocks655          values ('2006-01-05','BUY','RHAT',100,35.14)""")656conn.commit()657c.close()658```659660Теперь подключаем [`Row`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Row):661662```python663>>> conn.row_factory = sqlite3.Row664>>> c = conn.cursor()665>>> c.execute('select * from stocks')666<sqlite3.Cursor object at 0x7f4e7dd8fa80>667>>> r = c.fetchone()668>>> type(r)669<class 'sqlite3.Row'>670>>> tuple(r)671('2006-01-05', 'BUY', 'RHAT', 100.0, 35.14)672>>> len(r)6735674>>> r[2]675'RHAT'676>>> r.keys()677['date', 'trans', 'symbol', 'qty', 'price']678>>> r['qty']679100.0680>>> for member in r:681...     print(member)682...6832006-01-05684BUY685RHAT686100.068735.14688```689690## 11.6.5. SQLite и типы Python691692### 11.6.5.1. Введение693694SQLite изначально поддерживает следующие типы: `NULL`, `INTEGER`, `REAL`, `TEXT`, `BLOB`.695696Следующие типы Python можно передавать в SQLite без каких-либо проблем:697698| Тип Python | Тип SQLite |699| --- | --- |700| [`None`](https://python-all.ru/3.2/library/constants.html#None) | `NULL` |701| [`int`](https://python-all.ru/3.2/library/functions.html#int) | `INTEGER` |702| [`float`](https://python-all.ru/3.2/library/functions.html#float) | `REAL` |703| [`str`](https://python-all.ru/3.2/library/functions.html#str) | `TEXT` |704| [`bytes`](https://python-all.ru/3.2/library/functions.html#bytes) | `BLOB` |705706Так по умолчанию типы SQLite преобразуются в типы Python:707708| Тип SQLite | Тип Python |709| --- | --- |710| `NULL` | [`None`](https://python-all.ru/3.2/library/constants.html#None) |711| `INTEGER` | [`int`](https://python-all.ru/3.2/library/functions.html#int) |712| `REAL` | [`float`](https://python-all.ru/3.2/library/functions.html#float) |713| `TEXT` | зависит от text\_factory, по умолчанию str |714| `BLOB` | [`bytes`](https://python-all.ru/3.2/library/functions.html#bytes) |715716Система типов модуля [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) расширяема двумя способами: можно хранить дополнительные типы Python в базе данных SQLite с помощью адаптации объектов, и можно разрешить модулю [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) преобразовывать типы SQLite в другие типы Python с помощью конвертеров.717718### 11.6.5.2. Использование адаптеров для хранения дополнительных типов Python в базах данных SQLite719720Как описывалось ранее, SQLite изначально поддерживает только ограниченный набор типов. Чтобы использовать другие типы Python с SQLite, необходимо **адаптировать** их к одному из поддерживаемых модулем sqlite3 типов для SQLite: NoneType, int, float, str, bytes.721722Модуль [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) использует адаптацию объектов Python, как описано в [**PEP 246**](https://python-all.ru/3.2/library/sqlite3.html) для этого. Протокол, который следует использовать, – `PrepareProtocol`.723724Есть два способа дать модулю [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) возможность адаптировать пользовательский тип Python к одному из поддерживаемых.725726#### 11.6.5.2.1. Адаптация объекта самостоятельно727728Это хороший подход, если вы пишете класс сами. Предположим, у вас есть такой класс:729730```python731class Point:732    def __init__(self, x, y):733        self.x, self.y = x, y734```735736Теперь необходимо сохранить точку в одном столбце SQLite. Сначала нужно выбрать один из поддерживаемых типов для представления точки. Используем str и разделим координаты точкой с запятой. Затем классу нужно дать метод `__conform__(self, протокол)`, который должен возвращать преобразованное значение. Параметр *протокол* будет `PrepareProtocol`.737738```python739import sqlite3740741class Point:742    def __init__(self, x, y):743        self.x, self.y = x, y744745    def __conform__(self, protocol):746        if protocol is sqlite3.PrepareProtocol:747            return "%f;%f" % (self.x, self.y)748749con = sqlite3.connect(":memory:")750cur = con.cursor()751752p = Point(4.0, -3.2)753cur.execute("select ?", (p,))754print(cur.fetchone()[0])755```756757#### 11.6.5.2.2. Регистрация вызываемого адаптера758759Другая возможность – создать функцию, которая преобразует тип в строковое представление, и зарегистрировать её с помощью [`register_adapter()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.register_adapter).760761```python762import sqlite3763764class Point:765    def __init__(self, x, y):766        self.x, self.y = x, y767768def adapt_point(point):769    return "%f;%f" % (point.x, point.y)770771sqlite3.register_adapter(Point, adapt_point)772773con = sqlite3.connect(":memory:")774cur = con.cursor()775776p = Point(4.0, -3.2)777cur.execute("select ?", (p,))778print(cur.fetchone()[0])779```780781Модуль [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) имеет два адаптера по умолчанию для встроенных типов Python [`datetime.date`](https://python-all.ru/3.2/library/datetime.html#datetime.date) и [`datetime.datetime`](https://python-all.ru/3.2/library/datetime.html#datetime.datetime). Теперь предположим, что мы хотим хранить объекты [`datetime.datetime`](https://python-all.ru/3.2/library/datetime.html#datetime.datetime) не в формате ISO, а в виде временной метки Unix.782783```python784import sqlite3785import datetime786import time787788def adapt_datetime(ts):789    return time.mktime(ts.timetuple())790791sqlite3.register_adapter(datetime.datetime, adapt_datetime)792793con = sqlite3.connect(":memory:")794cur = con.cursor()795796now = datetime.datetime.now()797cur.execute("select ?", (now,))798print(cur.fetchone()[0])799```800801### 11.6.5.3. Преобразование значений SQLite в пользовательские типы Python802803Написание адаптера позволяет отправлять пользовательские типы Python в SQLite. Но чтобы сделать это действительно полезным, нужно обеспечить обратное преобразование из SQLite в Python.804805Вступают конвертеры.806807Вернёмся к классу `Point`. Мы сохранили координаты x и y, разделённые точкой с запятой, в виде строк в SQLite.808809Сначала определим функцию-конвертер, которая принимает строку в качестве параметра и создаёт объект `Point` из неё.810811> **Примечание**812>813> Функции преобразования **всегда** вызываются со строкой, независимо от того, под каким tипом данных значение было отправлено в SQLite.814815```python816def convert_point(s):817    x, y = map(float, s.split(b";"))818    return Point(x, y)819```820821Теперь необходимо сообщить модулю [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3), что выбираемое из базы данных на самом деле является точкой. Есть два способа сделать это:822823- Неявно, через объявленный тип824- Явно, по имени колонки825826Оба способа описаны в разделе [*Функции и константы модуля*](https://python-all.ru/3.2/library/sqlite3.html#sqlite3-module-contents), в записях для констант [`PARSE_DECLTYPES`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.PARSE_DECLTYPES) и [`PARSE_COLNAMES`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.PARSE_COLNAMES).827828Следующий пример иллюстрирует оба подхода.829830```python831import sqlite3832833class Point:834    def __init__(self, x, y):835        self.x, self.y = x, y836837    def __repr__(self):838        return "(%f;%f)" % (self.x, self.y)839840def adapt_point(point):841    return ("%f;%f" % (point.x, point.y)).encode('ascii')842843def convert_point(s):844    x, y = list(map(float, s.split(b";")))845    return Point(x, y)846847# Зарегистрировать адаптер848sqlite3.register_adapter(Point, adapt_point)849850# Зарегистрировать конвертер851sqlite3.register_converter("point", convert_point)852853p = Point(4.0, -3.2)854855#########################856# 1) Использование объявленных типов857con = sqlite3.connect(":memory:", detect_types=sqlite3.PARSE_DECLTYPES)858cur = con.cursor()859cur.execute("create table test(p point)")860861cur.execute("insert into test(p) values (?)", (p,))862cur.execute("select p from test")863print("with declared types:", cur.fetchone()[0])864cur.close()865con.close()866867#######################868# 1) Использование имён столбцов869con = sqlite3.connect(":memory:", detect_types=sqlite3.PARSE_COLNAMES)870cur = con.cursor()871cur.execute("create table test(p)")872873cur.execute("insert into test(p) values (?)", (p,))874cur.execute('select p as "p [point]" from test')875print("with column names:", cur.fetchone()[0])876cur.close()877con.close()878```879880### 11.6.5.4. Стандартные адаптеры и преобразователи881882В модуле datetime есть адаптеры по умолчанию для типов date и datetime. Они отправляются в SQLite как даты/временные метки в формате ISO.883884Конвертеры по умолчанию зарегистрированы под именем “date” для [`datetime.date`](https://python-all.ru/3.2/library/datetime.html#datetime.date) и под именем “timestamp” для [`datetime.datetime`](https://python-all.ru/3.2/library/datetime.html#datetime.datetime).885886Таким образом, в большинстве случаев можно использовать даты и временные метки из Python без лишних усилий. Формат адаптеров также совместим с экспериментальными функциями даты/времени SQLite.887888Следующий пример демонстрирует это.889890```python891import sqlite3892import datetime893894con = sqlite3.connect(":memory:", detect_types=sqlite3.PARSE_DECLTYPES|sqlite3.PARSE_COLNAMES)895cur = con.cursor()896cur.execute("create table test(d date, ts timestamp)")897898today = datetime.date.today()899now = datetime.datetime.now()900901cur.execute("insert into test(d, ts) values (?, ?)", (today, now))902cur.execute("select d, ts from test")903row = cur.fetchone()904print(today, "=>", row[0], type(row[0]))905print(now, "=>", row[1], type(row[1]))906907cur.execute('select current_date as "d [date]", current_timestamp as "ts [timestamp]"')908row = cur.fetchone()909print("current_date", row[0], type(row[0]))910print("current_timestamp", row[1], type(row[1]))911```912913Если временная метка, хранящаяся в SQLite, имеет дробную часть длиннее 6 знаков, её значение будет усечено до микросекундной точности преобразователем временных меток.914915## 11.6.6. Управление транзакциями916917По умолчанию модуль [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) неявно открывает транзакции перед инструкциями языка модификации данных (DML) (т.е. `INSERT`/`UPDATE`/`DELETE`/`REPLACE`) и неявно фиксирует транзакции перед любой другой инструкцией (кроме `SELECT` и вышеупомянутых).918919Поэтому если вы находитесь внутри транзакции и выполняете команду наподобие `CREATE TABLE ...`, `VACUUM`, `PRAGMA`, модуль [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) перед выполнением этой команды неявно выполнит фиксацию. На то есть две причины. Первая – некоторые из этих команд не работают внутри транзакций. Другая причина в том, что sqlite3 необходимо отслеживать состояние транзакции (активна она или нет). Текущее состояние транзакции доступно через атрибут [`Connection.in_transaction`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection.in_transaction) объекта соединения.920921Можно управлять тем, какие именно операторы `BEGIN` sqlite3 выполняет неявно (или не выполнять их вовсе) с помощью параметра *isolation\_level* вызова [`connect()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.connect), или с помощью свойства `isolation_level` соединений.922923Если нужен **режим автокоммита**, установите `isolation_level` в None.924925В противном случае оставьте его по умолчанию, что приведет к простой инструкции “BEGIN”, или установите одно из поддерживаемых уровней изоляции SQLite: “DEFERRED”, “IMMEDIATE” или “EXCLUSIVE”.926927## 11.6.7. Эффективное использование [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3)928929### 11.6.7.1. Использование сокращённых методов930931Используя нестандартные методы `execute()`, `executemany()` и `executescript()` объекта [`Connection`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection), код можно написать более сжато, поскольку не нужно явно создавать (часто избыточные) объекты [`Cursor`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor). Вместо этого объекты [`Cursor`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Cursor) создаются неявно, и эти сокращённые методы возвращают объекты курсоров. Таким образом, можно выполнить оператор `SELECT` и итерироваться по нему напрямую, используя всего один вызов объекта [`Connection`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection).932933```python934import sqlite3935936persons = [937    ("Hugo", "Boss"),938    ("Calvin", "Klein")939    ]940941con = sqlite3.connect(":memory:")942943# Создать таблицу944con.execute("create table person(firstname, lastname)")945946# Заполнить таблицу947con.executemany("insert into person(firstname, lastname) values (?, ?)", persons)948949# Выводит содержимое таблицы.950for row in con.execute("select firstname, lastname from person"):951    print(row)952953print("I just deleted", con.execute("delete from person").rowcount, "rows")954```955956### 11.6.7.2. Доступ к столбцам по имени вместо индекса957958Одна из полезных возможностей модуля [`sqlite3`](https://python-all.ru/3.2/library/sqlite3.html#module-sqlite3) – встроенный класс [`sqlite3.Row`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Row), предназначенный для использования в качестве фабрики строк.959960Строки, обёрнутые этим классом, можно получать как по индексу (как кортежи), так и по имени без учёта регистра:961962```python963import sqlite3964965con = sqlite3.connect(":memory:")966con.row_factory = sqlite3.Row967968cur = con.cursor()969cur.execute("select 'John' as name, 42 as age")970for row in cur:971    assert row[0] == row["name"]972    assert row["name"] == row["nAmE"]973    assert row[1] == row["age"]974    assert row[1] == row["AgE"]975```976977### 11.6.7.3. Использование соединения как менеджера контекста978979Объекты соединения можно использовать как менеджеры контекста, которые автоматически фиксируют или откатывают транзакции. В случае исключения транзакция откатывается; в противном случае транзакция фиксируется:980981```python982import sqlite3983984con = sqlite3.connect(":memory:")985con.execute("create table person (id integer primary key, firstname varchar unique)")986987# При успешном выполнении con.commit() вызывается автоматически.988with con:989    con.execute("insert into person(firstname) values (?)", ("Joe",))990991# con.rollback() вызывается после завершения блока with с исключением,992# исключение все равно возбуждается, и его необходимо перехватить993try:994    with con:995        con.execute("insert into person(firstname) values (?)", ("Joe",))996except sqlite3.IntegrityError:997    print("couldn't add Joe twice")998```9991000## 11.6.8. Типичные проблемы10011002### 11.6.8.1. Многопоточность10031004В старых версиях SQLite были проблемы с совместным использованием соединений между потоками. Именно поэтому модуль Python запрещает совместное использование соединений и курсоров между потоками. Если всё же попытаться это сделать, во время выполнения будет возбуждено исключение.10051006Единственное исключение – вызов метода [`interrupt()`](https://python-all.ru/3.2/library/sqlite3.html#sqlite3.Connection.interrupt), который имеет смысл вызывать только из другого потока.10071008Сноски10091010| \[1\] | *([1](https://python-all.ru/3.2/library/sqlite3.html#id1), [2](https://python-all.ru/3.2/library/sqlite3.html#id2))* Модуль sqlite3 по умолчанию не собирается с поддержкой загружаемых расширений, поскольку на некоторых платформах (в частности Mac OS X) библиотеки SQLite скомпилированы без этой возможности. Чтобы получить поддержку загружаемых расширений, необходимо передать параметр –enable-loadable-sqlite-extensions программе configure. |1011| --- | --- |1012