psycopg/psycopg2
1
1
Fork 0
mirror of https://github.com/psycopg/psycopg2.git synced 2024-11-28 20:03:43 +03:00
Code Issues Packages Projects Releases Wiki Activity

Add note about sending multiple statements in the same query

Browse Source 
Close #1214
This commit is contained in:
Daniele Varrazzo 2021-05-20 14:00:39 +02:00
parent 19eb047a41
commit 7479e6b31e
1 changed files with 14 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
doc/src/usage.rst
View File

@ -783,6 +783,20 @@ A few other transaction properties can be set session-wide by the
change the isolation level. See the `~connection.set_session()` method for all
the details.
.. note::
When multiple statements are executed in the same query, separated by
semicolon, PostgreSQL wraps them in a transaction. This means that
statements which cannot run in a transaction must be executed separately::
# This doesn't work
cur.execute("DROP DATABASE foo; DROP DATABASE bar;")
If you are wondering why the above works in :program:`psql`, that's
because :program:`psql` parses the queries and splits them on semicolon
before sending them. `!psycopg2` doesn't parse the query, so these
statements must be executed on their own.
.. index::
single: with statement