Доступные версии документации

Пакетная обработка данных
Назначение

Подготовка и выполнение SQL-запроса в режиме пакетной обработки.

Синтаксические правила
cursor.executemany (<SQL-запрос>[,<параметры> … ])

<SQL-запрос> – символьная строка
<параметры>  ::= <опс>
                   <python-элементы типа tuple> |
                   <python-элементы типа list>  |
                   <python-элементы типа dict>
                   <зпс>
<python-элементы типа tuple>::= <окс> tup1,..,tupN <зкс>
<python-элементы типа list>::= <опс> list1,..,listN <зпс>
<python-элементы типа dict>::= <офс> dict1,..,dictN <офс>
N – количество пакетов к обработке.
<окс>::= (
<зкс>::= )
<опс>::= [
<зпс>::= [
<офс>::= {
<зфс>::= }
<tupN> – python-элемент типа tuple (см. спецификацию языка программирования Python)
<listN> – python-элемент типа list (см. спецификацию языка программирования Python)
<dictN> – python-элемент типа dict (см. спецификацию языка программирования Python)
      

Примечание

Синтаксис SQL-запросов (в том числе параметризованных) описан в документе «СУБД ЛИНТЕР. Справочник по SQL» (см. также атрибут paramstyle класса Connection).

Описание

Метод позволяет за один вызов подготовить SQL-запрос и затем выполнить его для всего пакета данных.

Пакет данных представляет собой массив, каждый элемент которого содержит набор значений параметров исполняемого SQL-запроса.

Значения параметров должны быть представлены в одном стиле (смешение разных типов представления не допускается).

Возвращаемое значение

Нет.

Примеры
1) передача параметров в виде python-элементов типа tuple:
cursor.executemany("insert into PEOPLE (ID, NAME) values (?, ?)",
[(1, "BORIS"),
(2, "SASHA")])
2) передача параметров в виде python-элементов типа list:
cursor.executemany("insert into PEOPLE (ID, NAME) values (?, ?)",
[[1, "BORIS"],
[2, "SASHA"]])
3) передача именованных параметров с помощью python-элементов типа dict:
cursor.executemany("insert into PEOPLE (ID, NAME) values (:I, :N)",
[{"I" : 1, "N" : "BORIS"},
{"I" : 2, "N" : "SASHA"}])
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter