mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 18:29:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

gh-100021: Document that sqlite3's executemany() discards resulting rows (#103939)

Browse source
This commit is contained in:
Erlend E. Aasland 2023-04-28 10:02:23 +02:00 • committed by GitHub
parent 52cedc5c10
commit 30216b69a2
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

11
Doc/library/sqlite3.rst
View file

@ -1530,12 +1530,12 @@ Cursor objects
For every item in *parameters*, For every item in *parameters*,
repeatedly execute the :ref:`parameterized <sqlite3-placeholders>` repeatedly execute the :ref:`parameterized <sqlite3-placeholders>`
SQL statement *sql*. :abbr:`DML (Data Manipulation Language)` SQL statement *sql*.
Uses the same implicit transaction handling as :meth:`~Cursor.execute`. Uses the same implicit transaction handling as :meth:`~Cursor.execute`.
:param str sql: :param str sql:
A single SQL :abbr:`DML (Data Manipulation Language)` statement. A single SQL DML statement.
:param parameters: :param parameters:
An :term:`!iterable` of parameters to bind with An :term:`!iterable` of parameters to bind with
@ -1558,6 +1558,13 @@ Cursor objects
# cur is an sqlite3.Cursor object # cur is an sqlite3.Cursor object
cur.executemany("INSERT INTO data VALUES(?)", rows) cur.executemany("INSERT INTO data VALUES(?)", rows)
.. note::
Any resulting rows are discarded,
including DML statements with `RETURNING clauses`_.
.. _RETURNING clauses: https://www.sqlite.org/lang_returning.html
.. deprecated-removed:: 3.12 3.14 .. deprecated-removed:: 3.12 3.14
:exc:`DeprecationWarning` is emitted if :exc:`DeprecationWarning` is emitted if