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

Optional second argument to .lookup() to populate extra columns, closes #339

Browse source
This commit is contained in:
Simon Willison 2021-11-14 18:01:56 -08:00
commit 54a2269e91
3 changed files with 53 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

10
docs/python-api.rst
View file

@ -824,6 +824,16 @@ If you pass in a dictionary with multiple values, both values will be used to in
})
})
The ``.lookup()`` method has an optional second argument which can be used to populate other columns in the table but only if the row does not exist yet. These columns will not be included in the unique index.
To create a species record with a note on when it was first seen, you can use this:
.. code-block:: python
db["Species"].lookup({"name": "Palm"}, {"first_seen": "2021-03-04"})
The first time this is called the record will be created for ``name="Palm"``. Any subsequent calls with that name will ignore the second argument, even if it includes different values.
.. _python_api_extracts:
Populating lookup tables automatically during insert/upsert