Вставка строк с помощью ядра¶

Конструкция SQL-выражения insert()¶

Простой пример Insert, иллюстрирующий целевую таблицу и предложение VALUES одновременно:

>>> from sqlalchemy import insert
>>> stmt = insert(user_table).values(name="spongebob", fullname="Spongebob Squarepants")

Приведенная выше переменная stmt является экземпляром Insert. Большинство SQL-выражений можно перевести в строку на месте, чтобы увидеть общую форму того, что получается:

>>> print(stmt)
INSERT INTO user_account (name, fullname) VALUES (:name, :fullname)

Стрингированная форма создается путем создания Compiled формы объекта, которая включает специфическое для базы данных строковое SQL-представление оператора; мы можем получить этот объект непосредственно с помощью метода ClauseElement.compile():

>>> compiled = stmt.compile()

Наша конструкция Insert является примером «параметризованной» конструкции, показанной ранее в Параметры отправки; для просмотра name и fullname bound parameters, они также доступны из конструкции Compiled:

>>> compiled.params
{'name': 'spongebob', 'fullname': 'Spongebob Squarepants'}

Выполнение заявления¶

Вызвав оператор, мы можем INSERT строку в user_table. SQL INSERT, а также связанные параметры можно увидеть в журнале SQL:

>>> with engine.connect() as conn:
...     result = conn.execute(stmt)
...     conn.commit()
BEGIN (implicit)
INSERT INTO user_account (name, fullname) VALUES (?, ?)
[...] ('spongebob', 'Spongebob Squarepants')
COMMIT

В своей простой форме оператор INSERT не возвращает никаких строк, и если вставляется только одна строка, он обычно включает возможность возврата информации о значениях по умолчанию на уровне столбцов, которые были созданы во время INSERT этой строки, чаще всего целочисленное значение первичного ключа. В приведенном выше случае первая строка в базе данных SQLite обычно возвращает 1 для первого целочисленного значения первичного ключа, которое мы можем получить с помощью аксессора CursorResult.inserted_primary_key:

>>> result.inserted_primary_key
(1,)

INSERT обычно генерирует предложение «значения» автоматически¶

В приведенном выше примере использовался метод Insert.values() для явного создания пункта VALUES оператора SQL INSERT. На самом деле этот метод имеет несколько вариантов, которые позволяют использовать специальные формы, такие как несколько строк в одном операторе и вставка выражений SQL. Однако обычный способ использования Insert заключается в том, что предложение VALUES генерируется автоматически из параметров, переданных методу Connection.execute(); ниже мы выполним INSERT еще двух строк, чтобы проиллюстрировать это:

>>> with engine.connect() as conn:
...     result = conn.execute(
...         insert(user_table),
...         [
...             {"name": "sandy", "fullname": "Sandy Cheeks"},
...             {"name": "patrick", "fullname": "Patrick Star"},
...         ],
...     )
...     conn.commit()
BEGIN (implicit)
INSERT INTO user_account (name, fullname) VALUES (?, ?)
[...] (('sandy', 'Sandy Cheeks'), ('patrick', 'Patrick Star'))
COMMIT

Приведенное выше выполнение имеет форму «executemany», впервые показанную в Отправка нескольких параметров, однако, в отличие от использования конструкции text(), нам не пришлось писать SQL. Передавая словарь или список словарей в метод Connection.execute() в сочетании с конструкцией Insert, Connection гарантирует, что переданные имена столбцов будут выражены в предложении VALUES конструкции Insert автоматически.

>>> from sqlalchemy import select, bindparam
>>> scalar_subq = (
...     select(user_table.c.id)
...     .where(user_table.c.name == bindparam("username"))
...     .scalar_subquery()
... )

>>> with engine.connect() as conn:
...     result = conn.execute(
...         insert(address_table).values(user_id=scalar_subq),
...         [
...             {"username": "spongebob", "email_address": "spongebob@sqlalchemy.org"},
...             {"username": "sandy", "email_address": "sandy@sqlalchemy.org"},
...             {"username": "sandy", "email_address": "sandy@squirrelpower.org"},
...         ],
...     )
...     conn.commit()
BEGIN (implicit)
INSERT INTO address (user_id, email_address) VALUES ((SELECT user_account.id
FROM user_account
WHERE user_account.name = ?), ?)
[...] (('spongebob', 'spongebob@sqlalchemy.org'), ('sandy', 'sandy@sqlalchemy.org'),
('sandy', 'sandy@squirrelpower.org'))
COMMIT

ВСТАВИТЬ… ИЗ SELECT¶

Конструкция Insert может составлять INSERT, который получает строки непосредственно из SELECT, используя метод Insert.from_select():

>>> select_stmt = select(user_table.c.id, user_table.c.name + "@aol.com")
>>> insert_stmt = insert(address_table).from_select(
...     ["user_id", "email_address"], select_stmt
... )
>>> print(insert_stmt)
INSERT INTO address (user_id, email_address)
SELECT user_account.id, user_account.name || :name_1 AS anon_1
FROM user_account

ВСТАВКА… ВОЗВРАЩЕНИЕ¶

Предложение RETURNING для поддерживаемых бэкендов используется автоматически для получения последнего вставленного значения первичного ключа, а также значений по умолчанию сервера. Однако условие RETURNING может быть также задано явно с помощью метода Insert.returning(); в этом случае объект Result, возвращаемый при выполнении оператора, содержит строки, которые могут быть извлечены:

>>> insert_stmt = insert(address_table).returning(
...     address_table.c.id, address_table.c.email_address
... )
>>> print(insert_stmt)
INSERT INTO address (id, user_id, email_address)
VALUES (:id, :user_id, :email_address)
RETURNING address.id, address.email_address

Его также можно комбинировать с Insert.from_select(), как в примере ниже, который основан на примере, приведенном в ВСТАВИТЬ… ИЗ SELECT:

>>> select_stmt = select(user_table.c.id, user_table.c.name + "@aol.com")
>>> insert_stmt = insert(address_table).from_select(
...     ["user_id", "email_address"], select_stmt
... )
>>> print(insert_stmt.returning(address_table.c.id, address_table.c.email_address))
INSERT INTO address (user_id, email_address)
SELECT user_account.id, user_account.name || :name_1 AS anon_1
FROM user_account RETURNING address.id, address.email_address