remote/sqlite-utils
1
0
Fork 0
mirror of https://github.com/simonw/sqlite-utils.git synced 2026-07-23 09:24:31 +02:00
Code Issues Projects Releases Packages Wiki Activity

docs: clarify insert() commit behavior in API reference

Browse source
This commit is contained in:
Rami Abdelrazzaq 2026-03-06 17:50:45 -06:00
commit b330cf6d92
1 changed files with 6 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

6
docs/python-api.rst
View file

@ -528,6 +528,12 @@ You can also specify a primary key by passing the ``pk=`` parameter to the ``.in
After inserting a row like this, the ``dogs.last_rowid`` property will return the SQLite ``rowid`` assigned to the most recently inserted record.
.. note::
``.insert()`` and ``.insert_all()`` commit writes in batches (``.insert()`` writes one-row batches).
If you are manually controlling transactions using a SQLite connection context manager, calling these methods
may commit earlier than expected.
The ``dogs.last_pk`` property will return the last inserted primary key value, if you specified one. This can be very useful when writing code that creates foreign keys or many-to-many relationships.
.. _python_api_custom_columns: