Что такое генеративный метод?

Я знаком с генераторами Python, однако я просто натолкнулся на термин "генеративный метод", с которым я не знаком и не могу найти удовлетворительное определение.

Чтобы выразить это в контексте, я нашел термин в описательной документации SQLAlchemy:

Полный контроль над поведением "autocommit" доступен с помощью генераторного метода Connection.execution_options(), предоставленного в Connection, Engine, Executable, с использованием флага "autocommit", который включает или выключает автозапуск для выбранной области.

Что такое генеративный метод? Попытка итерации объекта, возвращаемого Connection.execution_options(), не работает, поэтому я считаю это чем-то отличным от стандартного генератора.

Ответ 1

Он не является общей концепцией базы данных, но SQLAlchemy использует термин генеративный в смысле "сгенерированный вашей программой итеративно во время выполнения". (Таким образом, нет связи с генераторами питона). Пример из учебника:

Объект Query полностью генеративный,, что означает, что большинство вызовов метода возвратите новый объект Query, по которому могут быть добавлены дополнительные критерии. Например, для запроса пользователей с именем "ed" с полным именем "Ed Jones", вы можете дважды вызвать filter(), который объединяет критерии с использованием AND:

>>> for user in session.query(User).\
...   filter(User.name=='ed').\
...   filter(User.fullname=='Ed Jones'):
...     print user

Этот синтаксис вызова более известен как "цепочка методов" и дизайн, который позволяет использовать его как "свободный интерфейс" .

Итак, в случае Connection.execution_options() "генеративный" означает, что он возвращает измененный объект соединения, так что вы можете связать вызовы, как указано выше.

Ответ 2

Посмотрев исходный код Connection.execution_options (lib/sqlalchemy/engine/base.py), все, что делает этот метод, это добавить параметры подключения.

Идея состоит в том, что эти варианты влияют на будущее поведение, например. запросы.

В качестве примера:

        result = connection.execution_options(stream_results=True).\
                            execute(stmt)

Здесь поведение было изменено в середине соединения только для этого запроса. В некотором роде он "генерирует" или клонирует себя как объект, который имеет несколько другое поведение.

Здесь вы также можете установить autocommit в True. Пример

# obtain a connection
connection = ...
# do some stuff
# for the next section we want autocommit on
autocommitting_connection = connection.execution_options(autocommit=True)
autocommitting_connection.execute(some_insert)
result = autocommitting_connection.execute(some_query)
# done with this section. Continue using connection (no autocommit)

Это то, что имеется в виду в этом разделе документации. "Generative method" относится к методу, который возвращает измененную копию того же экземпляра, с которой вы можете продолжить работу. Это применимо к классам Connection, Engine, Executable.

Ответ 3

Вам нужно будет проконсультироваться с конкретной документацией или исходным кодом этого проекта, чтобы действительно убедиться, но я бы предположил, что он возвращает модифицированную версию некоторого объекта, адаптированного к требованиям/поведению, определенным аргументами.

В документации указано:

Метод возвращает копию этого Connection, который ссылается на тот же базовое соединение DBAPI, но также определяет данное выполнение параметры, которые вступят в силу для вызова execute().

Ответ 4

Как и комментарии @zzzeek выше, это теперь задокументировано в SQLAlchemy glossary.

generative означает:

Термин, используемый SQLAlchemy для обозначения того, что обычно называют цепочкой методов; см. этот термин для деталей.

И цепочка методов:

Объектно-ориентированная техника, при которой состояние объекта строится путем вызова методов на объекте. Объект имеет любое количество методов, каждый из которых возвращает новый объект (или, в некоторых случаях, тот же объект) с добавленным дополнительным состоянием объекта.