Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Improve sqlite3 documentation of the new autocommit attribute #99435

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 9 commits into from
Closed

Improve sqlite3 documentation of the new autocommit attribute #99435

Changes from 1 commit
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
bb30103
Remove an unnecessary lambda in tests
geryogam Nov 13, 2022
261f21b
Clarify that implicit open or roll back happens in the same method call
geryogam Nov 13, 2022
d864934
Add connect() to the list of implicit-transaction-opening methods
geryogam Nov 21, 2022
8b250c0
Recommend commit() and rollback() in legacy manual commit mode
geryogam Nov 21, 2022
d11dcfb
Clarify PEP-249-compliant vs legacy transaction control
geryogam Nov 21, 2022
3750bf0
Improve wording consistency
geryogam Nov 21, 2022
b9034b1
Remove two ambiguous ‘underlying’
geryogam Nov 13, 2022
55a28c8
Normalize ‘open transaction’
geryogam Nov 13, 2022
6db7b57
Normalize ’transaction control’
geryogam Nov 13, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Recommend commit() and rollback() in legacy manual commit mode
  • Loading branch information
@geryogam
geryogam committed Nov 22, 2022
commit 8b250c05d012f375b5bf8e5bd50acb973e35e4b2
23 changes: 11 additions & 12 deletions Doc/library/sqlite3.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2429,18 +2429,17 @@ transaction behaviour is controlled using
the :attr:`Connection.isolation_level` attribute.
Otherwise, :attr:`!isolation_level` has no effect.

If the connection attribute :attr:`~Connection.isolation_level`
is not ``None``,
new transactions are implicitly opened before
:meth:`~Cursor.execute` and :meth:`~Cursor.executemany` executes
``INSERT``, ``UPDATE``, ``DELETE``, or ``REPLACE`` statements;
for other statements, no implicit transaction handling is performed.
Use the :meth:`~Connection.commit` and :meth:`~Connection.rollback` methods
to respectively commit and roll back pending transactions.
You can choose the underlying `SQLite transaction behaviour`_ —
that is, whether and what type of ``BEGIN`` statements :mod:`!sqlite3`
implicitly executes –
via the :attr:`~Connection.isolation_level` attribute.
If :attr:`~Connection.isolation_level` is not ``None``:

* :meth:`~Cursor.execute` and :meth:`~Cursor.executemany` implicitly open a new
transaction before executing an
``INSERT``, ``UPDATE``, ``DELETE``, or ``REPLACE`` statement;
for other statements, no implicit transaction control is performed.
The type of ``BEGIN`` statement that those methods use for the underlying
`SQLite transaction behaviour`_ can be chosen via the
:attr:`~Connection.isolation_level` attribute.
* Transactions should be explicitly committed using :meth:`!commit`.
* Transactions should be explicitly rolled back using :meth:`!rollback`.

If :attr:`~Connection.isolation_level` is set to ``None``,
no transactions are implicitly opened at all.
Expand Down