1.4 Changelog¶

[orm] [bug] ¶

Словарь Session.execute.bind_arguments больше не мутирует при передаче в Session.execute() и подобные; вместо этого он копируется во внутренний словарь при изменении состояния. Помимо прочего, это исправляет проблему, когда «clause», передаваемый методу Session.get_bind(), неправильно ссылался на конструкцию Select, используемую для стратегии синхронизации «fetch», когда фактический запрос был Delete или Update. Это помешало бы рецептам для «сессий маршрутизации».

References: #8614

[orm] [bug] ¶

В конфигурациях ORM выдается предупреждение, когда явная аннотация remote() применяется к столбцам, которые являются локальными для непосредственного сопоставленного класса, когда сопоставленный класс не включает ни одного из тех же столбцов таблицы. В идеале это должно вызывать ошибку в какой-то момент, поскольку это некорректно с точки зрения отображения.

References: #7094

[orm] [bug] ¶

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

References: #7545

[orm] [bug] [regression] ¶

Исправлена регрессия в версии 1.4 в contains_eager(), когда логика «обертывания в подзапрос» в joinedload() непреднамеренно срабатывала при использовании функции contains_eager() с аналогичными утверждениями (например, использующими distinct(), limit() или offset()), что приводило к вторичным проблемам с запросами, использующими некоторые комбинации имен SQL-меток и алиасинга. Такая «обертка» не подходит для contains_eager(), который всегда имел договор о том, что пользовательский SQL-запрос не модифицируется, за исключением добавления соответствующих столбцов для извлечения.

References: #8569

[orm] [bug] [regression] ¶

Исправлена регрессия, при которой использование ORM update() с synchronize_session=“fetch“ приводило к неудаче из-за использования оценщиков, которые теперь используются для определения значения in-Python для выражений в предложении SET при обновлении объектов; если в оценщиках используются математические операторы для нечисловых значений, таких как PostgreSQL JSONB, условие неоценки не будет определено правильно. Теперь оценщик ограничивает использование операторов математической мутации только числовыми типами, за исключением «+», который продолжает работать и для строк. В SQLAlchemy 2.0 это может быть изменено еще больше за счет полного извлечения значений SET вместо использования оценки.

References: #8507

[engine] [bug] ¶

Исправлена проблема, из-за которой смешивание «*» с дополнительными явно именованными выражениями столбцов в пункте columns конструкции select() приводило к тому, что нацеливание на столбец результата иногда считало имя метки или другие неповторяющиеся имена неоднозначной целью.

References: #8536

[asyncio] [bug] ¶

Улучшена реализация asyncio.shield(), используемого в менеджерах контекста, как добавлено в #8145, таким образом, что операция «закрытия» заключена в asyncio.Task, на который затем идет сильная ссылка по мере выполнения операции. Это сделано в соответствии с документацией Python, указывающей, что в противном случае задача не является сильно ссылающейся.

References: #8516

[postgresql] [usecase] ¶

aggregate_order_by теперь поддерживает генерацию кэша.

References: #8574

[mysql] [bug] ¶

Скорректировано регулярное выражение, используемое для соответствия «CREATE VIEW» при тестировании представлений, для более гибкой работы, больше не требуя специального ключевого слова «ALGORITHM» в середине, которое должно было быть необязательным, но работало неправильно. Это изменение позволяет отражению представлений работать более полно на MySQL-совместимых вариантах, таких как StarRocks. Pull request любезно предоставлен Джоном Бодли.

References: #8588

[mssql] [bug] [regression] ¶

Исправлена еще одна регрессия в выборке уровня изоляции SQL Server (см. #8231, #8475), на этот раз с «Microsoft Dynamics CRM Database via Azure Active Directory», в которой, очевидно, полностью отсутствует представление system_views. Отлов ошибок был расширен, чтобы ни при каких обстоятельствах этот метод никогда не давал сбоев, при условии наличия подключения к базе данных.

References: #8525

[orm] [bug] [events] ¶

Исправлена проблема прослушивания событий, когда слушатели событий, добавленные в суперкласс, терялись, если создавался подкласс, который затем имел свои собственные слушатели. Практический пример - класс sessionmaker, созданный после того, как события были ассоциированы с классом Session.

References: #8467

[orm] [bug] ¶

Усилена стратегия кэширования ключей для конструкций aliased() и with_polymorphic(). Хотя проблемы с кэшированием фактических утверждений не могут быть легко продемонстрированы (если вообще могут быть), эти две конструкции не включали в свои ключи кэша достаточно того, что делает их уникальными, чтобы кэширование только по псевдослучайной конструкции было точным.

References: #8401

[orm] [bug] [regression] ¶

Исправлена регрессия, появившаяся в серии 1.4, когда запрос с объединенным наследованием, помещенный в качестве подзапроса во вложенный запрос для той же сущности, не мог корректно отобразить JOIN для внутреннего запроса. Проблема проявлялась двумя разными способами до и после версии 1.4.18 (связанная проблема #6595), в одном случае JOIN отображался дважды, в другом - JOIN полностью терялся. Для решения проблемы условия, при которых применяется «полиморфная загрузка», были изменены таким образом, чтобы они не применялись для простых запросов с объединенным наследованием.

References: #8456

[orm] [bug] ¶

Исправлена проблема в расширении sqlalchemy.ext.mutable, когда ссылки коллекции на родительский объект терялись, если объект был объединен с Session.merge() при одновременной передаче Session.merge.load как False.

References: #8446

[orm] [bug] ¶

Исправлена проблема с with_loader_criteria(), когда переменная закрытия, используемая в качестве значения связанного параметра в лямбде, не переносилась корректно в дополнительные загрузчики отношений, такие как selectinload() и lazyload() после кэширования утверждения, используя вместо этого устаревшее первоначально кэшированное значение.

References: #8399

[sql] [bug] ¶

Исправлена проблема, при которой использование конструкции table(), передающей строку для параметра table.schema, не учитывало строку «schema» при создании ключа кэша, что приводило к коллизии кэширования, если использовалось несколько одноименных конструкций table() с разными схемами.

References: #8441

[asyncio] [bug] ¶

Интегрирована поддержка вызова метода asyncpg terminate() для случаев, когда пул соединений перерабатывает соединение, возможно, завершившееся по таймеру, когда происходит сборка мусора, который не был изящно закрыт, а также когда соединение было признано недействительным. Это позволяет asyncpg отказаться от соединения, не дожидаясь ответа, который может иметь длительный таймаут.

References: #8419

[mssql] [bug] [regression] ¶

Исправлена регрессия, вызванная исправлением для #8231, выпущенным в версии 1.4.40, когда при попытке определить текущий уровень изоляции транзакции соединение не устанавливалось, если у пользователя не было разрешения на запрос системных представлений dm_exec_sessions или dm_pdw_nodes_exec_sessions.

References: #8475

[orm] [bug] ¶

Исправлена проблема, при которой многократное обращение к CTE в сочетании с полиморфным SELECT могло привести к созданию нескольких «клонов» одного и того же CTE, в результате чего эти два CTE считались дубликатами. Для решения этой проблемы два CTE подвергаются глубокому сравнению, когда это происходит, чтобы убедиться, что они эквивалентны, а затем рассматриваются как эквивалентные.

References: #8357

[orm] [bug] ¶

Конструкция select(), которой передается единственный аргумент „*“ для SELECT *, либо через строку, либо через text(), либо через literal_column(), будет интерпретироваться как SQL-оператор уровня Core, а не как оператор уровня ORM. Это делается для того, чтобы * при расширении на любое количество столбцов приводил к возврату всех столбцов в результат. Интерпретация select() на уровне ORM требует предварительного знания имен и типов всех столбцов ORM, чего нельзя достичь при использовании '*'.

Если '* используется среди других выражений одновременно с оператором ORM, возникает ошибка, так как это не может быть правильно интерпретировано ORM.

References: #8235

[orm] [declarative] [bug] ¶

Исправлена проблема, при которой иерархия классов, установленная как абстрактные или декларативные классы mixin, не могла объявить отдельные колонки в суперклассе, которые затем корректно копировались в вызываемую переменную declared_attr, которая хотела использовать их в классе-потомке.

References: #8190

[engine] [usecase] ¶

Реализована новая опция Connection.execution_options.yield_per выполнения для Connection в Core, чтобы отразить ту же самую опцию yield_per, доступную в ORM. Опция устанавливает оба параметра Connection.execution_options.stream_results одновременно с вызовом Result.yield_per(), чтобы обеспечить наиболее распространенную конфигурацию потокового результата, которая также отражает схему использования ORM.

[engine] [bug] ¶

Исправлена ошибка в Result, когда при использовании Connection.execution_options.stream_results не использовалась стратегия буферизованного результата, если используемый диалект не поддерживал явную настройку «курсор на стороне сервера». Это ошибочно, поскольку такие DBAPI, как SQLite и Oracle, уже используют небуферизованную схему получения результатов, которая все еще выигрывает от использования частичной выборки результатов. Теперь стратегия «буферизации» используется во всех случаях, когда установлено значение Connection.execution_options.stream_results.

[engine] [bug] ¶

Добавлено FilterResult.yield_per(), чтобы реализации результата, такие как MappingResult, ScalarResult и AsyncResult, имели доступ к этому методу.

References: #8199

[sql] [bug] ¶

Скорректирована компиляция SQL для функций конкатенации строк .contains(), .startswith(), .endswith(), чтобы заставить использовать оператор конкатенации строк, а не полагаться на перегрузку оператора сложения, так что нестандартное использование этих операторов, например, с байтстрингами, по-прежнему приводит к операторам конкатенации строк.

References: #8253

[mypy] [bug] ¶

Исправлено падение плагина mypy при использовании лямбды в качестве Column по умолчанию. Pull request curtesy of tchapi.

References: #8196

[asyncio] [bug] ¶

Добавлено asyncio.shield() в процесс освобождения соединения и сессии, в частности, в рамках выхода из контекстного менеджера __aexit__(), при использовании AsyncConnection или AsyncSession в качестве контекстного менеджера, который освобождает объект по завершении работы контекстного менеджера. Это, по-видимому, помогает при отмене задачи при использовании альтернативных библиотек параллелизма, таких как anyio, uvloop, которые в противном случае не обеспечивают асинхронный контекст для пула соединений, чтобы правильно освободить соединение при отмене задачи.

References: #8145

[postgresql] [bug] ¶

Исправлена проблема в диалекте psycopg2, когда функция «нескольких хостов», реализованная для #4392, где несколько пар host:port могли быть переданы в строке запроса как ?host=host1:port1&host=host2:port2&host=host3:port3, была реализована неправильно, так как она не распространяла параметр «порт» соответствующим образом. Соединения, которые не использовали другой «порт», скорее всего, работали без проблем, а соединения, которые имели «порт» для некоторых записей, могли неправильно передавать это имя хоста. Теперь формат исправлен, чтобы передавать хосты/порты должным образом.

В рамках этого изменения была сохранена поддержка другого стиля мультихостов, который работал непреднамеренно, а именно разделенных запятыми ?host=h1,h2,h3&port=p1,p2,p3. Этот формат более соответствует формату строк запросов libpq, в то время как предыдущий формат вдохновлен другим аспектом формата URI libpq, но это не совсем то же самое.

Если эти два стиля смешиваются вместе, возникает ошибка, так как это двусмысленно.

References: #4392

[mssql] [bug] ¶

Исправлены проблемы, из-за которых новые шаблоны использования DML с объектами ORM, представленные в Использование INSERT, UPDATE и ON CONFLICT (т.е. upsert) для возврата объектов ORM, не работали корректно с диалектом SQL Server pyodbc.

References: #8210

[mssql] [bug] ¶

Исправлена проблема, при которой запрос диалекта SQL Server на текущий уровень изоляции не выполнялся в Azure Synapse Analytics из-за того, как эта база данных обрабатывает откат транзакций после возникновения ошибки. Начальный запрос был изменен, чтобы больше не полагаться на поимку ошибки при попытке определить соответствующее системное представление. Кроме того, для лучшей поддержки очень специфического поведения «отката» этой базы данных, реализован новый параметр ignore_no_transaction_on_rollback, указывающий, что при откате следует игнорировать ошибку Azure Synapse „Соответствующая транзакция не найдена. (111214)», которая возникает в случае отсутствия транзакции в конфликте с Python DBAPI.

Первоначальный патч и ценная помощь в отладке любезно предоставлены @ww2406.

References: #8231

[bug] [types] ¶

Исправлена проблема, когда оператор TypeDecorator некорректно проксировал оператор __getitem__() при оформлении типа данных ARRAY без явного обходного пути.

References: #7249

[orm] [bug] [regression] ¶

Исправлена регрессия, вызванная #8133, когда формат pickle для изменяемых атрибутов был изменен без отката для распознавания старого формата, что приводило к тому, что обновления SQLAlchemy на месте больше не могли читать pickle-данные из предыдущих версий. Теперь установлена проверка плюс откат для старого формата.

References: #8133

[orm] [bug] [regression] ¶

Исправлена регрессия, вызванная #8064, когда определенная проверка соответствия столбцов была сделана слишком либеральной, что приводило к некорректному отображению для некоторых подзапросов ORM, например, использующих PropComparator.has() или PropComparator.any() в сочетании с запросами с объединенным наследованием, которые также используют унаследованные функции алиасинга.

References: #8162

[orm] [bug] [sql] ¶

Исправлена проблема, при которой GenerativeSelect.fetch() не применялось при выполнении оператора с использованием ORM.

References: #8091

[orm] [bug] ¶

Исправлена проблема, когда опция with_loader_criteria() не могла быть отбираемой, что необходимо, когда она переносится для распространения в ленивые загрузчики в сочетании со схемой кэширования. В настоящее время единственная форма, которая поддерживается как picklable - это передача «where criteria» в виде фиксированной вызываемой функции на уровне модуля, которая производит SQL-выражение. Специальная «лямбда» не может быть пикирована, а объект SQL-выражения обычно не может быть полностью пикирован напрямую.

References: #8109

[engine] [bug] ¶

Исправлен декоратор класса с предупреждением об устаревании, который не позволял ключевым объектам, таким как Connection, иметь правильный атрибут __weakref__, что приводило к ошибкам в операциях, таких как стандартная библиотека Python inspect.getmembers().

References: #8115

[sql] [bug] ¶

Исправлено несколько наблюдаемых условий гонки, связанных с lambda_stmt(), включая начальную проблему «dogpile», когда новый объект кода Python первоначально анализируется в нескольких одновременных потоках, что создавало как проблему производительности, так и некоторое внутреннее повреждение состояния. Кроме того, было исправлено состояние гонки, которое могло возникнуть при «клонировании» конструкции выражения, которая также находится в процессе компиляции или иного доступа в другом потоке из-за мемоизированных атрибутов, изменяющих __dict__ во время итерации, для версий Python до 3.10; в частности, конструкция lambda SQL чувствительна к этому, поскольку она постоянно удерживает один объект оператора. Итерация была усовершенствована, чтобы вместо нее использовать dict.copy() с дополнительной итерацией или без нее.

References: #8098

[sql] [bug] ¶

Усовершенствован механизм Cast и других «обертывающих» конструкций колонок для более полного сохранения обернутой конструкции Label, включая то, что имя метки будет сохранено в коллекции .c коллекции Subquery. Метка уже была способна корректно отображаться в SQL на внешней стороне конструкции, внутри которой она была обернута.

References: #8084

[sql] [bug] ¶

Исправлено исправление, сделанное для #8056, которое корректировало экранирование имен связанных параметров со специальными символами таким образом, что экранированные имена транслировались после шага компиляции SQL, что нарушало опубликованный в FAQ рецепт, иллюстрирующий, как объединить имена параметров в строковый вывод скомпилированной строки SQL. Это изменение восстанавливает экранированные имена, идущие от compiled.params, и добавляет условный параметр к SQLCompiler.construct_params() с именем escape_names, который по умолчанию принимает значение True, восстанавливая старое поведение по умолчанию.

References: #8113

[schema] [bug] ¶

Исправлены ошибки, связанные с параметрами Table.include_columns и Table.resolve_fks на Table; эти малоиспользуемые параметры, очевидно, не работали для столбцов, ссылающихся на ограничения внешнего ключа.

В первом случае не включенные столбцы, ссылающиеся на внешние ключи, все равно будут пытаться создать объект ForeignKey, выдавая ошибки при попытке разрешить столбцы для ограничения внешнего ключа в рамках рефлексии; ограничения внешнего ключа, ссылающиеся на пропущенные столбцы, теперь исключаются из процесса рефлексии таблицы так же, как это происходит для объектов Index и UniqueConstraint с теми же условиями. Однако предупреждение не выдается, так как в версии 2.0 мы, вероятно, захотим убрать предупреждения include_columns для всех ограничений.

В последнем случае создание псевдонимов таблиц или подзапросов будет завершаться неудачей, если FK связанная таблица не найдена, несмотря на наличие resolve_fks=False; логика была исправлена таким образом, что если связанная таблица не найдена, объект ForeignKey по-прежнему проксируется в псевдонимы таблицы или подзапроса (эти объекты ForeignKey обычно используются при создании условий присоединения), но он отправляется с флагом, что он не разрешимый. После этого псевдослужебная таблица / подзапрос будет работать нормально, за исключением того, что она не может быть использована для автоматического создания условия присоединения, поскольку информация о внешнем ключе отсутствует. Такое поведение уже было для подобных ограничений по внешнему ключу, созданных с помощью методов без отражения, например, при соединении Table объектов из разных MetaData коллекций.

References: #8100, #8101

[schema] [bug] [mssql] ¶

Исправлена проблема, при которой объекты Table, использующие столбцы IDENTITY с типом данных Numeric, выдавали ошибки при попытке согласования столбца «autoincrement», не позволяя построить Column с использованием параметра Column.autoincrement, а также выдавая ошибки при попытке вызвать конструкцию Insert.

References: #8111

[extensions] [bug] ¶

Исправлена ошибка в Mutable, когда при пикировке и распикировке отображаемого экземпляра ORM некорректно восстанавливалось состояние для отображений, содержащих несколько включенных атрибутов Mutable.

References: #8133

[orm] [bug] ¶

Исправлена проблема, при которой использование конструкции column_property(), содержащей подзапрос к уже сопоставленному атрибуту столбца, неправильно применяло поведение ORM-компиляции к подзапросу, включая то, что выражение «IN», добавленное для выражения наследования одной таблицы, не включалось.

References: #8064

[orm] [bug] ¶

Исправлена проблема, при которой результаты ORM применяли неправильные имена ключей к возвращаемым объектам Row в случае, когда набор выбираемых столбцов был изменен, например, при использовании Select.with_only_columns().

References: #8001

[orm] [bug] [oracle] [postgresql] ¶

Исправлена ошибка, вероятно, регрессия из версии 1.3, когда использование имен столбцов, требующих экранирования связанных параметров, более конкретно при использовании Oracle с именами столбцов, требующими кавычек, например, начинающихся с подчеркивания, или в менее распространенных случаях с некоторыми драйверами PostgreSQL при использовании имен столбцов, содержащих знаки процента, приводило к некорректной работе функции версионирования ORM, если сам столбец версионирования имел такое имя, поскольку ORM предполагал определенные соглашения об именовании связанных параметров, которым мешали кавычки. Этот выпуск связан с #8053 и по существу пересматривает подход к устранению этой проблемы, пересматривая исходный выпуск #5653, который создал первоначальную реализацию для обобщенного цитирования имен связанных параметров.

References: #8056

[engine] [bug] [tests] ¶

Исправлена проблема, при которой поддержка логирования «stacklevel», реализованная в #7612, требовала настройки для работы с недавно выпущенным Python 3.11.0b1, также исправлены модульные тесты, которые проверяли эту возможность.

References: #8019

[sql] [bug] [postgresql] [sqlite] ¶

Исправлена ошибка, при которой метод PostgreSQL Insert.on_conflict_do_update() и метод SQLite Insert.on_conflict_do_update() не могли правильно разместить столбец с отдельным «.key» при указании столбца по имени ключа в словаре, передаваемом в Insert.on_conflict_do_update.set_, а также при использовании коллекции Insert.excluded непосредственно в качестве словаря.

References: #8014

[sql] [bug] ¶

Информативная ошибка возникает для случая, когда Insert.from_select() передается объект «compound select», такой как UNION, но оператор INSERT должен добавить дополнительные столбцы для поддержки Python-стороны или явных умолчаний SQL из метаданных таблицы. В этом случае следует передать подзапрос составного объекта.

References: #8073

[sql] [bug] ¶

Исправлена проблема, при которой использование bindparam() без явного указания данных или типа могло приводить к неправильному типу при использовании в выражениях, например, при использовании Comparator.any() и Comparator.all().

References: #7979

[sql] [bug] ¶

Возникает информативная ошибка, если два отдельных объекта BindParameter имеют одинаковое имя, но один из них используется в «расширяющем» контексте (обычно выражение IN), а другой - нет; смешивание одного и того же имени в этих двух различных стилях использования не поддерживается, и обычно параметр expanding=True должен быть установлен для параметров, которые должны получать значения списка вне выражений IN (где expanding установлен по умолчанию).

References: #8018

[mysql] [bug] ¶

Дальнейшие корректировки диалекта MySQL PyODBC для обеспечения полного соединения, которое ранее не работало, несмотря на исправления в #7871.

References: #7966

[mysql] [bug] ¶

Добавлен код отключения для ошибки MySQL 4031, появившейся в MySQL >= 8.0.24 и указывающей на превышение времени ожидания соединения. В частности, это устраняет проблему, когда предварительный пинг не мог переподключиться при превышении таймаута соединения. Pull request любезно предоставлен valievkarim.

References: #8036

[mssql] [bug] ¶

Исправление проблемы, когда пароль с ведущим «{» приводил к ошибке входа в систему.

References: #8062

[mssql] [bug] [reflection] ¶

Явно указывайте collation при отражении столбцов таблицы с помощью MSSQL для предотвращения ошибок «collation conflict».

References: #8035

[oracle] [usecase] ¶

Добавлены два новых кода ошибок для обработки отсоединения Oracle для поддержки раннего тестирования нового драйвера «python-oracledb», выпущенного Oracle.

References: #8066

[oracle] [bug] ¶

Исправлена проблема компилятора SQL, когда функция «bind processing» для связанного параметра неправильно применялась к связанному значению, если имя связанного параметра было «экранировано». Конкретно это относится, в частности, к Oracle, когда Column имеет имя, которое само требует кавычек, так что требующее кавычек имя затем используется для связанных параметров, создаваемых в операторах DML, а используемый тип данных требует обработки связывания, например, тип данных Enum.

References: #8053

[orm] [bug] [regression] ¶

Исправлена регрессия, при которой изменение, внесенное в конструкцию #7861, выпущенную в версии 1.4.33, в результате которого конструкция Insert частично распознавалась как оператор с поддержкой ORM, не передавало правильное состояние маппера / сопоставленной таблицы в Session, вызывая сбой метода Session.get_bind() для Session, который был привязан к движкам и/или соединениям с помощью параметра Session.binds.

References: #7936

[orm] [declarative] [bug] ¶

Модифицирован метакласс DeclarativeMeta для передачи cls.__dict__ в процесс декларативного сканирования для поиска атрибутов, а не отдельного словаря, передаваемого в метод __init__() типа. Это позволяет пользовательским базовым классам, добавляющим атрибуты в __init_subclass__(), работать так, как ожидается, поскольку __init_subclass__() может влиять только на сам cls.__dict__, а не на другой словарь. Технически это является регрессом по сравнению с версией 1.3, где использовался метод __dict__.

References: #7900

[engine] [bug] ¶

Исправлена утечка памяти в расширениях C, которая могла произойти при обращении к именованным членам Row, когда член не существует в Python 3; в частности, это могло произойти во время преобразований NumPy, когда он пытался вызвать такие члены, как .__array__, но проблема была вокруг любого AttributeError, брошенного объектом Row. Эта проблема не относится к версии 2.0, которая уже перешла на Cython. Большое спасибо Себастьяну Бергу за выявление проблемы.

References: #7875

[engine] [bug] ¶

Добавлено предупреждение относительно ошибки, которая существует в методе Result.columns() при передаче 0 для индекса в сочетании с Result, который возвращает одну сущность ORM, что указывает на то, что текущее поведение Result.columns() нарушено в этом случае, поскольку объект Result будет давать скалярные значения, а не объекты Row. Эта проблема будет исправлена в версии 2.0, что будет обратно несовместимым изменением для кода, который полагается на текущее нарушенное поведение. Код, который хочет получить коллекцию скалярных значений, должен использовать метод Result.scalars(), который вернет новый объект ScalarResult, выдающий скалярные объекты без рядов.

References: #7953

[schema] [bug] ¶

Исправлена ошибка, при которой соглашения об именах ForeignKeyConstraint, использующие ключ соглашения об именах referred_column_0, не работали, если ограничение внешнего ключа было установлено как объект ForeignKey, а не как явный объект ForeignKeyConstraint. Поскольку это изменение использует обратный перенос некоторых исправлений из версии 2.0, также исправлена дополнительная малоизвестная возможность, которая, вероятно, была нарушена в течение многих лет, а именно: объект ForeignKey может ссылаться на ссылающуюся таблицу только по имени таблицы без использования имени столбца, если имя ссылающегося столбца совпадает с именем ссылающегося столбца.

Ключ именования referred_column_0 ранее не тестировался с объектом ForeignKey, только ForeignKeyConstraint, и эта ошибка показывает, что функция никогда не работала правильно, если ForeignKeyConstraint не использовалась для всех ограничений FK. Эта ошибка восходит к первоначальному внедрению функции, введенной для #3989.

References: #7958

[asyncio] [bug] ¶

Исправлена обработка объектов contextvar.ContextVar внутри асинхронных адаптированных обработчиков событий. Ранее значения, применяемые к ContextVar, не распространялись в конкретном случае вызова ожидаемых объектов внутри не ожидаемого кода.

References: #7937

[postgresql] [bug] ¶

Исправлена ошибка в типе данных ARRAY в сочетании с Enum на PostgreSQL, когда использование методов .any() или .all() для визуализации SQL ANY() или ALL(), учитывая в качестве аргументов члены перечисления Python, приводило к сбою адаптации типа на всех драйверах.

References: #6515

[postgresql] [bug] ¶

Реализован атрибут UUID.python_type для объекта типа PostgreSQL UUID. Атрибут возвращает либо str, либо uuid.UUID в зависимости от настройки параметра UUID.as_uuid. Ранее этот атрибут был нереализован. Pull request любезно предоставлен Алексом Грёнхольмом.

References: #7943

[postgresql] [bug] ¶

Исправлена проблема в диалекте psycopg2 при использовании параметра create_engine.pool_pre_ping, которая приводила к случайному сбросу настроенного пользователем уровня изоляции AUTOCOMMIT обработчиком «ping».

References: #7930

[mysql] [bug] [regression] ¶

Исправлена регрессия в непроверенном диалекте MySQL PyODBC, вызванная исправлением #7518 в версии 1.4.32, где аргумент неправильно распространялся при первом подключении, что приводило к TypeError.

References: #7871

[tests] [bug] ¶

Для сторонних диалектов исправлено недостающее требование для теста набора SimpleUpdateDeleteTest, который не проверял наличие рабочей функции «rowcount» на целевом диалекте.

References: #7919

[sql] [bug] ¶

Исправлена ошибка в недавно реализованной функции FunctionElement.table_valued.joins_implicitly, когда параметр не распространялся автоматически от исходного объекта TableValuedAlias к вторичному объекту, создаваемому при вызове TableValuedAlias.render_derived() или TableValuedAlias.alias().

Дополнительно исправлены эти проблемы в TableValuedAlias:

• исправлена потенциальная проблема с памятью, которая могла возникнуть при многократном вызове TableValuedAlias.render_derived() против последовательных копий одного и того же объекта (для .alias() мы в настоящее время должны продолжать цепочку с предыдущего элемента. не уверены, можно ли это улучшить, но это стандартное поведение для .alias() в других местах).

• исправлена проблема, при которой отдельные типы элементов терялись при вызове TableValuedAlias.render_derived() или TableValuedAlias.alias().

References: #7890

[sql] [bug] [regression] ¶

Исправлена регрессия, вызванная #7823, которая влияла на систему кэширования, в результате чего связанные параметры, которые были «клонированы» в операциях ORM, таких как полиморфная загрузка, в некоторых случаях не получали своего правильного значения во время выполнения, что приводило к отображению неправильных значений привязки.

References: #7903

[orm] [bug] [regression] ¶

Исправлена регрессия, вызванная #7861, когда вызов конструкции Insert, содержащей сущности ORM, непосредственно через Session.execute() приводил к ошибке.

References: #7878

[postgresql] [bug] ¶

Изменено исправление, сделанное в #6581, где режим «исполняемых значений» для psycopg2 был отключен для всех стилей INSERT «ON CONFLICT», чтобы не применять его к предложению «ON CONFLICT DO NOTHING», которое не включает никаких параметров и безопасно для режима «исполняемых значений». «ON CONFLICT DO UPDATE» все еще блокируется от «executemany values», так как в предложении DO UPDATE могут быть дополнительные параметры, которые не могут быть объединены в пакет (это первоначальная проблема, исправленная в #6581).

References: #7880

[orm] [usecase] ¶

Добавлена функция with_polymorphic.adapt_on_names к функции with_polymorphic(), которая позволяет указать полиморфную нагрузку (обычно с конкретным отображением) против альтернативного selectable, который будет адаптироваться к оригинальному mapped selectable только по именам столбцов.

References: #7805

[orm] [usecase] ¶

Добавлены новые атрибуты UpdateBase.returning_column_descriptions и UpdateBase.entity_description для проверки атрибутов и сущностей ORM, которые установлены как часть конструкции Insert, Update или Delete. Аксессор Select.column_descriptions теперь также реализован для селекторов, предназначенных только для Core.

References: #7861

[orm] [performance] [bug] ¶

Улучшение использования памяти ORM, удаление значительного набора промежуточных объектов выражения, которые обычно хранятся при создании копии объекта выражения. Эти клоны были значительно уменьшены, сократив общее количество объектов выражения, хранящихся в памяти при отображениях ORM, примерно на 30%.

References: #7823

[orm] [bug] [regression] ¶

Исправлена регрессия в стратегии «динамического» загрузчика, когда метод Query.filter_by() не получал соответствующую сущность для фильтрации, в случае, когда «вторичная» таблица присутствовала в запрашиваемом отношении, и сопоставление было с чем-то сложным, таким как «с полиморфизмом».

References: #7868

[orm] [bug] ¶

Исправлена ошибка, при которой атрибуты composite() не работали в сочетании со стратегией загрузчика selectin_polymorphic() для наследования объединенных таблиц.

References: #7801

[orm] [bug] ¶

Исправлена проблема, при которой опция загрузчика selectin_polymorphic() не работала с отображателями объединенного наследования, не имеющими фиксированного столбца «polymorphic_on». Дополнительно добавлена поддержка тестов для более широкого разнообразия шаблонов использования этой конструкции.

References: #7799

[orm] [bug] ¶

Исправлена ошибка в функции with_loader_criteria(), когда критерии загрузчика не применялись к объединенной ускоренной загрузке, которая была вызвана в рамках операции обновления для родительского объекта.

References: #7862

[orm] [bug] ¶

Исправлена проблема, когда Mapper слишком агрессивно уменьшал пользовательский аргумент Mapper.primary_key, в случае отображения на UNION, где для некоторых записей SELECT два столбца по сути эквивалентны, а для других - нет, например, в рекурсивном CTE. Логика здесь была изменена, чтобы принимать заданный пользовательский PK как заданный, где столбцы будут связаны с отображаемым selectable, но больше не «уменьшены», так как эта эвристика не может учесть все ситуации.

References: #7842

[engine] [usecase] ¶

Добавлен новый параметр Engine.dispose.close, по умолчанию равный True. При значении False утилизация движка вообще не трогает соединения в старом пуле, просто сбрасывая пул и заменяя его. Это нужно для того, чтобы при передаче исходного пула от родительского процесса родительский процесс мог продолжать использовать эти соединения.

References: #7815, #7877

[engine] [bug] ¶

Уточнено протоколирование на уровне соединения, чтобы указать, что сообщения BEGIN, ROLLBACK и COMMIT не указывают на реальную транзакцию, когда используется уровень изоляции AUTOCOMMIT; расширен обмен сообщениями, чтобы включить само сообщение BEGIN, а также исправлен обмен сообщениями, чтобы учесть, когда параметр уровня Engine create_engine.isolation_level использовался напрямую.

References: #7853

[sql] [usecase] ¶

Добавлен новый параметр FunctionElement.table_valued.joins_implicitly для конструкции FunctionElement.table_valued(). Этот параметр указывает, что данная таблично-значная функция неявно присоединяется к таблице, на которую она ссылается, по существу отключая функцию «from linting», т.е. предупреждение о «картезианском произведении», от действия из-за наличия этого параметра. Может использоваться для таких функций, как func.json_each().

References: #7845

[sql] [bug] ¶

Параметр bindparam.literal_execute теперь принимает участие в генерации кэша bindparam(), поскольку он изменяет sql-строку, генерируемую компилятором. Ранее использовались правильные значения привязки, но literal_execute игнорировался при последующих выполнениях одного и того же запроса.

References: #7876

[sql] [bug] [regression] ¶

Исправлена регрессия, вызванная #7760, когда новые возможности TextualSelect не были полностью реализованы в компиляторе должным образом, что приводило к проблемам с составленными конструкциями INSERT, такими как «INSERT FROM SELECT» и «INSERT…ON CONFLICT» в сочетании с CTE и текстовыми операторами.

References: #7798

[schema] [usecase] ¶

Добавлена поддержка того, что вызываемая функция Table.to_metadata.referred_schema_fn, переданная в Table.to_metadata(), может возвращать значение BLANK_SCHEMA, чтобы указать, что ссылающийся внешний ключ должен быть сброшен в None. Символ RETAIN_SCHEMA также может быть возвращен из этой функции для указания «без изменений», который будет вести себя так же, как и None в настоящее время, который также указывает на отсутствие изменений.

References: #7860

[sqlite] [bug] [reflection] ¶

Исправлена ошибка, при которой имя ограничений CHECK в SQLite не отражалось, если имя было создано с использованием кавычек, как это бывает, когда в имени используется смешанный регистр или специальные символы.

References: #5463

[mssql] [bug] [regression] ¶

Исправлена регрессия, вызванная #7160, когда отражение FK в сочетании с низким уровнем совместимости (уровень совместимости 80: SQL Server 2000) вызывает ошибку «Неоднозначное имя столбца». Патч любезно предоставлен @Lin-Your.

References: #7812

[bug] [ext] ¶

Улучшено сообщение об ошибке, которое выдается в случае, когда конструкция association_proxy() пытается получить доступ к целевому атрибуту на уровне класса, и этот доступ не удается. В данном случае речь идет о проксировании к гибридному атрибуту, который не имеет рабочей реализации на уровне класса.

References: #7827

[orm] [bug] [regression] ¶

Исправлена регрессия, при которой ORM исключение, которое должно быть вызвано, когда INSERT молча не может вставить ряд (например, из триггера), не достигалось из-за того, что исключение во время выполнения было вызвано раньше времени из-за отсутствующего значения первичного ключа, таким образом, вызывая неинформативное исключение, а не правильное. В версии 1.4 и выше для этого случая добавлено новое FlushError, которое поднимается раньше, чем предыдущее исключение «null identity» в версии 1.3, так как ситуация, когда количество фактически вводимых строк не соответствует ожидаемому, является более критичной в версии 1.4, поскольку она препятствует корректной работе пакетной обработки нескольких объектов. Это не относится к ситуации, когда только что извлеченный первичный ключ извлекается как NULL, что продолжает вызывать существующее исключение «null identity».

References: #7594

[orm] [bug] ¶

Исправлена проблема, при которой использование полного пути для имени класса в relationship(), который, тем не менее, содержал неправильное имя для маркеров пути, не являющихся первым маркером, не вызывало информативной ошибки и вместо этого приводило к случайному отказу на более позднем шаге.

References: #7697

[engine] [bug] ¶

Скорректировано ведение журнала для ключевых компонентов SQLAlchemy, включая Engine, Connection, для установки соответствующего параметра уровня стека, так что токены Python для ведения журнала funcName и lineno при использовании в пользовательских форматерах ведения журнала будут сообщать правильную информацию, что может быть полезно при фильтрации вывода журнала; поддерживается на Python 3.8 и выше. Pull request любезно предоставлен Маркусом Герстелем.

References: #7612

[sql] [bug] ¶

Исправлены сообщения об ошибках, связанных с типами, которые не срабатывали для значений, являющихся кортежами, из-за синтаксиса форматирования строк, включая компиляцию неподдерживаемых литеральных значений и недопустимых булевых значений.

References: #7721

[sql] [bug] [mysql] ¶

Исправлены проблемы с типом данных MySQL SET, а также с общим типом данных Enum, когда метод __repr__() не отображал все необязательные параметры в строковом выводе, что влияло на использование этих типов в автогенерации Alembic. Pull request для MySQL любезно предоставлен Yuki Nishimine.

References: #7598, #7720, #7789

[sql] [bug] ¶

Тип данных Enum теперь выдает предупреждение, если аргумент Enum.length указан без указания аргумента Enum.native_enum как False, поскольку в противном случае параметр молча игнорируется в этом случае, несмотря на то, что тип данных Enum будет по-прежнему отображать VARCHAR DDL на бэкендах, не имеющих встроенного типа данных ENUM, таких как SQLite. Это поведение может измениться в будущем выпуске, чтобы «длина» учитывалась для всех неродных типов «enum» независимо от настройки «native_enum».

[sql] [bug] ¶

Исправлена проблема, при которой метод HasCTE.add_cte(), вызываемый на экземпляре TextualSelect, не учитывался компилятором SQL. Исправление дополнительно добавляет более «SELECT»-подобное поведение компилятора для TextualSelect, включая возможность обработки DML CTE, таких как UPDATE и INSERT.

References: #7760

[asyncio] [bug] ¶

Исправлена проблема, при которой не выдавалось описательное сообщение об ошибке для некоторых классов событий, прослушиваемых с помощью механизма async, который вместо этого должен быть экземпляром механизма sync.

[asyncio] [bug] ¶

Исправлена проблема, при которой метод AsyncSession.execute() не вызывал информативного исключения, если использовалась опция выполнения Connection.execution_options.stream_results, что несовместимо с объектом Result в стиле синхронизации при использовании стиля вызова asyncio, так как операция получения большего количества строк должна была ожидаться. Теперь в этом случае возникает исключение, аналогичное тому, которое уже возникало, когда опция Connection.execution_options.stream_results использовалась с методом AsyncConnection.execute().

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

References: #7667

[postgresql] [usecase] ¶

Добавлена поддержка компилятором фразы PostgreSQL NOT VALID при выводе DDL для конструкций схем CheckConstraint, ForeignKeyConstraint и ForeignKey. Pull request любезно предоставлен Гилбертом Гилбсом.

References: #7600

[mysql] [bug] [regression] ¶

Исправлена регрессия, вызванная #7518, когда изменение синтаксиса «SHOW VARIABLES» на «SELECT @@» нарушало совместимость с версиями MySQL старше 5.6, включая ранние релизы 5.0. Хотя это очень старые версии MySQL, изменение совместимости не планировалось, поэтому была восстановлена логика, зависящая от версии, чтобы вернуться к «SHOW VARIABLES» для версий сервера MySQL < 5.6.

References: #7518

[mariadb] [bug] [regression] ¶

Исправлена регрессия в диалекте mariadbconnector начиная с версии mariadb connector 1.0.10, при которой DBAPI перестал предварительно буферизировать cursor.lastrowid, что приводило к ошибкам при вставке объектов с помощью ORM, а также к недоступности атрибута CursorResult.inserted_primary_key. Теперь диалект получает это значение проактивно в ситуациях, когда оно применимо.

References: #7738

[sqlite] [usecase] ¶

Добавлена поддержка отражения встроенных уникальных ограничений SQLite, когда имена столбцов форматируются с помощью «спасательных кавычек» SQLite [] или `, которые отбрасываются базой данных при создании имени столбца.

References: #7736

[sqlite] [bug] ¶

Исправлена проблема, при которой отражение уникальных ограничений в SQLite не обнаруживало встроенное в столбец ограничение UNIQUE, если в имени столбца присутствовало подчеркивание.

References: #7736

[oracle] [bug] ¶

Исправлена проблема в диалекте Oracle, когда использование имени столбца, требующего кавычек при записи в качестве связанного параметра, например, "_id", не позволяло корректно отслеживать значение по умолчанию, сгенерированное Python, из-за того, что при переписывании связанного параметра это значение отсутствовало, что приводило к возникновению ошибки Oracle.

References: #7676

[oracle] [bug] [regression] ¶

Добавлена поддержка разбора кодов ошибок «DPI» из объектов исключений cx_Oracle, таких как DPI-1080 и DPI-1010, которые теперь указывают на сценарий разъединения, начиная с версии cx_Oracle 8.3.

References: #7748

[tests] [bug] ¶

Улучшена интеграция тестового пакета с pytest таким образом, что плагин «warnings», если он включен вручную, не будет мешать работе тестового пакета. Таким образом, сторонние разработчики могут включить плагин warnings или использовать параметр -W, и тестовый пакет SQLAlchemy будет продолжать работать. Кроме того, модернизировано обнаружение плагина «pytest-xdist», так что плагины могут быть глобально отключены с помощью PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 без нарушения тестового набора, если xdist все еще установлен. Фильтры предупреждений, переводящие предупреждения об износе в ошибки, теперь локализованы на предупреждения, специфичные для SQLAlchemy, или на источники, специфичные для SQLAlchemy, для общих предупреждений об износе Python, так что предупреждения об износе, выдаваемые плагинами pytest, не относящимися к SQLAlchemy, также не должны влиять на набор тестов.

References: #7599

[tests] [bug] ¶

Внесены исправления в конфигурацию pytest по умолчанию относительно того, как настраивается обнаружение тестов, чтобы устранить проблему, когда тестовый набор не настраивал предупреждения правильно, а также пытался загрузить примеры наборов в качестве тестов, в конкретном случае, когда проверка SQLAlchemy располагалась в абсолютном пути, который имел супердиректорию с именем «test».

References: #7045

[orm] [bug] ¶

Исправлена проблема в Session.bulk_save_objects(), когда сортировка, происходящая, когда параметр preserve_order установлен в False, частично сортировала объекты Mapper, что отвергается в Python 3.11.

References: #7591

[postgresql] [bug] [regression] ¶

Исправлена регрессия, в которой изменение в #7148 для исправления обработки ENUM в PostgreSQL нарушало случай использования пустого ARRAY of ENUM, предотвращая корректную обработку строк, содержащих пустой массив, при получении результатов.

References: #7590

[mysql] [bug] [regression] ¶

Исправлена регрессия в диалекте asyncmy, вызванная #7567, когда удаление зависимости PyMySQL нарушало бинарные колонки, из-за того, что диалект asyncmy не был должным образом включен в CI тесты.

References: #7593

[mssql] ¶

Добавлена поддержка FILESTREAM при использовании VARBINARY(max) в MSSQL.

References: #7243

[orm] [bug] ¶

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

References: #7507

[orm] [bug] ¶

Исправлена проблема, при которой вызов функции registry.map_imperatively() более одного раза для одного и того же класса выдавал неожиданную ошибку, а не информативное сообщение о том, что целевой класс уже сопоставлен. Такое поведение отличалось от поведения функции mapper(), которая уже сообщала информативное сообщение.

References: #7579

[orm] [bug] [asyncio] ¶

Добавлен недостающий метод AsyncSession.invalidate() в класс AsyncSession.

References: #7524

[orm] [bug] [regression] ¶

Исправлена регрессия, появившаяся в 1.4.23, которая в некоторых случаях могла привести к неправильной обработке опций загрузчика, в частности, при использовании наследования объединенных таблиц в сочетании с опцией polymorphic_load="selectin", а также ленивой загрузки отношений, что приводило к появлению TypeError.

References: #7557

[orm] [bug] [regression] ¶

Исправлена регрессия ORM, когда вызов функции aliased() на существующую конструкцию aliased() приводил к некорректному SQL, если существующая конструкция была направлена на фиксированную таблицу. Исправление позволяет игнорировать исходную конструкцию aliased(), если она была только против таблицы, которая теперь заменяется. Оно также позволяет обеспечить правильное поведение при построении aliased() без выбираемого аргумента против aliased(), который направлен на подзапрос, для создания псевдонима этого подзапроса (т.е. для изменения его имени).

Поведение вложенности aliased() сохраняется для случая, когда внешний объект aliased() находится против подзапроса, который в свою очередь ссылается на внутренний объект aliased(). Это относительно новая функция версии 1.4, которая помогает удовлетворить случаи использования, которые ранее обслуживались устаревшим методом Query.from_self().

References: #7576

[orm] [bug] ¶

Исправлена проблема, когда метод Select.correlate_except(), при передаче либо значения None, либо отсутствия аргументов, не коррелировал ни с какими элементами при использовании в контексте ORM (то есть, передавая сущности ORM как предложения FROM), вместо того, чтобы заставить все элементы FROM считаться «коррелированными», как это происходит при использовании конструкций только Core.

References: #7514

[orm] [bug] [regression] ¶

Исправлена регрессия из версии 1.3, когда стратегия загрузчика «subqueryload» при использовании в запросе, использующем Query.from_statement() или Select.from_statement(), приводила к ошибке с трассировкой стека. Поскольку подзапрос требует модификации исходного оператора, он не совместим с вариантом использования «from_statement», особенно для запросов, составленных с использованием конструкции text(). Теперь поведение эквивалентно поведению в версии 1.3 и предыдущих версиях, которое заключается в том, что стратегия загрузчика тихо деградирует и не используется для таких утверждений, обычно возвращаясь к использованию стратегии lazyload.

References: #7505

[sql] [bug] [postgresql] ¶

Добавлено дополнительное правило к системе, определяющей реализации TypeEngine из литералов Python, для применения второго уровня корректировки типа, так что Python datetime с или без tzinfo может устанавливать параметр timezone=True на возвращаемый объект DateTime, а также Time. Это помогает при некоторых сценариях обхода в чувствительных к типу диалектах PostgreSQL, таких как asyncpg, psycopg3 (только 2.0).

References: #7537

[sql] [bug] ¶

Добавлено информативное сообщение об ошибке при передаче объекта метода в конструкцию SQL. Ранее, когда передавались такие callable, что является распространенной типографской ошибкой при работе с SQL-конструкциями, связанными с методами, они интерпретировались как цели «лямбда SQL», которые должны были быть вызваны во время компиляции, что приводило к тихим сбоям. Поскольку эта возможность не предназначалась для использования с методами, объекты методов теперь отвергаются.

References: #7032

[mypy] [bug] ¶

Исправлено падение Mypy при запуске режима демона id, вызванное отсутствием атрибута у внутреннего экземпляра mypy Var.

References: #7321

[asyncio] [usecase] ¶

Добавлен новый метод AdaptedConnection.run_async() в интерфейс соединения DBAPI, используемый драйверами asyncio, который позволяет вызывать методы против базового соединения «драйвера» непосредственно в функции стиля sync, где нельзя использовать ключевое слово await, например, в функциях обработчиков событий SQLAlchemy. Этот метод аналогичен методу AsyncConnection.run_sync(), который переводит вызовы в стиле async в вызовы в стиле sync. Метод полезен для таких вещей, как обработчики connection-pool on-connect, которым необходимо вызывать ожидающие методы на соединении драйвера при его первом создании.

References: #7580

[postgresql] [usecase] ¶

Добавлен строковый рендеринг к типу данных UUID, так что строка оператора с «literal_binds», использующего этот тип, будет отображать соответствующее строковое значение для бэкенда PostgreSQL. Pull request любезно предоставлен Жозе Дуарте.

References: #7561

[postgresql] [bug] [asyncpg] ¶

Улучшена поддержка asyncpg обработки TIME WITH TIMEZONE, которая была реализована не полностью.

References: #7537

[postgresql] [bug] [mssql] [reflection] ¶

Исправлено отражение охватывающих индексов, чтобы сообщать include_columns как часть записи dialect_options в словаре отраженного индекса, что позволяет завершить цикл отражение->создание. Включенные столбцы продолжают также присутствовать под ключом include_columns для обратной совместимости.

References: #7382

[postgresql] [bug] ¶

Исправлена обработка массивов значений перечислений, требующих использования управляющих символов.

References: #7418

[mysql] [change] ¶

Замените оператор SHOW VARIABLES LIKE на эквивалентный SELECT @@variable в инициализации диалектов MySQL и MariaDB. Это позволит избежать борьбы за мьютекс, вызванной SHOW VARIABLES, что улучшит производительность инициализации.

References: #7518

[mysql] [bug] ¶

Удалена ненужная зависимость от PyMySQL из диалекта asyncmy. Pull request любезно предоставлен long2ice.

References: #7567

[orm] [usecase] ¶

Добавлен параметр Session.get.execution_options, который ранее отсутствовал в методе Session.get().

References: #7410

[orm] [bug] ¶

Исправлена проблема в новом методе «критерии загрузчика» PropComparator.and_(), когда при использовании стратегии загрузчика типа selectinload() против столбца, являющегося членом коллекции .c. объекта подзапроса, где подзапрос динамически добавляется в предложение FROM оператора, в кэше SQL-оператора появлялись устаревшие значения параметров в подзапросе, поскольку процесс, используемый стратегией загрузчика для замены параметров во время выполнения, не мог учесть подзапрос при получении его в таком виде.

References: #7489

[orm] [bug] ¶

Исправлено переполнение рекурсии, которое могло возникнуть при компиляции операторов ORM при использовании функции with_loader_criteria() или метода PropComparator.and_() в стратегии загрузчика в сочетании с подзапросом, который ссылался на одну и ту же сущность, изменяемую опцией критериев или загружаемую стратегией загрузчика. Для этого сценария была добавлена проверка на рекурсивное использование одного и того же параметра критериев загрузчика.

References: #7491

[orm] [bug] [mypy] ¶

Исправлена проблема, когда метод __class_getitem__() сгенерированного декларативного базового класса as_declarative() приводил к недоступным атрибутам класса, таким как __table__, в случаях, когда в иерархии классов использовалось объявление типизации в стиле Generic[T]. Это является продолжением базового добавления __class_getitem__() в #7368. Pull request любезно предоставлен Каем Мюллером.

References: #7368, #7462

[orm] [bug] [regression] ¶

Исправлена проблема, связанная с кэшированием, когда использование опции загрузчика вида lazyload(aliased(A).bs).joinedload(B.cs) приводило к тому, что объединенная загрузка не вызывалась для запусков, следующих за кэшированием запроса, из-за несоответствия опций/путей объектов, применяемых к объектам, загружаемым для запроса с ведущей сущностью, в котором использовалось aliased().

References: #7447

[engine] [bug] ¶

Исправлено сообщение об ошибке для AttributeError, возникающее при попытке записи в атрибут класса Row, который является неизменяемым. Предыдущее сообщение утверждало, что столбец не существует, что вводит в заблуждение.

References: #7432

[engine] [bug] [regression] ¶

Исправлена регрессия в функции make_url(), используемой для разбора строк URL, когда при разборе строки запроса происходило переполнение рекурсии, если использовалась строка Python 2 u''.

References: #7446

[mypy] [bug] ¶

Исправлена регрессия mypy, когда релиз mypy 0.930 добавил дополнительные внутренние проверки формата «именованных типов», требуя, чтобы они были полностью квалифицированными и локализуемыми. Это нарушало работу плагина mypy для SQLAlchemy, вызывая ошибку утверждения, поскольку использовались такие символы, как __builtins__ и другие нелокализованные или неквалифицированные имена, которые ранее не вызывали никаких утверждений.

References: #7496

[asyncio] [usecase] ¶

Добавлена функция async_engine_config() для создания асинхронного движка из диктанта конфигурации. В остальном она ведет себя так же, как engine_from_config().

References: #7301

[mariadb] [bug] ¶

Исправлены классы ошибок, проверяемые для проверки «is_disconnect» для диалекта mariadbconnector, который не срабатывал для отключений, которые происходили из-за общих кодов ошибок MySQL/MariaDB, таких как 2006; похоже, что DBAPI в настоящее время использует класс исключений mariadb.InterfaceError для ошибок отключения, таких как код ошибки 2006, который был добавлен в список проверяемых классов.

References: #7457

[tests] [bug] [regression] ¶

Исправлена регрессия в тестовом наборе, когда тест, вызываемый CompareAndCopyTest::test_all_present, не выполнялся на некоторых платформах из-за обнаружения дополнительных артефактов тестирования. Pull request любезно предоставлен Nils Philippsen.

References: #7450

[platform] [bug] ¶

Python 3.10 отказался от использования «distutils» в пользу явного использования «setuptools» в PEP 632; setup.py SQLAlchemy заменил импорты соответствующим образом. Однако, поскольку сам setuptools только недавно добавил символы замены, упомянутые в pep-632 по состоянию на ноябрь 2021 года в версии 59.0.1, setup.py по-прежнему имеет обратный импорт в distutils, поскольку SQLAlchemy 1.4 не имеет жесткого требования к версии setuptools на данный момент. Ожидается, что SQLAlchemy 2.0 будет использовать полную схему установки PEP 517, которая будет указывать на соответствующую версионность setuptools заранее.

References: #7311

[orm] [bug] [ext] ¶

Исправлена проблема, при которой внутреннее клонирование, используемое методом PropComparator.any() на relationship() в случае, когда связанный класс также использует полиморфную загрузку ORM, заканчивалось неудачей, если гибридное свойство связанного полиморфного класса использовалось в качестве критерия для операции any().

References: #7425

[orm] [bug] [mypy] ¶

Исправлена проблема, при которой декоратор as_declarative() и подобные функции, используемые для генерации декларативного базового класса, не копировали метод __class_getitem__() из данного суперкласса, что препятствовало использованию pep-484 generics в сочетании с классом Base. Pull request любезно предоставлен Каем Мюллером.

References: #7368

[orm] [bug] [regression] ¶

Исправлена регрессия ORM, когда новое поведение «eager loaders run on unexpire», добавленное в #1763, приводило к тому, что ошибки опций загрузчика возникали неуместно в случае, когда один Query или Select использовался для загрузки нескольких типов сущностей, вместе с опциями загрузчика, которые применяются только к одному из этих типов сущностей, например joinedload(), а затем объекты обновляются после истечения срока действия, где опции загрузчика пытаются быть применены к несоответствующему типу объекта и затем вызывают исключение. Теперь проверка на это несоответствие обходится без выдачи ошибки для этого случая.

References: #7318

[orm] [bug] ¶

Определяемые пользователем опции ORM, такие как проиллюстрированные в примере dogpile.caching, которые подкласс UserDefinedOption, по определению обрабатываются при каждом выполнении оператора и не должны рассматриваться как часть ключа кэша для оператора. Кэширование базового класса ExecutableOption было изменено таким образом, что он больше не является непосредственно подклассом HasCacheKey, так что наличие определяемых пользователем объектов опций не будет иметь нежелательного побочного эффекта отключения кэширования утверждений. Теперь в системе кэширования участвуют только специфические для ORM опции загрузчика и критериев, которые являются внутренними для SQLAlchemy.

References: #7394

[orm] [bug] ¶

Исправлена проблема, из-за которой связки, использующие synonym() и потенциально другие виды «прокси» атрибутов, не во всех случаях успешно генерировали ключ кэша для своих SQL-операторов, что приводило к снижению производительности этих операторов.

References: #7394

[orm] [bug] ¶

Исправлена проблема, при которой список, отображенный с помощью relationship(), попадал в бесконечный цикл, если in-place добавлялся к самому себе, т.е. использовался оператор +=, а также если .extend() получал тот же список.

References: #7389

[orm] [bug] ¶

Исправлена проблема, при которой если возникало исключение, когда Session закрывал соединение в методе Session.commit(), при использовании менеджера контекста для Session.begin(), он пытался сделать откат, который был невозможен, так как Session находился между фиксацией транзакции и возвратом соединения в пул, вызывая исключение «this sessiontransaction is in the committed state». Это исключение может возникнуть в основном в контексте asyncio, где может быть вызван CancelledError.

References: #7388

[orm] [deprecated] ¶

Отменен недокументированный синтаксис опций загрузчика ".*", который, по-видимому, ничем не отличается от передачи одной звездочки, и при его использовании будет выдаваться предупреждение об устаревании. Возможно, этот синтаксис был для чего-то предназначен, но в настоящее время в нем нет необходимости.

References: #4390

[engine] [usecase] ¶

Добавлена поддержка copy() и deepcopy() в класс URL. Pull request любезно предоставлен Томом Ритчфордом.

References: #7400

[sql] [usecase] ¶

Методы «Compound select», такие как Select.union(), Select.intersect_all() и т.д., теперь принимают в качестве аргумента *other, а не other, что позволяет объединять несколько дополнительных SELECT с родительским оператором одновременно. В частности, изменения в CTE.union() и CTE.union_all() теперь позволяют создавать так называемые «нелинейные CTE» с помощью конструкции CTE, тогда как раньше не было возможности иметь более двух подэлементов CTE в UNION вместе и при этом корректно обращаться к CTE рекурсивным способом. Pull request любезно предоставлен Эриком Массераном.

References: #7259

[sql] [usecase] ¶

Поддержка нескольких элементов клаузулы в методе Exists.where(), унифицируя api с тем, который представляет обычная конструкция select().

References: #7386

[sql] [bug] [regression] ¶

Расширение атрибута TypeDecorator.cache_ok и соответствующего предупреждающего сообщения, если этот флаг не определен, поведение, впервые установленное для TypeDecorator как часть #6436, чтобы также иметь место для UserDefinedType, путем обобщения флага и соответствующей логики кэширования на новую общую базу для этих двух типов, ExternalType, чтобы создать UserDefinedType.cache_ok.

Это изменение означает, что любое текущее значение UserDefinedType теперь приведет к тому, что кэширование операторов SQL не будет происходить для операторов, использующих этот тип данных, наряду с выдачей предупреждения, если только класс не определит флаг UserDefinedType.cache_ok как True. Если тип данных не может сформировать детерминированный, хэшируемый ключ кэша, полученный из его аргументов, атрибут может быть установлен в False, что приведет к отключению кэширования, но подавит предупреждение. В частности, пользовательские типы данных, используемые в таких пакетах, как SQLAlchemy-utils, должны будут реализовать этот флаг. Проблема была замечена в результате использования в SQLAlchemy-utils типа данных, который в настоящее время не кэшируется.

References: #7319

[sql] [bug] ¶

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

References: #7394

[sql] [bug] ¶

Исправлены отсутствующие директивы кэширования для нескольких менее используемых классов в SQL Core, которые приводили к регистрации [no key] для элементов, использующих их.

References: #7394

[mypy] [bug] ¶

Исправлено падение Mypy, которое происходило при использовании плагина Mypy в коде, использующем методы declared_attr для не отображаемых имен, таких как __mapper_args__, __table_args__ или других имен, поскольку плагин пытался интерпретировать их как отображаемые атрибуты, которые впоследствии неправильно обрабатывались. В рамках этого изменения декорированная функция по-прежнему преобразуется плагином в общий оператор присваивания (например, __mapper_args__: Any), так что сигнатуру аргумента можно продолжать аннотировать так же, как и для любого другого @classmethod без того, чтобы Mypy жаловался на неправильный тип аргумента для метода, который не является явно @classmethod.

References: #7321

[postgresql] [bug] ¶

Исправлены отсутствующие директивы кэширования для конструкций hstore и array, которые приводили к тому, что для этих элементов регистрировалось [no key].

References: #7394

[tests] [bug] ¶

Реализована поддержка корректной работы тестового набора под Pytest 7. Ранее для Python 3 поддерживался только Pytest 6.x, однако эта версия не была привязана к верхней границе в tox.ini. Pytest не привязан в tox.ini к версии ниже 8, так что версии SQLAlchemy, выпущенные с текущей кодовой базой, смогут быть протестированы под tox без изменений в окружении. Большое спасибо разработчикам Pytest за помощь в решении этого вопроса.

[orm] [bug] ¶

Исправлена ошибка в функции «связь с псевдонимом класса», введенной в Отношения с чужим классом, когда невозможно было создать опцию стратегии загрузчика, нацеленную на атрибут цели с помощью конструкции aliased() непосредственно во второй опции загрузчика, например selectinload(A.aliased_bs).joinedload(aliased_b.cs), без явной квалификации с помощью PropComparator.of_type() на предыдущем элементе пути. Кроме того, прямое обращение к несглаженному классу будет принято (неуместно), но будет тихо провалено, например selectinload(A.aliased_bs).joinedload(B.cs); теперь это вызывает ошибку, указывающую на несоответствие типов.

References: #7224

[orm] [bug] ¶

Все объекты Result теперь будут последовательно поднимать ResourceClosedError, если они используются после жесткого закрытия, что включает «жесткое закрытие», которое происходит после вызова методов «одной строки или значения», таких как Result.first() и Result.scalar(). Такое поведение уже было характерно для наиболее распространенного класса объектов результатов, возвращаемых при выполнении операторов Core, то есть тех, которые основаны на CursorResult, поэтому такое поведение не является новым. Однако изменение было расширено, чтобы должным образом приспособиться к «фильтрации» объектов результатов ORM, возвращаемых при использовании ORM-запросов в стиле 2.0, которые ранее вели себя в стиле «мягкого закрытия», возвращая пустые результаты, или вообще не «мягко закрывались» и продолжали получать данные от базового курсора.

В рамках этого изменения мы также добавили Result.close() к базовому классу Result и реализовали его для реализаций фильтрованных результатов, используемых ORM, чтобы можно было вызвать метод CursorResult.close() на базовом CursorResult, когда используется опция выполнения yield_per, чтобы закрыть курсор на стороне сервера до того, как будут извлечены оставшиеся результаты ORM. Это уже было доступно для наборов результатов Core, но данное изменение делает это доступным и для результатов ORM в стиле 2.0.

References: #7274

[orm] [bug] [regression] ¶

Исправлена регрессия 1.4, когда Query.filter_by() некорректно функционировал на Query, который был произведен из Query.union(), Query.from_self() или подобных.

References: #7239

[orm] [bug] ¶

Исправлена проблема, при которой отложенная полиморфная загрузка атрибутов из подкласса наследования объединенной таблицы не могла корректно заполнить атрибут, если для первоначального исключения этого атрибута использовалась опция load_only(), в случае, когда load_only спускалась от опции загрузчика отношений. Исправление позволяет другим допустимым опциям, таким как defer(..., raiseload=True) и т.д., функционировать так, как ожидается.

References: #7304

[orm] [bug] [regression] ¶

Исправлена регрессия 1.4, когда Query.filter_by() не функционировал правильно, когда Query.join() присоединялись к сущности, которая использовала PropComparator.of_type() для указания псевдослучайной версии целевой сущности. Проблема также относится к ORM-запросам будущего стиля, построенным с использованием select().

References: #7244

[engine] [bug] ¶

Исправлена проблема в будущем объекте Connection, когда метод Connection.execute() не принимал в качестве словаря параметров объект отображения без диктанта, например, собственный объект SQLAlchemy RowMapping или другой объект abc.collections.Mapping.

References: #7291

[engine] [bug] [regression] ¶

Исправлена регрессия, при которой метод CursorResult.fetchmany() не мог автозакрыть курсор на стороне сервера (т.е. при использовании stream_results или yield_per, либо Core, либо ORM-ориентированных результатов), когда результаты были полностью исчерпаны.

References: #7274

[engine] [bug] ¶

Исправлена проблема в будущем Engine, когда вызов Engine.begin() и вход в контекстный менеджер не закрывал соединение, если фактическая операция BEGIN не выполнялась по какой-либо причине, например, обработчик события вызывал исключение; этот случай использования не был протестирован для будущей версии движка. Обратите внимание, что «будущие» менеджеры контекста, которые обрабатывают блоки begin() в Core и ORM, фактически не выполняют операцию «BEGIN» до тех пор, пока не будут введены менеджеры контекста. Это отличается от старой версии, в которой операция «BEGIN» выполняется заранее.

References: #7272

[sql] [usecase] ¶

Добавлено TupleType в пространство имен импорта верхнего уровня sqlalchemy.

[sql] [bug] [regression] ¶

Исправлена регрессия, при которой объекты строк, возвращаемые для ORM-запросов, которые теперь являются обычными объектами Row, не интерпретировались оператором ColumnOperators.in_() как значения кортежа, которые должны быть разбиты на отдельные связанные параметры, и вместо этого передавались драйверу как одиночные значения, что приводило к сбоям. Изменение системы «расширяющегося IN» теперь учитывает, что выражение уже имеет тип TupleType и обрабатывает значения соответствующим образом. В редких случаях использования «tuple-in» с нетипизированным выражением, например, текстовым выражением без информации о типе, значение кортежа определяется для значений, реализующих collections.abc.Sequence, но не являющихся str или bytes, как всегда при проверке на Sequence.

References: #7292

[sql] [bug] ¶

Исправлена проблема, при которой функция использования строковой метки для упорядочивания или группировки, описанная в Упорядочивание или группировка по метке, не работала корректно, если использовалась в конструкции CTE, когда CTE были встроены внутрь охватывающего оператора Select, который сам был настроен как скалярный подзапрос.

References: #7269

[sql] [bug] [regression] ¶

Исправлена регрессия, при которой конструкция text() больше не принималась в качестве целевого случая в списке «whens» внутри конструкции case(). Регрессия, по-видимому, связана с попыткой защиты от некоторых форм буквальных значений, которые считались неоднозначными при передаче сюда; однако нет причин, по которым целевые случаи не должны интерпретироваться как произвольные выражения SQL, как и везде, и буквальная строка или кортеж будет преобразована в связанный параметр, как это было бы в других случаях.

References: #7287

[schema] [bug] ¶

Исправлена проблема в Table, когда параметр Table.implicit_returning не размещался корректно при передаче вместе с Table.extend_existing для дополнения существующего Table.

References: #7295

[postgresql] [usecase] [asyncpg] ¶

Добавлены переопределяемые методы PGDialect_asyncpg.setup_asyncpg_json_codec и PGDialect_asyncpg.setup_asyncpg_jsonb_codec codec, которые выполняют необходимую задачу регистрации JSON/JSONB кодеков для этих типов данных при использовании asyncpg. Изменение заключается в том, что методы разбиты на отдельные, переопределяемые методы для поддержки диалектов сторонних разработчиков, которым необходимо изменить или отключить настройку этих конкретных кодеков.

References: #7284

[postgresql] [bug] [asyncpg] ¶

Изменен диалект asyncpg для привязки типа Float к типу PostgreSQL «float» вместо «numeric», чтобы можно было разместить значение float(inf). Добавлена поддержка тестового набора для сохранения значения «inf».

References: #7283

[postgresql] [pg8000] ¶

Улучшение работы с массивами при использовании PostgreSQL с диалектом pg8000.

References: #7167

[mysql] [bug] [mariadb] ¶

Реорганизован список зарезервированных слов в два отдельных списка, один для MySQL и один для MariaDB, чтобы можно было более точно управлять этими разными наборами слов; настроен диалект MySQL/MariaDB для переключения между этими списками на основе явно настроенного или определяемого по версии сервера бэкенда «MySQL» или «MariaDB». Добавлены все текущие зарезервированные слова для MySQL 8 и текущих версий MariaDB, включая недавно добавленные ключевые слова, такие как «lead». Pull request любезно предоставлен Кевином Кирше.

References: #7167

[mysql] [bug] ¶

Исправлена проблема в MySQL Insert.on_duplicate_key_update(), которая при использовании выражения в выражении VALUES выводила неверное имя столбца. Pull request любезно предоставлен Кристианом Сабайлой.

References: #7281

[mssql] [bug] ¶

Скорректирована генерация компилятором символов «после компиляции», включая символы, используемые для «расширения IN», а также для «карты трансляции схемы», чтобы они не основывались непосредственно на строках, заключенных в скобки с подчеркиванием, поскольку это напрямую противоречит формату цитирования SQL Server, также использующему скобки, что приводит к ложным совпадениям, когда компилятор заменяет символы «после компиляции» и «трансляции схемы». Проблема создала легко воспроизводимые примеры как с методом Inspector.get_schema_names() при использовании в сочетании с функцией Connection.execution_options.schema_translate_map, так и в маловероятном случае, когда символ, перекрывающий внутреннее имя «POSTCOMPILE», будет использоваться с функцией типа «expanding in».

References: #7300

[orm] [bug] ¶

Улучшено сообщение об исключении, генерируемое при настройке отображения с наследованием объединенных таблиц, когда в двух таблицах либо не установлены отношения внешних ключей, либо установлены несколько отношений внешних ключей. Сообщение теперь специфично для ORM и включает контекст, в котором говорится, что параметр Mapper.inherit_condition может понадобиться, особенно в случае неоднозначных внешних ключей.

[orm] [bug] ¶

Исправлена проблема с функцией with_loader_criteria(), когда критерии ON не добавлялись в JOIN для запроса вида select(A).join(B), указывающего цель при использовании неявного предложения ON.

References: #7189

[orm] [bug] ¶

Исправлена ошибка, при которой «плагин» ORM, необходимый для корректной работы таких функций, как with_loader_criteria(), не применялся к select(), который запрашивался из выражения столбца ORM, если в нем использовался модификатор ColumnElement.label().

References: #7205

[orm] [bug] ¶

Добавьте недостающие методы, добавленные в #6991 в scoped_session и async_scoped_session().

References: #7103

[orm] [bug] ¶

К функциональности Query.join() и ORM-версии Select.join() был добавлен дополнительный слой предупреждающих сообщений, в котором несколько мест, где продолжает встречаться «автоматическое псевдонирование», теперь будут названы паттерном, которого следует избегать, в основном это относится к области наследования объединенных таблиц, где классы, имеющие общие базовые таблицы, объединяются вместе без использования явных псевдонимов. В одном случае выдается предупреждение о наследуемом шаблоне, который не рекомендуется использовать, в другом случае он полностью устарел.

Автоматическое выравнивание в ORM join(), которое происходит для перекрывающихся сопоставленных таблиц, не работает последовательно со всеми API, такими как contains_eager(), и вместо того, чтобы продолжать пытаться заставить эти случаи использования работать везде, замена на более явный пользовательский шаблон более понятна, менее подвержена ошибкам и еще больше упрощает внутреннее устройство SQLAlchemy.

Предупреждения содержат ссылки на страницу errors.rst, где демонстрируется каждый паттерн, а также рекомендации по его исправлению.

References: #6972, #6974

[orm] [bug] ¶

Исправлена ошибка, когда итерация Result из Session после того, как Session были закрыты, частично присоединяла объекты к этой сессии в недействительном состоянии. Теперь он вызывает исключение со ссылкой на новую документацию, если небуферизованный результат итерируется из Session, который был закрыт или иным образом имел метод Session.expunge_all(), вызванный после того, как был сгенерирован Result. Опция выполнения prebuffer_rows, которая автоматически используется расширением asyncio для клиентских наборов результатов, может быть использована для создания Result, где объекты ORM предварительно буферизированы, и в этом случае итерация результата приведет к созданию серии отделенных объектов.

References: #7128

[orm] [bug] ¶

Связано с #7153, исправлена проблема, при которой поиск столбцов результатов был неудачным для «адаптированных» операторов SELECT, которые выбирали для выражений «постоянные» значения, чаще всего выражение NULL, что происходило в таких местах, как объединенная ускоренная загрузка в сочетании с ограничением/смещением. В целом это была регрессия, вызванная выпуском #6259, который удалял всю «адаптацию» для констант типа NULL, «true» и «false» при переписывании выражений в операторе SQL, но это нарушало ситуацию, когда та же логика адаптации использовалась для преобразования константы в маркированное выражение для целей нацеливания набора результатов.

References: #7154

[orm] [bug] [regression] ¶

Исправлена регрессия, при которой загруженные объекты ORM не могли быть пикированы в случаях, когда опции загрузчика, использующие "*", использовались в определенных комбинациях, таких как сочетание стратегии загрузчика joinedload() с raiseload('*') вложенных элементов.

References: #7134

[orm] [bug] [regression] ¶

Исправлена регрессия, при которой использование атрибута hybrid_property или сопоставленного атрибута composite() в качестве ключа, передаваемого в метод Update.values() для оператора Update с поддержкой ORM, а также при использовании его через традиционный метод Query.update(), обрабатывались на предмет входящих ORM/гибридных/композитных значений на этапе компиляции оператора UPDATE, что означало, что в тех случаях, когда происходило кэширование, последующие вызовы того же оператора уже не получали правильных значений. Это касается не только гибридов, использующих метод hybrid_property.update_expression(), но и любого использования обычного гибридного атрибута. Для композитов эта проблема приводила к генерации неповторяющегося ключа кэша, что нарушало кэширование и могло заполнить кэш утверждений повторяющимися утверждениями.

Конструкция Update теперь обрабатывает пары ключ/значение, переданные в Update.values() и Update.ordered_values() заранее, когда конструкция генерируется впервые, до генерации ключа кэша, чтобы пары ключ/значение обрабатывались каждый раз, и чтобы ключ кэша генерировался по отдельным парам столбцов/значений, которые в конечном итоге будут использоваться в операторе.

References: #7209

[orm] ¶

Передача объекта Query в Session.execute() не является предполагаемым использованием этого объекта, и теперь будет выдано предупреждение об устаревании.

References: #6284

[examples] [bug] ¶

Исправлены примеры в examples/versioned_rows для корректного использования API SQLAlchemy 1.4; эти примеры были пропущены, когда были сделаны изменения в API, такие как удаление «passive» из Session.is_modified(), а также добавлен крючок события SessionEvents.do_orm_execute().

References: #7169

[engine] [bug] ¶

Исправлена проблема, при которой предупреждение об устаревании конструктора URL, указывающее на необходимость использования метода URL.create(), не выдавалось, если передавался полный список позиционных аргументов из семи аргументов; кроме того, при вызове конструктора таким образом теперь будет происходить проверка аргументов URL, которая ранее пропускалась.

References: #7130

[engine] [bug] [postgresql] ¶

Метод Inspector.reflect_table() теперь поддерживает отражение таблиц, в которых нет столбцов, определенных пользователем. Это позволяет MetaData.reflect() правильно завершить отражение на базах данных, содержащих такие таблицы. В настоящее время известно, что только PostgreSQL поддерживает такую конструкцию среди распространенных бэкендов баз данных.

References: #3247

[engine] [bug] ¶

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

References: #7077

[sql] [bug] ¶

Исправлена проблема, при которой SQL-запросы, использующие конструкцию FunctionElement.within_group(), не могли быть травлены, обычно при использовании расширения sqlalchemy.ext.serializer, но также и при общем травлении.

References: #6520

[sql] [bug] ¶

Исправлена проблема в новом параметре HasCTE.cte.nesting, введенном в #4123, когда рекурсивный CTE, использующий HasCTE.cte.recursive в типичной комбинации с UNION, компилировался некорректно. Дополнительно внесены некоторые изменения, чтобы конструкция CTE создавала правильный ключ кэша. Pull request любезно предоставлен Эриком Массераном.

References: #4123

[sql] [bug] ¶

Учет параметра table.schema, переданного в конструкцию table(), таким образом, чтобы он учитывался при обращении к атрибуту TableClause.fullname.

References: #7061

[sql] [bug] ¶

Исправлено несоответствие в функциях/методах ColumnOperators.any_() / ColumnOperators.all_(), когда специальное поведение этих функций по «переворачиванию» выражения таким образом, что выражение «ANY» / «ALL» всегда находится справа, не работало, если сравнение проводилось со значением None, то есть «column.any_() == None» должно давать такое же SQL выражение, как и «null() == column.any_()». Добавлена дополнительная документация для разъяснения этого, а также упоминание о том, что any_() / all_() в целом заменяет версию ARRAY «any()» / «all()».

References: #7140

[sql] [bug] [regression] ¶

Исправлена проблема, при которой «расширение IN» не работало правильно с типами данных, использующими метод TypeEngine.bind_expression(), когда метод должен был применяться к каждому элементу выражения IN, а не к самому выражению IN в целом.

References: #7177

[sql] [bug] ¶

Скорректировали логику «разграничения столбцов», которая появилась в 1.4, когда одно и то же выражение повторяется и получает «дополнительную анонимную» метку, так, чтобы логика более агрессивно дедуплицировала эти метки, когда повторяющийся элемент является одним и тем же объектом выражения Python каждый раз, как это происходит в случаях использования «одиночных» значений типа null(). Это основано на наблюдении, что по крайней мере некоторые базы данных (например, MySQL, но не SQLite) выдают ошибку, если одна и та же метка повторяется внутри подзапроса.

References: #7153

[mypy] [bug] ¶

Исправлена проблема в плагине mypy для улучшения некоторых проблем с обнаружением типов Enum() SQL, содержащих пользовательские классы перечислений Python. Pull request любезно предоставлен Хироши Огавой.

References: #6435

[postgresql] [bug] ¶

Добавлено условие «разъединения» для ошибки «SSL SYSCALL error: Плохой адрес», о котором сообщил psycopg2. Pull request любезно предоставлен Зиком Брехтелем.

References: #5387

[postgresql] [bug] [regression] ¶

Исправлена проблема, когда выражения IN против серии элементов массива, как это можно сделать в PostgreSQL, не работали правильно из-за многочисленных проблем в функции «расширяющего IN» SQLAlchemy Core, которая была стандартизирована в версии 1.4. Диалект psycopg2 теперь использует метод TypeEngine.bind_expression() с ARRAY для переносимого применения правильного приведения к элементам. Диалект asyncpg не был затронут этой проблемой, так как он применяет приведения на уровне биндов на уровне драйвера, а не на уровне компилятора.

References: #7177

[mysql] [bug] [mariadb] ¶

Исправления для адаптации к серии MariaDB 10.6, включая обратно несовместимые изменения как в Python-драйвере mariadb-connector (поддерживается только в SQLAlchemy 1.4), так и в родных клиентских библиотеках 10.6, которые автоматически используются mysqlclient DBAPI (применяется как к 1.3, так и к 1.4). Символ кодировки «utf8mb3» теперь сообщается этими клиентскими библиотеками, когда кодировка указана как «utf8», что приводит к ошибкам поиска и кодировки в диалекте MySQL, который не ожидает этого символа. Обновления внесены как в базовую библиотеку MySQL, чтобы учесть этот символ utf8mb3, так и в тестовый пакет. Спасибо Георгу Рихтеру за поддержку.

This change is also backported to: 1.3.25

References: #7115, #7136

[mysql] [bug] ¶

Исправлена проблема в конструкции MySQL match(), когда передача выражения клаузы, такого как bindparam() или другого SQL выражения для параметра «against» приводила к неудаче. Pull request любезно предоставлен Антоном Ковалевичем.

References: #7144

[mysql] [bug] ¶

Исправлена проблема установки, при которой модуль sqlalchemy.dialects.mysql не импортировался, если не был установлен «greenlet».

References: #7204

[mssql] [usecase] ¶

Добавлена поддержка отражения для опций внешнего ключа SQL Server, включая «ON UPDATE» и «ON DELETE» значения «CASCADE» и «SET NULL».

[mssql] [bug] ¶

Исправлена проблема с Inspector.get_foreign_keys(), когда внешние ключи были пропущены, если они были установлены против уникального индекса вместо уникального ограничения.

References: #7160

[mssql] [bug] ¶

Исправлена проблема с Inspector.has_table(), когда при запросе к tempdb возвращалась False, если локальная временная таблица с тем же именем из другой сессии возвращалась первой. Это продолжение #6910, которое учитывало, что временная таблица существует только в альтернативной сессии, а не в текущей.

References: #7168

[mssql] [bug] [regression] ¶

Исправлена ошибка в типе данных SQL Server DATETIMEOFFSET, когда реализация ODBC не генерировала корректный DDL, в случаях, когда тип был преобразован с помощью метода dialect.type_descriptor(), использование которого показано в некоторых документированных примерах для TypeDecorator, хотя и не является необходимым для большинства типов данных. Регрессия была введена в #6366. В рамках этого изменения полный список типов дат SQL Server был изменен, чтобы вернуть «dialect impl», который генерирует то же имя DDL, что и супертип.

References: #7129

[platform] [bug] [regression] ¶

Исправлена регрессия, вызванная #7024, когда при реорганизации имен «platform machine», используемых зависимостью greenlet, неправильно писалось «aarch64» и дополнительно опускалось заглавное «AMD64», что необходимо для машин Windows. Pull request любезно предоставлен Джеймсом Доу.

References: #7024

[platform] [bug] ¶

Дополнительно скорректирован спецификатор пакета «greenlet» в setup.cfg для использования длинной цепочки выражений «или», так что сравнение platform_machine с определенным идентификатором соответствует только полной строке.

References: #7024

[orm] [usecase] ¶

Добавлены опции загрузчика в Session.merge() и AsyncSession.merge() через новый параметр Session.merge.options, который будет применять заданные опции загрузчика к get(), используемому внутри merge, позволяя применять ускоренную загрузку отношений и т.д., когда процесс merge загружает новый объект. Pull request любезно предоставлен Дэниелом Стоуном.

References: #6955

[orm] [bug] [regression] ¶

Исправлена проблема ORM, когда выражения столбцов, переданные в query() или ORM-enabled select(), дедуплицировались на идентичность объекта, например, фраза типа select(A.id, null(), null()) выдавала только одно выражение «NULL», чего ранее не было в 1.3. Однако, это изменение также позволяет ORM-выражениям отображаться как заданные, например, select(A.data, A.data) будет выдавать строку результата с двумя столбцами.

References: #6979

[orm] [bug] [regression] ¶

Исправлена проблема в недавно исправленном методе Query.with_entities(), когда флаг, определяющий автоматическую уникальность только для унаследованных объектов ORM Query, устанавливался в значение True в случаях, когда вызов with_entities() устанавливал Query на возврат строк только для столбцов, которые не являются уникальными.

References: #6924

[engine] [usecase] [asyncio] ¶

Улучшить интерфейс, используемый адаптированными драйверами, такими как asyncio, для доступа к фактическому объекту соединения, возвращаемому драйвером.

Объект _ConnectionFairy имеет два новых атрибута:

• _ConnectionFairy.dbapi_connection всегда представляет собой объект, совместимый с DBAPI. Для драйверов pep-249 это соединение DBAPI, каким оно всегда было, доступ к которому ранее осуществлялся через атрибут .connection. Для драйверов asyncio, которые SQLAlchemy адаптирует в интерфейс pep-249, возвращаемый объект обычно будет объектом адаптации SQLAlchemy под названием AdaptedConnection.

• _ConnectionFairy.driver_connection всегда представляет фактический объект соединения, поддерживаемый сторонним pep-249 DBAPI или используемым асинхронным драйвером. Для стандартных pep-249 DBAPI это всегда будет тот же объект, что и в dbapi_connection. Для драйвера asyncio это будет базовый объект соединения только для asyncio.

Атрибут .connection остается доступным и теперь является унаследованным псевдонимом .dbapi_connection.

References: #6832

[engine] [usecase] [orm] ¶

Добавлены новые методы Session.scalars(), Connection.scalars(), AsyncSession.scalars() и AsyncSession.stream_scalars(), которые обеспечивают короткий путь к случаю получения ориентированного на строки объекта Result и преобразования его в объект ScalarResult с помощью метода Result.scalars(), чтобы вернуть список значений, а не список строк. Новые методы аналогичны давно существующим методам Session.scalar() и Connection.scalar(), используемым для возврата единственного значения только из первой строки. Pull request любезно предоставлен Мигелем Гринбергом.

References: #6990

[engine] [bug] [regression] ¶

Исправлена проблема, при которой возможность метода ConnectionEvents.before_execute() изменять переданный объект SQL-оператора, возвращая новый объект для вызова, была непреднамеренно удалена. Это поведение было восстановлено.

References: #6913

[engine] [bug] ¶

Убедитесь, что str() вызывается на аргументе an URL.create.password, что позволяет использовать в качестве атрибутов пароля объекты, реализующие метод __str__(). Также уточнено, что один такой объект не подходит для динамического изменения пароля для каждого соединения с базой данных; вместо него следует использовать подходы на Генерация динамических маркеров аутентификации.

References: #6958

[engine] [bug] ¶

Исправлена проблема в URL, когда проверка «drivername» не реагировала должным образом на значение None, где ожидалась строка.

References: #6983

[engine] [bug] [postgresql] ¶

Исправлена проблема, при которой движок, имеющий флаг create_engine.implicit_returning, установленный в False, не работал, если функция PostgreSQL «fast insertmany» использовалась в сочетании с Sequence, а также если любой вид «executemany» с «return_defaults()» использовался в сочетании с Sequence. Обратите внимание, что PostgreSQL «fast insertmany» использует «RETURNING» по определению, когда SQL оператор передается драйверу; в целом, флаг create_engine.implicit_returning является унаследованным и не имеет реального использования в современной SQLAlchemy, и будет устаревшим в отдельном изменении.

References: #6963

[sql] [usecase] ¶

Добавлен новый параметр HasCTE.cte.nesting в конструктор CTE и метод HasCTE.cte(), который отмечает CTE как такой, который должен оставаться вложенным в окружающий CTE, а не перемещаться на верхний уровень внешнего SELECT. Хотя в подавляющем большинстве случаев нет никакой разницы в функциональности SQL, пользователи выявили различные граничные случаи, когда истинная вложенность конструкций CTE является желательной. Большое спасибо Эрику Массерану за большую работу над этой сложной функцией.

References: #4123

[sql] [bug] ¶

Реализованы отсутствующие методы в FunctionElement, которые, будучи неиспользуемыми, приводили к тому, что pylint сообщал о них как о нереализованных абстрактных методах.

References: #7052

[sql] [bug] ¶

Исправлены две проблемы, когда комбинации select() и join() при адаптации для формирования копии элемента не полностью копировали состояние всех объектов колонок, связанных с подзапросами. Ключевая проблема, вызванная этим, заключалась в том, что использование метода ClauseElement.params() (который, вероятно, следует перенести в категорию наследия, поскольку он неэффективен и чреват ошибками) оставляло копии старых объектов BindParameter, что приводило к проблемам с правильной установкой параметров во время выполнения.

References: #7055

[sql] [bug] ¶

Исправлена проблема, связанная с новой функцией HasCTE.add_cte(), когда при одновременном использовании двух операторов «INSERT…FROM SELECT» терялся смысл двух независимых операторов SELECT, что приводило к неправильному SQL.

References: #7036

[sql] [bug] ¶

Исправлена проблема, при которой использование выражений столбцов ORM в качестве ключей в списке словарей, переданных в Insert.values() для «многозначной вставки», не обрабатывалось корректно в правильные выражения столбцов.

References: #7060

[mypy] [bug] ¶

Исправлена проблема, из-за которой плагин mypy аварийно завершал работу при интерпретации конструкции query_expression().

References: #6950

[mypy] [bug] ¶

Исправлена проблема в плагине mypy, когда столбцы на mixin не интерпретировались корректно, если отображаемый класс полагался на процедуру __tablename__, пришедшую из суперкласса.

References: #6937

[asyncio] [feature] [mysql] ¶

Добавлена начальная поддержка драйвера базы данных asyncmy asyncio для MySQL и MariaDB. Этот драйвер очень новый, но, похоже, является единственной альтернативой драйверу aiomysql, который в настоящее время не поддерживается и не работает с текущими версиями Python. Большое спасибо long2ice за pull request для этого диалекта.

References: #6993

[asyncio] [usecase] ¶

AsyncSession теперь поддерживает переопределение того, какой Session он использует в качестве проксируемого экземпляра. Пользовательский класс Session можно передать с помощью параметра AsyncSession.sync_session_class или путем подклассификации AsyncSession и указания пользовательского AsyncSession.sync_session_class.

References: #6746

[asyncio] [bug] ¶

Исправлена ошибка в AsyncSession.execute() и AsyncSession.stream(), которая требовала, чтобы execution_options при определении был экземпляром immutabledict. Теперь он корректно принимает любое отображение.

References: #6943

[asyncio] [bug] ¶

Добавлены недостающие аргументы **kw в метод AsyncSession.connection().

[asyncio] [bug] ¶

Исправьте использование scoped_session с драйверами asyncio. При использовании Asyncio вместо него следует использовать async_scoped_session.

References: #6746

[postgresql] [bug] ¶

Квалифицируйте вызов version(), чтобы избежать проблем с тенью, если пользователь настроил другой путь поиска.

References: #6912

[postgresql] [bug] ¶

Тип данных ENUM является нативным для PostgreSQL и поэтому не должен использоваться с флагом native_enum=False. Теперь этот флаг игнорируется при передаче типу данных ENUM и выдается предупреждение; ранее флаг приводил к некорректной работе объекта типа.

References: #6106

[sqlite] [bug] ¶

Исправлена ошибка, при которой сообщение об ошибке недействительного уровня изоляции SQLite на драйвере pysqlite не указывало, что «AUTOCOMMIT» является одним из допустимых уровней изоляции.

[mssql] [bug] [reflection] ¶

Исправлена проблема, когда sqlalchemy.engine.reflection.has_table() возвращало True для локальных временных таблиц, которые на самом деле принадлежали другому сеансу SQL Server (соединению). Теперь выполняется дополнительная проверка, чтобы убедиться, что обнаруженная временная таблица действительно принадлежит текущему сеансу.

References: #6910

[oracle] [performance] [bug] ¶

Добавлен CAST(VARCHAR2(128)) к «имени таблицы», «владельцу» и другим параметрам DDL-имени, используемым в запросах на отражение к системным представлениям Oracle, таким как ALL_TABLES, ALL_TAB_CONSTRAINTS и т.д., чтобы лучше обеспечить возможность индексирования по этим столбцам, поскольку ранее они неявно обрабатывались как NVARCHAR2 из-за использования в Python Unicode для строк; эти столбцы документированы во всех версиях Oracle как VARCHAR2 с длиной от 30 до 128 символов в зависимости от версии сервера. Кроме того, была включена поддержка тестирования структур DDL с именами Unicode в базах данных Oracle.

References: #4486

[general] [bug] ¶

Требования к установке были изменены таким образом, что greenlet является требованием по умолчанию только для тех платформ, для которых хорошо известна возможность установки greenlet и для которых уже есть предварительно собранный бинарник на pypi; текущий список - x86_64 aarch64 ppc64le amd64 win32. Для других платформ greenlet не будет устанавливаться по умолчанию, что позволит установить и запустить тестовый пакет SQLAlchemy 1.4 на платформах, не поддерживающих greenlet, исключая любые возможности asyncio. Для установки с включенной зависимостью greenlet на архитектуру машины, не входящую в приведенный выше список, дополнительная зависимость [asyncio] может быть включена путем выполнения команды pip install sqlalchemy[asyncio], которая затем попытается установить greenlet.

Кроме того, набор тестов был исправлен таким образом, чтобы тесты могли полностью завершаться, когда greenlet не установлен, с соответствующими пропусками для тестов, связанных с asyncio.

References: #6136

[orm] [usecase] ¶

Добавлен новый атрибут Select.columns_clause_froms, который будет извлекать список FROM, подразумеваемый предложением columns оператора Select. Это отличается от старой коллекции Select.froms тем, что она не выполняет никаких шагов компиляции ORM, которые обязательно деаннотируют элементы FROM и делают такие вещи, как вычисление объединенных нагрузок и т.д., что делает ее неподходящим кандидатом для метода Select.select_from(). Дополнительно добавляет новый параметр Select.with_only_columns.maintain_column_froms, который передает эту коллекцию в Select.select_from() перед заменой коллекции столбцов.

Кроме того, Select.froms переименована в Select.get_final_froms(), чтобы подчеркнуть, что эта коллекция не является простым аксессором, а вычисляется с учетом полного состояния объекта, что может быть дорогим вызовом при использовании в контексте ORM.

Дополнительно исправляет регрессию, связанную с функцией with_only_columns() для поддержки применения критериев к элементам колонок, которые были заменены на Select.with_only_columns() или Query.with_entities(), которая была сломана в #6503, выпущенной в версии 1.4.19.

References: #6808

[orm] [bug] [sql] ¶

Исправлена проблема, при которой «клонированный» объект связанного параметра вызывал конфликт имен в компиляторе, если в одном операторе одновременно использовалось более одного клона этого параметра. Это могло произойти, в частности, с такими вещами, как запросы на наследование одной таблицы ORM, которые указывали одно и то же значение «дискриминатора» несколько раз в одном запросе.

References: #6824

[orm] [bug] ¶

Исправлена проблема в стратегиях загрузчика, когда использование метода Load.options(), особенно при вложении нескольких вызовов, генерировало слишком длинный и, что более важно, недетерминированный ключ кэша, что приводило к очень большим ключам кэша, которые также не позволяли эффективно использовать кэш, как с точки зрения общей используемой памяти, так и количества записей, используемых в самом кэше.

References: #6869

[orm] [bug] ¶

Пересмотрены средства, с помощью которых аксессор ORMExecuteState.user_defined_options получает UserDefinedOption и связанные с ним объекты опций из контекста, с особым упором на стратегию «selectinload» на загрузчике, где ранее это не работало; в других стратегиях этой проблемы не было. Объекты, связанные с текущим выполняемым запросом, а не с кэшируемым запросом, теперь распространяются безусловно. Это, по сути, отделяет их от опций «стратегии загрузчика», которые явно связаны с компилированным состоянием запроса и должны использоваться по отношению к кэшируемому запросу.

Эффект этого исправления заключается в том, что определяемая пользователем опция, например, используемая в примере dogpile.caching, а также в других рецептах, таких как определение «идентификатора шарда» для расширения горизонтального обмена, будет корректно передаваться нетерпеливым и ленивым загрузчикам независимо от того, был ли в конечном итоге вызван кэшированный запрос.

References: #6887

[orm] [bug] ¶

Исправлена проблема, когда единица работы внутренне использовала 2.0-устаревшую форму выражения SQL, выдавая предупреждение об устаревании, если была включена функция SQLALCHEMY_WARN_20.

References: #6812

[orm] [bug] ¶

Исправлена проблема в selectinload(), когда использование новой функции PropComparator.and_() внутри опций, вложенных более чем на один уровень вглубь, не приводило к обновлению значений связанных параметров, которые находились во вложенных критериях, как побочный эффект кэширования SQL-операторов.

References: #6881

[orm] [bug] ¶

Скорректированы внутренние компоненты ORM-загрузчика, чтобы больше не использовать систему «лямбда-кэширования», которая была добавлена в 1.4, а также исправлено одно место, которое все еще использовало предыдущую систему «запеченных запросов» для запроса. Система лямбда-кэширования остается эффективным способом снижения накладных расходов на создание запросов, которые имеют относительно фиксированные шаблоны использования. В случае стратегий загрузчика используемые запросы отвечают за перемещение по множеству произвольных опций и критериев, которые генерируются и иногда потребляются кодом конечного пользователя, что делает концепцию лямбда-кэша не более эффективной, чем ее неиспользование, ценой большей сложности. В частности, проблемы, отмеченные #6881 и #6887, становятся значительно менее сложными, если убрать эту возможность из внутреннего кода.

References: #6079, #6889

[orm] [bug] ¶

Исправлена проблема, при которой конструкция Bundle не создавала надлежащие ключи кэша, что приводило к неэффективному использованию кэша запросов. Это оказывало некоторое влияние на стратегию «selectinload» и было определено как часть #6889.

References: #6889

[sql] [bug] ¶

Исправление проблемы в CTE, когда новый метод HasCTE.add_cte(), добавленный в версии 1.4.21 / #6752, не работал правильно для структур «compound select», таких как union(), union_all(), except() и т.д. Pull request любезно предоставлен Эриком Массераном.

References: #6752

[sql] [bug] ¶

Исправлена проблема в методе CacheKey.to_offline_string(), используемом в примере dogpile.caching, когда при попытке создать правильный ключ кэша из специального «лямбда» запроса, сгенерированного ленивым загрузчиком, значения параметров не включались, что приводило к неправильному ключу кэша.

References: #6858

[sql] [bug] ¶

Скорректирована функция предупреждения «from linter», чтобы приспособиться к цепочке объединений глубиной более одного уровня, в которой клаузулы ON не имеют явного соответствия целей, например, выражение типа «ON TRUE». Этот способ использования предназначен для отмены предупреждения о картезианском произведении просто по факту наличия JOIN от «a к b», что не работало для случая, когда цепочка объединений имела более одного элемента.

References: #6886

[sql] [bug] ¶

Исправлена проблема в системе лямбда-кэширования, когда элемент запроса, не создающий ключ кэша, например, элемент пользовательской опции или клаузулы, все равно заполнял выражение в «лямбда-кэше» неподобающим образом.

[schema] [enum] ¶

Унифицируйте поведение Enum в родной и неродной реализации относительно принимаемых значений для перечисления с алиасированными элементами. Когда Enum.omit_aliases равно False, все значения, включая псевдонимы, принимаются как допустимые. Когда Enum.omit_aliases равно True, только значения без псевдонимов принимаются как допустимые.

References: #6146

[mypy] [usecase] ¶

Добавлена поддержка определения классов SQLAlchemy в пользовательском коде с использованием синтаксиса «общего класса», определенного sqlalchemy2-stubs, например Column[String], без необходимости квалификации этих конструкций в блоке TYPE_CHECKING путем реализации специального метода Python __class_getitem__(), который позволяет этому синтаксису проходить без ошибок во время выполнения.

References: #6759, #6804

[postgresql] [bug] ¶

Добавлен флаг «is_comparison» к операторам PostgreSQL «overlaps», «contained_by», «contains», чтобы они работали в соответствующих контекстах ORM, а также в сочетании с функцией «from linter».

References: #6886

[mssql] [bug] [sql] ¶

Исправлена проблема, при которой флаг компилятора literal_binds, используемый для вывода связанных параметров в строку, не работал при использовании с определенным классом параметров, известным как «literal_execute», который охватывает такие вещи, как значения LIMIT и OFFSET для диалектов, в которых драйверы не позволяют связанный параметр, например, клаузулу «TOP» SQL Server. На местном уровне проблема, похоже, затрагивает только диалект MSSQL.

References: #6863

[bug] [ext] ¶

Исправлена проблема, при которой расширение горизонтального шардинга некорректно учитывало обычный текстовый SQL-запрос, переданный в Session.execute().

References: #6816

[orm] [bug] ¶

Исправлена проблема в новом методе Table.table_valued(), когда результирующая конструкция TableValuedColumn некорректно реагировала на адаптацию псевдонимов, как это используется в ORM, например, для нетерпеливой загрузки, полиморфной загрузки и т.д.

References: #6775

[orm] [bug] ¶

Исправлена проблема, при которой использование метода Result.unique() с результатом ORM, включающим выражения столбцов с нехешируемыми типами, такими как JSON или ARRAY, использующими не кортежи, молча возвращалось к использованию функции id(), вместо того, чтобы выдать ошибку. Теперь это приводит к ошибке, когда метод Result.unique() используется в запросе ORM в стиле 2.0. Кроме того, хэшируемость принимается за True для значений результата неизвестного типа, что часто случается при использовании SQL-функций с неизвестным возвращаемым типом; если значения действительно не хэшируемы, то сама функция hash() будет выдавать ошибку.

Для старых запросов ORM, поскольку старый объект Query уникализируется во всех случаях, старые правила остаются в силе, а именно: использовать id() для значений результата неизвестного типа, поскольку эта унаследованная уникализация в основном предназначена для уникализации сущностей ORM, а не значений столбцов.

References: #6769

[orm] [bug] ¶

Исправлена проблема, при которой очистка мапперов во время таких операций, как завершение тестового набора, могла вызвать предупреждение «размер словаря изменился» во время сборки мусора, из-за итерации словаря со слабыми ссылками. Для предотвращения влияния одновременного GC на эту операцию была применена list().

References: #6771

[orm] [bug] [regression] ¶

Исправлена критическая проблема кэширования, когда функция сохранения ORM с помощью INSERT..RETURNING кэшировала некорректный запрос при смешивании форм INSERT «bulk save» и стандартного «flush».

References: #6793

[engine] [bug] ¶

Добавлены некоторые меры защиты от KeyError в системе событий, чтобы учесть случай, когда интерпретатор завершает работу в то же время, когда вызывается Engine.dispose(), что привело бы к предупреждениям о трассировке стека.

References: #6740

[sql] [bug] ¶

Исправлена проблема, при которой использование параметра case.whens, передающего словарь позиционно, а не в качестве аргумента ключевого слова, выдавало предупреждение об устаревании версии 2.0, ссылаясь на устаревание передачи списка позиционно. Формат словаря «whens», передаваемый позиционно, по-прежнему поддерживается и случайно был помечен как устаревший.

References: #6786

[sql] [bug] ¶

Исправлена проблема, при которой обработчики связанных параметров, специфичные для конкретного типа, не вызывались в случае использования метода Insert.values() со значением Python None; в частности, это было заметно при использовании типа данных JSON, а также связанных с ним типов PostgreSQL, таких как JSONB, которые не кодировали значение Python None в JSON null, однако проблема была обобщена на любой обработчик связанных параметров в сочетании с этим специфичным методом Insert.

References: #6770

[orm] [usecase] ¶

Изменен подход, используемый для отслеживания истории отношений скалярных объектов, которые не являются отношениями «многие-к-одному», т.е. отношения «один-к-одному», которые в противном случае были бы отношениями «один-ко-многим». При замене значения один-к-одному «старое» значение, которое будет заменено, больше не загружается немедленно, а обрабатывается в процессе смыва. Это устраняет исторически неприятную ленивую загрузку, которая часто возникает при присвоении атрибута один-к-одному, и особенно неприятна при использовании «lazy=“raise“», а также в случаях использования asyncio.

Это изменение вызывает изменение поведения события AttributeEvents.set(), которое, тем не менее, в настоящее время документировано, а именно: событие, примененное к такому атрибуту один-к-одному, больше не будет получать «старый» параметр, если оно выгружено и флаг relationship.active_history не установлен. Как документировано в AttributeEvents.set(), если обработчику события необходимо получить «старое» значение при срабатывании события, флаг active_history должен быть установлен либо у слушателя события, либо у отношения. Это уже поведение с другими видами атрибутов, такими как многие-к-одному и ссылки на значения столбцов.

Это изменение дополнительно отложит обновление обратного ссылки на «старое» значение в менее распространенном случае, когда «старое» значение локально присутствует в сессии, но не загружено в рассматриваемое отношение, до следующей очистки. Если это вызывает проблему, опять же, обычный флаг relationship.active_history может быть установлен в True для отношения.

References: #6708

[orm] [bug] [regression] ¶

Исправлена регрессия, возникшая в 1.4.19 из-за #6503 и связанных с ним Query.with_entities(), когда используемая новая структура неправомерно передавалась в объемлющий Query при использовании операций с множествами, таких как Query.union(), в результате чего инструкции JOIN внутри применялись и к внешнему запросу.

References: #6698

[orm] [bug] [regression] ¶

Исправлена регрессия, появившаяся в версии 1.4.3 из-за #6060, когда правила, ограничивающие ORM-адаптацию производных selectables, вмешивались в другие случаи, основанные на ORM-адаптации, в данном случае при применении адаптации для with_polymorphic() к отображению, использующему column_property(), которое в свою очередь использует скалярный select, включающий aliased() объект отображаемой таблицы.

References: #6762

[orm] [regression] ¶

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

References: #6718

[sql] [usecase] ¶

Добавлен новый метод HasCTE.add_cte() к каждой из конструкций select(), insert(), update() и delete(). Этот метод добавит данный CTE в качестве «независимого» CTE оператора, то есть он безоговорочно отображается в предложение WITH над оператором, даже если на него нет других ссылок в основном операторе. Это популярный случай использования в базе данных PostgreSQL, когда CTE используется для оператора DML, который работает со строками базы данных независимо от основного оператора.

References: #6752

[sql] [bug] ¶

Исправлена проблема в конструкциях CTE, когда рекурсивный CTE, ссылающийся на SELECT с дублирующимися именами столбцов, которые обычно дедуплицируются с помощью логики маркировки в 1.4, не мог правильно сослаться на дедуплицированное имя метки в предложении WITH.

References: #6710

[sql] [bug] [regression] ¶

Исправлена регрессия, при которой конструкция tablesample() была неисполнимой, если она строилась с учетом значения выборки с плавающей точкой, не встроенной в функцию SQL.

References: #6735

[postgresql] [bug] ¶

Исправлена проблема в Insert.on_conflict_do_nothing() и Insert.on_conflict_do_update(), когда имя уникального ограничения, переданное в качестве параметра constraint, не усекалось по длине, если оно было основано на соглашении об именовании, которое создавало слишком длинное имя для максимальной длины идентификатора PostgreSQL в 63 символа, аналогично тому, как это происходит в операторе CREATE TABLE.

References: #6755

[postgresql] [bug] ¶

Исправлена проблема, из-за которой тип данных PostgreSQL ENUM, встроенный в тип данных ARRAY, не работал корректно в режиме create/drop, когда также использовалась функция schema_translate_map. Кроме того, была устранена связанная с этим проблема, когда та же функция schema_translate_map не работала для типа данных ENUM в комбинации с CAST, что также присуще тому, как комбинация ARRAY(ENUM) работает в диалекте PostgreSQL.

References: #6739

[postgresql] [bug] ¶

Исправлена проблема в Insert.on_conflict_do_nothing() и Insert.on_conflict_do_update(), когда имя уникального ограничения, переданное в качестве параметра constraint, не заключалось в кавычки, если содержало символы, требующие кавычек.

References: #6696

[mssql] [bug] [regression] ¶

Исправлена регрессия, при которой специальная обработка точечных имен схем для диалекта SQL Server работала неправильно, если точечное имя схемы использовалось в функции schema_translate_map.

References: #6697

[orm] [bug] [regression] ¶

Исправлена регрессия в ORM, касающаяся внутреннего шага восстановления для конструкции with_polymorphic(), когда объект, обращенный к пользователю, собирается в мусор в процессе обработки запроса. Восстановление не обеспечивало обработку подсубъектов для «полиморфного» случая, что приводило к появлению AttributeError.

References: #6680

[orm] [bug] [regression] ¶

Скорректировано Query.union() и аналогичные операции с множествами для корректной совместимости с новыми возможностями, только что добавленными в #6661, с SQLAlchemy 1.4. 19, так что операторы SELECT, отображаемые как элементы операции UNION или другого набора, будут включать непосредственно сопоставленные столбцы, которые отображаются как отложенные; это устраняет регрессию, связанную с союзами с несколькими уровнями вложенности, которые приводили к несоответствию столбцов, а также позволяет использовать опцию undefer() на верхнем уровне такого Query без необходимости применять опцию к каждому из элементов внутри UNION.

References: #6678

[orm] [bug] ¶

Скорректирована проверка в маппере для вызываемого объекта, который используется как функция валидатора @validates или функция реконструкции @reconstructor, для более свободной проверки «вызываемого», например, для размещения объектов, основанных на фундаментальных атрибутах, таких как __func__ и __call__, вместо проверки на MethodType / FunctionType, что позволяет таким вещам, как функции cython, работать правильно. Pull request courtesy Miłosz Stypiński.

References: #6538

[engine] [bug] ¶

Исправлена проблема в расширении C для класса Row, которая могла привести к утечке памяти в маловероятном случае, когда объект Row ссылался на объект ORM, который затем мутировал, чтобы снова ссылаться на сам Row, создавая цикл. API Python C для отслеживания циклов GC был добавлен в родную реализацию Row, чтобы учесть этот случай.

References: #5348

[engine] [bug] ¶

Исправлена старая проблема, когда при выполнении select() против маркера «*», который затем давал ровно один столбец, имя столбца cursor.description не удавалось правильно организовать в ключи объекта результата.

References: #6665

[sql] [usecase] ¶

Добавьте параметр impl в конструктор PickleType, позволяющий использовать любой произвольный тип вместо реализации по умолчанию LargeBinary. Pull request любезно предоставлен jason3gb.

References: #6646

[sql] [bug] [orm] ¶

Исправлена иерархия классов для базы Sequence и более общей базы DefaultGenerator, поскольку они являются «исполняемыми» как утверждения, они должны включать Executable в свою иерархию, а не только StatementRole, как это произвольно применялось к Sequence ранее. Исправление позволяет Sequence работать во всех методах .execute(), включая Session.execute(), который не работал в случае, если был также создан обработчик SessionEvents.do_orm_execute().

References: #6668

[schema] [bug] ¶

Исправлена проблема, при которой передача None для значения Table.prefixes сохраняла не пустой список, а константу None, что могло быть неожиданным для сторонних диалектов. Проблема выявлена при использовании в последних версиях Alembic, которые передают None для этого значения. Pull request любезно предоставлен Каем Мюллером.

References: #6685

[mysql] [usecase] ¶

Внесена небольшая корректировка в функцию отражения таблиц в диалекте MySQL для адаптации к альтернативным базам данных, ориентированным на MySQL, таким как TiDB, которые включают свои собственные директивы «комментарий» в конце директивы ограничения в «CREATE TABLE», где формат не имеет дополнительного символа пробела после комментария, в данном случае функция TiDB «кластерный индекс». Pull request любезно предоставлен Daniël van Eeden.

References: #6659

[bug] [ext] [regression] ¶

Исправлена регрессия в расширении sqlalchemy.ext.automap, из-за которой случай создания явного сопоставленного класса с таблицей, которая также является relationship.secondary элементом relationship(), генерируемого automap, выдавал предупреждения «перекрытия», введенные в 1.4 и обсуждаемые в отношение X скопирует столбец Q в столбец P, что противоречит отношению(ям): „Y“. Хотя генерация этого случая из automap все еще подвержена тем же предостережениям, к которым относится предупреждение «перекрытия», поскольку automap предназначен для более специальных случаев использования, условие, вызывающее предупреждение, отключается, когда генерируется отношение «многие-ко-многим» с этим конкретным шаблоном.

References: #6679

[orm] [bug] [regression] ¶

Исправлены дальнейшие регрессии в той же области, что и в #6052, где опции загрузчика, а также вызовы таких методов, как Query.join(), будут неудачными, если левая часть утверждения, от которого зависит опция/соединение, будет заменена с помощью метода Query.with_entities(), или при использовании запросов в стиле 2.0 с помощью метода Select.with_only_columns(). К объектам был добавлен новый набор состояний, который отслеживает «левые» сущности, по отношению к которым были сделаны опции/соединения, которые мемоизируются при изменении ведущих сущностей.

References: #6253, #6503

[orm] [bug] ¶

Усовершенствовано поведение рендеринга подзапросов ORM в отношении отложенных столбцов и свойств столбцов, чтобы сделать его более совместимым с 1.3 и в то же время обеспечить более новые возможности 1.4. Поскольку подзапрос в 1.4 не использует опции загрузчика, включая undefer(), подзапрос, направленный на сущность ORM с отложенными атрибутами, теперь будет отображать те отложенные атрибуты, которые ссылаются непосредственно на сопоставленные столбцы таблицы, поскольку они необходимы во внешнем SELECT, если внешний SELECT использует эти столбцы; однако отложенные атрибуты, которые ссылаются на составленное SQL-выражение, как мы обычно делаем с column_property(), не будут частью подзапроса, поскольку они могут быть выбраны явно, если это необходимо в подзапросе. Если сущность выбирается из этого подзапроса, то выражение столбца все равно может отображаться «снаружи» в терминах производных столбцов подзапроса. Это приводит к такому же поведению, как и при работе с 1.3. Однако в этом случае исправление также должно гарантировать, что коллекция .selected_columns в коллекции select() с поддержкой ORM также следует этим правилам, что, в частности, позволяет рекурсивным CTE корректно отображаться в этом сценарии, которые ранее не отображались корректно из-за этой проблемы.

References: #6661

[sql] [bug] ¶

Исправлена проблема в конструкциях CTE, в основном относящаяся к случаям использования ORM, когда рекурсивный CTE против «анонимных» меток, таких как те, что встречаются в связках ORM column_property(), приводил в секции WITH RECURSIVE xyz(...) их необработанную внутреннюю метку, а не чистое анонимизированное имя.

References: #6663

[mypy] [bug] ¶

Исправлена проблема в плагине mypy, когда информация о классе для пользовательской декларативной базы не обрабатывалась корректно при кэшированном проходе mypy, что приводило к возникновению ошибки AssertionError.

References: #6476

[asyncio] [usecase] ¶

Реализована async_scoped_session для решения некоторых асинхронных несовместимостей между scoped_session и AsyncSession, в которых некоторые методы (в частности, метод async_scoped_session.remove()) должны использоваться с ключевым словом await.

References: #6583

[asyncio] [bug] [postgresql] ¶

Исправлена ошибка в реализации asyncio, когда система адаптации greenlet не распространяла подклассы BaseException, особенно включая asyncio.CancelledError, на логику обработки исключений, используемую движком для аннулирования и очистки соединения, тем самым предотвращая корректную утилизацию соединений при отмене задачи.

References: #6652

[postgresql] [bug] [oracle] ¶

Исправлена проблема, при которой тип данных INTERVAL в PostgreSQL и Oracle выдавал AttributeError при использовании в контексте операции сравнения с объектом timedelta(). Pull request любезно предоставлен MajorDallas.

References: #6649

[postgresql] [bug] ¶

Исправлена проблема, когда функция «pre ping» пула неявно запускала транзакцию, что мешало использованию пользовательских транзакционных флагов, таких как режим «только чтение» PostgreSQL, при использовании с драйвером psycopg2.

References: #6621

[mysql] [usecase] ¶

Добавлена новая конструкция match, которая обеспечивает полный спектр возможностей оператора MySQL MATCH, включая поддержку нескольких столбцов и модификаторы. Pull request любезно предоставлен Антоном Ковалевичем.

References: #6132

[mssql] [change] ¶

Внесены улучшения в regexp версии сервера, используемый диалектом pymssql, для предотвращения переполнения regexp в случае недопустимой строки версии.

References: #6253, #6503

[mssql] [bug] ¶

Исправлена ошибка, при которой функция «schema_translate_map» не работала корректно в сочетании с INSERT в таблицу с колонкой IDENTITY, где значение колонки IDENTITY указывалось в значениях INSERT, тем самым вызывая функцию SQLAlchemy по установке IDENTITY INSERT в значение «on»; именно в этой директиве карта перевода схемы не выполнялась.

References: #6658

[orm] [performance] [bug] [regression] ¶

Исправлена регрессия, связанная с тем, как ORM разрешает заданный сопоставленный столбец в строку результата, когда в таких случаях, как объединенная нетерпеливая загрузка, для установки этого разрешения мог иметь место немного более дорогой «откат» из-за некоторой логики, которая была удалена с версии 1.3. Эта проблема также может привести к выдаче предупреждений об устаревании, связанных с разрешением столбцов, при использовании запросов в стиле 1.4 с объединенной ускоренной загрузкой.

References: #6596

[orm] [bug] ¶

Уточнено текущее назначение флага relationship.bake_queries, который в версии 1.4 используется для включения или отключения «лямбда-кэширования» утверждений в рамках стратегий загрузчика «lazyload» и «selectinload»; это отделено от более фундаментального кэша SQL-запросов, который используется для большинства утверждений. Кроме того, ленивый загрузчик больше не использует свой собственный кэш для SQL-запросов типа «многие к одному», что было причудой реализации, не существующей ни для одного другого сценария загрузчика. Наконец, предупреждение «lru cache», которое стратегии lazyloader и selectinloader могли выдавать при работе с широким набором комбинаций классов/отношений, было удалено; на основе анализа некоторых случаев конечных пользователей, это предупреждение не указывает на какую-либо существенную проблему. Хотя установка bake_queries=False для такого отношения удалит этот кэш из использования, особого выигрыша в производительности в этом случае нет, так как использование без кэширования по сравнению с использованием кэша, который нужно часто обновлять, скорее всего, все равно выигрывает в пользу используемого кэширования.

References: #6072, #6487

[orm] [bug] [regression] ¶

Скорректировано средство, с помощью которого такие классы, как scoped_session и AsyncSession генерируются из базового класса Session, так что пользовательским подклассам Session, например, используемым в Flask-SQLAlchemy, не нужно реализовывать позиционные аргументы при вызове метода суперкласса, и они могут продолжать использовать те же стили аргументов, что и в предыдущих выпусках.

References: #6285

[orm] [bug] [regression] ¶

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

References: #6595

[orm] [bug] ¶

Исправлена проблема в экспериментальном примере использования «select ORM objects from INSERT/UPDATE», когда возникала ошибка, если оператор был направлен против подкласса, наследующего одну таблицу.

References: #6591

[orm] [bug] ¶

Предупреждение, выдаваемое для relationship(), когда несколько отношений будут перекрывать друг друга в части атрибутов внешнего ключа, теперь включает в себя конкретный аргумент «overlaps», который следует использовать для каждого предупреждения, чтобы заглушить предупреждение без изменения отображения.

References: #6400

[asyncio] [usecase] ¶

Реализована новая архитектура реестра, которая позволяет Async версии объекта, например AsyncSession, AsyncConnection и т.д., быть доступной для поиска, учитывая проксированный «синхронный» объект, т.е. Session, Connection. Ранее, когда использовались такие функции поиска, объект Async создавался каждый раз заново, что было менее чем идеально, так как идентичность и состояние объекта «async» не сохранялись при каждом вызове.

Отсюда были добавлены новые вспомогательные функции async_object_session(), async_session(), а также новый атрибут InstanceState InstanceState.async_session, которые используются для получения исходного AsyncSession, связанного с ORM mapped object, Session, связанного с AsyncSession, и AsyncSession, связанного с InstanceState, соответственно.

В этом патче также реализованы новые методы AsyncSession.in_nested_transaction(), AsyncSession.get_transaction(), AsyncSession.get_nested_transaction().

References: #6319

[asyncio] [bug] ¶

Исправлена проблема, возникавшая при использовании NullPool или StaticPool с асинхронным механизмом. В основном это касалось диалекта aiosqlite.

References: #6575

[asyncio] [bug] ¶

Добавлены asyncio.exceptions.TimeoutError, asyncio.exceptions.CancelledError как так называемые «исключения выхода», класс исключений, включающий такие вещи, как GreenletExit и KeyboardInterrupt, которые считаются событиями, дающими основание считать соединение DBAPI непригодным для использования и подлежащим утилизации.

References: #6592

[postgresql] [bug] [regression] ¶

Исправлена регрессия, при которой использование структуры PostgreSQL «INSERT..ON CONFLICT» не работало с драйвером psycopg2, если она использовалась в контексте «executemany» вместе со связанными параметрами в предложении «SET», из-за неявного использования помощников быстрого выполнения psycopg2, которые не подходят для этого стиля оператора INSERT; поскольку эти помощники используются по умолчанию в 1.4, это фактически является регрессией. Были добавлены дополнительные проверки, чтобы исключить этот тип оператора из данного конкретного расширения.

References: #6581

[sqlite] [bug] ¶

Добавьте примечание относительно прагм, связанных с шифрованием, для pysqlcipher, передаваемого в url.

This change is also backported to: 1.3.25

References: #6589

[sqlite] [bug] [regression] ¶

Исправление для pysqlcipher, выпущенное в версии 1.4.3 #5848, к сожалению, было нерабочим, поскольку новый хук on_connect_url ошибочно не получал объект URL при нормальном использовании create_engine(), а вместо него получал необработанную строку; набор тестов не смог полностью установить реальные условия, при которых вызывается этот хук. Это было исправлено.

References: #6586

[orm] [bug] [regression] ¶

Исправлена регрессия, вызванная только что выпущенным исправлением производительности, упомянутым в #6550, когда запрос query.join() к отношению мог выдать ошибку AttributeError, если запрос выполнялся только к не-ORM структурам, что является довольно необычным шаблоном вызова.

References: #6558

[general] [bug] ¶

Устранены различные предупреждения об устаревании, которые появлялись начиная с версии Python 3.10.0b1.

References: #6540, #6543

[orm] [bug] ¶

Исправлена проблема при использовании параметра relationship.cascade_backrefs, установленного в False, который в соответствии с cascade_backrefs behavior deprecated for removal in 2.0 станет стандартным поведением в SQLAlchemy 2.0, когда добавление элемента в коллекцию, которая уникализирует, например, set или dict, не вызывало каскадного события, если объект уже был связан с этой коллекцией через обратную ссылку. Это исправление представляет собой фундаментальное изменение в механике коллекций, вводя новое состояние события, которое может сработать при мутации коллекции, даже если в коллекции нет чистых изменений; теперь это действие выполняется с помощью нового хука события AttributeEvents.append_wo_mutation().

References: #6471

[orm] [bug] [regression] ¶

Исправлена регрессия, связанная с адаптацией пунктов для маркированных составных элементов ORM, таких как выражения дискриминатора наследования одной таблицы с условиями или CASE-выражения, что могло привести к неправильной адаптации псевдослучайных выражений, таких как используемые в операциях ORM join / joinload, например, обращение к неправильной таблице в пункте ON в соединении.

Это изменение также улучшает недостаток производительности, который возникал в процессе вызова Select.join(), когда в качестве цели указывался атрибут ORM.

References: #6550

[orm] [bug] [regression] ¶

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

References: #6495

[orm] [bug] ¶

Усовершенствованы правила разрешения привязки для Session.execute(), так что когда не-ORM утверждение, такое как конструкция insert(), тем не менее строится против ORM объектов, в максимально возможной степени ORM сущность будет использоваться для разрешения привязки, например, для Session, который имеет карту привязки, установленную на общем суперклассе без конкретных мапперов или таблиц, названных в карте.

References: #6484

[engine] [bug] ¶

Исправлена проблема, при которой знак @ в части URL, посвященной базе данных, интерпретировался неправильно, если URL также содержал раздел имя пользователя:пароль.

References: #6482

[engine] [bug] ¶

Исправлена давняя проблема с URL, когда параметры запроса, следующие за вопросительным знаком, не обрабатывались правильно, если URL не содержал часть базы данных с обратной косой чертой.

References: #6329

[sql] [bug] [regression] ¶

Исправлена регрессия в стратегии динамического загрузчика и relationship() overall, когда параметр relationship.order_by хранился как изменяемый список, который затем мог быть изменен в сочетании с дополнительными методами «order_by», используемыми против объекта динамического запроса, что приводило к повторяющемуся росту критериев ORDER BY.

References: #6549

[mssql] [usecase] ¶

Реализована поддержка использования конструкции CTE непосредственно в качестве цели конструкции delete(), т.е. «WITH … AS cte DELETE FROM cte». Это представляется полезной функцией SQL Server.

References: #6464

[bug] [ext] ¶

Исправлено предупреждение об устаревании, которое выдавалось при использовании automap_base() без передачи существующего Base.

References: #6529

[bug] [pep484] ¶

Удалить типы pep484 из кода. Текущие усилия направлены на пакет заглушек, а наличие типов в двух местах ухудшает ситуацию, так как типы в исходниках SQLAlchemy обычно устарели по сравнению с версиями в заглушках.

References: #6461

[bug] [ext] [regression] ¶

Исправлена регрессия в расширении sqlalchemy.ext.instrumentation, из-за которой утилизация инструментов не работала полностью. Это исправление включает в себя как исправление регрессии в версии 1.4, так и исправление связанной с ней проблемы, которая существовала и в версии 1.3. В рамках этого изменения класс sqlalchemy.ext.instrumentation.InstrumentationManager теперь имеет новый метод unregister(), который заменяет предыдущий метод dispose(), который не вызывался начиная с версии 1.4.

References: #6390

[general] [feature] ¶

Новый подход был применен к системе предупреждений в SQLAlchemy для точного динамического предсказания соответствующего уровня стека для каждого предупреждения. Это позволяет более просто оценить источник предупреждений, генерируемых SQLAlchemy, и предупреждений об устаревании, поскольку предупреждение будет указывать на исходную строку в коде конечного пользователя, а не на произвольный уровень в собственном исходном коде SQLAlchemy.

References: #6241

[orm] [bug] [regression] ¶

Исправлена дополнительная регрессия, вызванная функцией #1763 «eager loaders run on unexpire», когда функция запускалась для опции contains_eager() eagerload в случае, если contains_eager() были соединены в цепь с дополнительной опцией eager loader, что приводило к некорректному запросу, так как исходные критерии объединения, связанные с запросом, больше не присутствовали.

References: #6449

[orm] [bug] ¶

Исправлена проблема в стратегии загрузчика подзапросов, из-за которой кэширование не работало корректно. В журналах это выглядело как сообщение «generated» вместо «cached» для всех SQL-запросов, выдаваемых при загрузке подзапросов, что, насыщая кэш новыми ключами, снижало общую производительность; это также вызывало предупреждения «LRU size alert».

References: #6459

[sql] [bug] ¶

Скорректирована логика, добавленная в 1.4.12 в качестве части #6397, таким образом, чтобы внутренняя мутация объекта BindParameter происходила на этапе построения клаузы, как это было раньше, а не на этапе компиляции. В последнем случае мутация все еще производила побочные эффекты против входящей конструкции и, кроме того, могла потенциально вмешиваться в работу других процедур внутренней мутации.

References: #6460

[mysql] [bug] [documentation] ¶

Добавлена поддержка параметра ssl_check_hostname= в URIs соединений mysql и обновлена документация по диалекту mysql относительно безопасных соединений. Оригинальный pull request любезно предоставлен Джерри Чжао.

References: #5397

[orm] [bug] [regression] ¶

Исправлена регрессия, связанная с загрузчиком lazy='dynamic' в сочетании с отделенным объектом. Предыдущее поведение заключалось в том, что динамический загрузчик при вызове методов типа .all() возвращает пустые списки для отсоединенных объектов без ошибок, это было восстановлено; однако теперь выдается предупреждение, поскольку это не является правильным результатом. Другие сценарии динамического загрузчика корректно возвращают DetachedInstanceError.

References: #6426

[engine] [usecase] [orm] ¶

Применили последовательное поведение к случаю вызова .commit() или .rollback() внутри существующего .begin() менеджера контекста, с добавлением потенциально возможного испускания SQL внутри блока после фиксации или отката. Это изменение продолжает изменение, впервые добавленное в #6155, где был предложен случай использования вызова «rollback» внутри блока контекстного менеджера .begin():

• вызов .commit() или .rollback() теперь будет разрешен без ошибок и предупреждений во всех диапазонах, включая унаследованные и будущие Engine, ORM Session, asyncio AsyncEngine. Ранее Session запрещал это.

• Затем закрывается оставшаяся область действия менеджера контекста; когда блок завершается, выдается проверка, была ли транзакция уже завершена, и если да, то блок возвращается без каких-либо действий.

• Теперь будет возникать ошибка, если последующий SQL любого вида будет выдан внутри блока, после вызова .commit() или .rollback(). Блок должен быть закрыт, так как состояние исполняемого объекта в этом случае будет неопределенным.

References: #6288

[engine] [bug] [regression] ¶

Установлен путь устаревания для вызова метода CursorResult.keys() для оператора, который не возвращает строк, чтобы обеспечить поддержку устаревших шаблонов, используемых пакетом «records», а также любых других немигрированных приложений. Ранее метод вызывал безусловную ошибку ResourceClosedException, как и при попытке получить строки. Хотя это правильное поведение в дальнейшем, объект _cursor.LegacyCursorResult теперь в этом случае будет возвращать пустой список для .keys(), как это было в версии 1.3, а также выдавать предупреждение об устаревании версии 2.0. Объект _cursor.CursorResult, используемый при использовании движка «будущего» в стиле 2.0, будет продолжать возвращать пустой список, как и сейчас.

References: #6427

[sql] [bug] [regression] ¶

Исправлена регрессия, вызванная изменением «пусто в», только что сделанным в #6397 1.4.12, где выражение должно быть заключено в скобки для случая использования «не в», иначе условие будет мешать другим критериям фильтрации.

References: #6428

[sql] [bug] [regression] ¶

Класс TypeDecorator теперь будет выдавать предупреждение при использовании в компиляции SQL с кэшированием, если флаг .cache_ok не установлен на True или False. Можно установить новый атрибут уровня класса TypeDecorator.cache_ok, который будет использоваться как признак того, что все параметры, переданные объекту, безопасны для использования в качестве ключа кэша, если установлено значение True, False означает, что нет.

References: #6436

[orm] [bug] [regression] ¶

Исправлена регрессия в стратегии загрузчика selectinload, из-за которой он некорректно кэшировал свое внутреннее состояние при работе с отношениями, объединяющими более одного столбца, например, при использовании составного внешнего ключа. Некорректное кэширование приводило к сбою других несвязанных операций загрузчика.

References: #6410

[orm] [bug] [regression] ¶

Исправлена регрессия, при которой Query.filter_by() не работал, если ведущей сущностью была SQL-функция или другое выражение, производное от первичной сущности, а не простая сущность или столбец этой сущности. Кроме того, улучшено поведение Select.filter_by() в целом для работы с выражениями столбцов даже в не-ORM контексте.

References: #6414

[orm] [bug] [regression] ¶

Исправлена ошибка, при которой использование selectinload() и subqueryload() для загрузки пути глубиной в два уровня приводило к ошибке атрибута.

References: #6419

[orm] [bug] [regression] ¶

Исправлена регрессия, при которой использование стратегии загрузчика noload() в сочетании с «динамическим» отношением приводило к ошибке атрибута, поскольку стратегия noload пыталась применить себя к динамическому загрузчику.

References: #6420

[engine] [bug] [regression] ¶

Восстановлено устаревшее транзакционное поведение, которое было непреднамеренно удалено из Connection, так как оно никогда не тестировалось как известный случай использования в предыдущих версиях, когда вызов метода Connection.begin_nested() при отсутствии транзакции вообще не создает SAVEPOINT, а вместо этого запускает внешнюю транзакцию, возвращая объект RootTransaction вместо объекта NestedTransaction. Затем этот объект RootTransaction будет выдавать настоящий COMMIT на соединение с базой данных при фиксации. Ранее поведение в стиле 2.0 присутствовало во всех случаях, которые автозапускали транзакцию, но не фиксировали ее, что является изменением поведения.

При использовании объекта соединения 2.0 style поведение не изменилось по сравнению с предыдущими версиями 1.4; вызов Connection.begin_nested() «автозапускает» внешнюю транзакцию, если она еще не существует, а затем, согласно инструкциям, выдает SAVEPOINT, возвращая объект NestedTransaction. Внешняя транзакция фиксируется вызовом Connection.commit(), как и положено при использовании стиля «commit-as-you-go».

В режиме без «будущего», хотя старое поведение восстанавливается, оно также выдает предупреждение об обесценивании 2.0, поскольку это унаследованное поведение.

References: #6408

[asyncio] [bug] [regression] ¶

Исправлена регрессия, вызванная #6337, которая создавала asyncio.Lock, который мог быть присоединен к неправильному циклу при инстанцировании движка async до запуска любого цикла asyncio, что приводило к сообщению об ошибке asyncio при попытке использовать движок при определенных обстоятельствах.

References: #6409

[postgresql] [usecase] ¶

Добавьте поддержку курсоров на стороне сервера в диалекте pg8000 для PostgreSQL. Это позволяет использовать опцию Connection.execution_options.stream_results.

References: #6198

[orm] [bug] ¶

Исправлена проблема в Session.bulk_save_objects() при использовании с постоянными объектами, из-за которой не удавалось отследить первичный ключ в связках, где имя столбца первичного ключа отличалось от имени атрибута.

This change is also backported to: 1.3.25

References: #6392

[orm] [bug] [caching] [regression] ¶

Fixed critical regression where bound parameter tracking as used in the SQL caching system could fail to track all parameters for the case where the same SQL expression containing a parameter were used in an ORM-related query using a feature such as class inheritance, which was then embedded in an enclosing expression which would make use of that same expression multiple times, such as a UNION. The ORM would individually copy the individual SELECT statements as part of compilation with class inheritance, which then embedded in the enclosing statement would fail to accommodate for all parameters. The logic that tracks this condition has been adjusted to work for multiple copies of a parameter.

References: #6391

[orm] [bug] ¶

Fixed two distinct issues mostly affecting hybrid_property, which would come into play under common mis-configuration scenarios that were silently ignored in 1.3, and now failed in 1.4, where the «expression» implementation would return a non ClauseElement such as a boolean value. For both issues, 1.3’s behavior was to silently ignore the mis-configuration and ultimately attempt to interpret the value as a SQL expression, which would lead to an incorrect query.

• Fixed issue regarding interaction of the attribute system with hybrid_property, where if the __clause_element__() method of the attribute returned a non-ClauseElement object, an internal AttributeError would lead the attribute to return the expression function on the hybrid_property itself, as the attribute error was against the name .expression which would invoke the __getattr__() method as a fallback. This now raises explicitly. In 1.3 the non-ClauseElement was returned directly.

• Fixed issue in SQL argument coercions system where passing the wrong kind of object to methods that expect column expressions would fail if the object were altogether not a SQLAlchemy object, such as a Python function, in cases where the object were not just coerced into a bound value. Again 1.3 did not have a comprehensive argument coercion system so this case would also pass silently.

References: #6350

[orm] [bug] ¶

Fixed issue where using a Select as a subquery in an ORM context would modify the Select in place to disable eagerloads on that object, which would then cause that same Select to not eagerload if it were then re-used in a top-level execution context.

References: #6378

[orm] [bug] [regression] ¶

Fixed issue where the new autobegin behavior failed to «autobegin» in the case where an existing persistent object has an attribute change, which would then impact the behavior of Session.rollback() in that no snapshot was created to be rolled back. The «attribute modify» mechanics have been updated to ensure «autobegin», which does not perform any database work, does occur when persistent attributes change in the same manner as when Session.add() is called. This is a regression as in 1.3, the rollback() method always had a transaction to roll back and would expire every time.

References: #6359, #6360

[orm] [bug] [regression] ¶

Fixed regression in ORM where using hybrid property to indicate an expression from a different entity would confuse the column-labeling logic in the ORM and attempt to derive the name of the hybrid from that other class, leading to an attribute error. The owning class of the hybrid attribute is now tracked along with the name.

References: #6386

[orm] [bug] [regression] ¶

Fixed regression in hybrid_property where a hybrid against a SQL function would generate an AttributeError when attempting to generate an entry for the .c collection of a subquery in some cases; among other things this would impact its use in cases like that of Query.count().

References: #6401

[orm] [bug] [dataclasses] ¶

Adjusted the declarative scan for dataclasses so that the inheritance behavior of declared_attr() established on a mixin, when using the new form of having it inside of a dataclasses.field() construct and not actually a descriptor attribute on the class, correctly accommodates the case when the target class to be mapped is a subclass of an existing mapped class which has already mapped that declared_attr(), and therefore should not be re-applied to this class.

References: #6346

[orm] [bug] ¶

Fixed an issue with the (deprecated in 1.4) ForeignKeyConstraint.copy() method that caused an error when invoked with the schema argument.

References: #6353

[engine] [bug] ¶

Fixed issue where usage of an explicit Sequence would produce inconsistent «inline» behavior for an Insert construct that includes multiple values phrases; the first seq would be inline but subsequent ones would be «pre-execute», leading to inconsistent sequence ordering. The sequence expressions are now fully inline.

References: #6361

[sql] [bug] ¶

Revised the «EMPTY IN» expression to no longer rely upon using a subquery, as this was causing some compatibility and performance problems. The new approach for selected databases takes advantage of using a NULL-returning IN expression combined with the usual «1 != 1» or «1 = 1» expression appended by AND or OR. The expression is now the default for all backends other than SQLite, which still had some compatibility issues regarding tuple «IN» for older SQLite versions.

Third party dialects can still override how the «empty set» expression renders by implementing a new compiler method def visit_empty_set_op_expr(self, type_, expand_op), which takes precedence over the existing def visit_empty_set_expr(self, element_types) which remains in place.

References: #6258, #6397

[sql] [bug] [regression] ¶

Fixed regression where usage of the text() construct inside the columns clause of a Select construct, which is better handled by using a literal_column() construct, would nonetheless prevent constructs like union() from working correctly. Other use cases, such as constructing subuqeries, continue to work the same as in prior versions where the text() construct is silently omitted from the collection of exported columns. Also repairs similar use within the ORM.

References: #6343

[sql] [bug] [regression] ¶

Fixed regression involving legacy methods such as Select.append_column() where internal assertions would fail.

References: #6261

[sql] [bug] [regression] ¶

Fixed regression caused by #5395 where tuning back the check for sequences in select() now caused failures when doing 2.0-style querying with a mapped class that also happens to have an __iter__() method. Tuned the check some more to accommodate this as well as some other interesting __iter__() scenarios.

References: #6300

[schema] [bug] [mariadb] [mysql] [oracle] [postgresql] ¶

Ensure that the MySQL and MariaDB dialect ignore the Identity construct while rendering the AUTO_INCREMENT keyword in a create table.

The Oracle and PostgreSQL compiler was updated to not render Identity if the database version does not support it (Oracle < 12 and PostgreSQL < 10). Previously it was rendered regardless of the database version.

References: #6338

[postgresql] [bug] ¶

Fixed very old issue where the Enum datatype would not inherit the MetaData.schema parameter of a MetaData object when that object were passed to the Enum using Enum.metadata.

References: #6373

[sqlite] [usecase] ¶

Default to using SingletonThreadPool for in-memory SQLite databases created using URI filenames. Previously the default pool used was the NullPool that precented sharing the same database between multiple engines.

References: #6379

[mssql] [bug] [schema] ¶

Add TypeEngine.as_generic() support for sqlalchemy.dialects.mysql.BIT columns, mapping them to Boolean.

References: #6345

[mssql] [bug] [regression] ¶

Fixed regression caused by #6306 which added support for DateTime(timezone=True), where the previous behavior of the pyodbc driver of implicitly dropping the tzinfo from a timezone-aware date when INSERTing into a timezone-naive DATETIME column were lost, leading to a SQL Server error when inserting timezone-aware datetime objects into timezone-native database columns.

References: #6366

[orm] [declarative] [bug] [regression] ¶

Fixed regression where recent changes to support Python dataclasses had the inadvertent effect that an ORM mapped class could not successfully override the __new__() method.

References: #6331

[engine] [bug] [regression] ¶

Fixed critical regression caused by the change in #5497 where the connection pool «init» phase no longer occurred within mutexed isolation, allowing other threads to proceed with the dialect uninitialized, which could then impact the compilation of SQL statements.

References: #6337

[orm] [usecase] ¶

Altered some of the behavior repaired in #6232 where the immediateload loader strategy no longer goes into recursive loops; the modification is that an eager load (joinedload, selectinload, or subqueryload) from A->bs->B which then states immediateload for a simple manytoone B->a->A that’s in the identity map will populate the B->A, so that this attribute is back-populated when the collection of A/A.bs are loaded. This allows the objects to be functional when detached.

[orm] [bug] ¶

Fixed bug in new with_loader_criteria() feature where using a mixin class with declared_attr() on an attribute that were accessed inside the custom lambda would emit a warning regarding using an unmapped declared attr, when the lambda callable were first initialized. This warning is now prevented using special instrumentation for this lambda initialization step.

References: #6320

[orm] [bug] [regression] ¶

Fixed additional regression caused by the «eagerloaders on refresh» feature added in #1763 where the refresh operation historically would set populate_existing, which given the new feature now overwrites pending changes on eagerly loaded objects when autoflush is false. The populate_existing flag has been turned off for this case and a more specific method used to ensure the correct attributes refreshed.

References: #6326

[orm] [bug] [result] ¶

Fixed an issue when using 2.0 style execution that prevented using Result.scalar_one() or Result.scalar_one_or_none() after calling Result.unique(), for the case where the ORM is returning a single-element row in any case.

References: #6299

[sql] [bug] ¶

Fixed issue in SQL compiler where the bound parameters set up for a Values construct wouldn’t be positionally tracked correctly if inside of a CTE, affecting database drivers that support VALUES + ctes and use positional parameters such as SQL Server in particular as well as asyncpg. The fix also repairs support for compiler flags such as literal_binds.

References: #6327

[sql] [bug] ¶

Repaired and solidified issues regarding custom functions and other arbitrary expression constructs which within SQLAlchemy’s column labeling mechanics would seek to use str(obj) to get a string representation to use as an anonymous column name in the .c collection of a subquery. This is a very legacy behavior that performs poorly and leads to lots of issues, so has been revised to no longer perform any compilation by establishing specific methods on FunctionElement to handle this case, as SQL functions are the only use case that it came into play. An effect of this behavior is that an unlabeled column expression with no derivable name will be given an arbitrary label starting with the prefix "_no_label" in the .c collection of a subquery; these were previously being represented either as the generic stringification of that expression, or as an internal symbol.

References: #6256

[schema] [bug] ¶

Fixed issue where next_value() was not deriving its type from the corresponding Sequence, instead hardcoded to Integer. The specific numeric type is now used.

References: #6287

[mypy] [bug] ¶

Fixed issue where mypy plugin would not correctly interpret an explicit Mapped annotation in conjunction with a relationship() that refers to a class by string name; the correct annotation would be downgraded to a less specific one leading to typing errors.

References: #6255

[mssql] [usecase] ¶

The DateTime.timezone parameter when set to True will now make use of the DATETIMEOFFSET column type with SQL Server when used to emit DDL, rather than DATETIME where the flag was silently ignored.

References: #6306

[bug] [declarative] [regression] ¶

Fixed instrument_declarative() that called a non existing registry method.

References: #6291

[orm] [usecase] ¶

Established support for synoynm() in conjunction with hybrid property, assocaitionproxy is set up completely, including that synonyms can be established linking to these constructs which work fully. This is a behavior that was semi-explicitly disallowed previously, however since it did not fail in every scenario, explicit support for assoc proxy and hybrids has been added.

References: #6267

[orm] [performance] [bug] [regression] [sql] ¶

Fixed a critical performance issue where the traversal of a select() construct would traverse a repetitive product of the represented FROM clauses as they were each referred towards by columns in the columns clause; for a series of nested subqueries with lots of columns this could cause a large delay and significant memory growth. This traversal is used by a wide variety of SQL and ORM functions, including by the ORM Session when it’s configured to have «table-per-bind», which while this is not a common use case, it seems to be what Flask-SQLAlchemy is hardcoded as using, so the issue impacts Flask-SQLAlchemy users. The traversal has been repaired to uniqify on FROM clauses which was effectively what would happen implicitly with the pre-1.4 architecture.

References: #6304

[orm] [bug] [regression] ¶

Fixed regression where an attribute that is mapped to a synonym() could not be used in column loader options such as load_only().

References: #6272

[sql] [bug] [regression] ¶

Fixed regression where an empty in statement on a tuple would result in an error when compiled with the option literal_binds=True.

References: #6290

[postgresql] [bug] [regression] [sql] ¶

Fixed an argument error in the default and PostgreSQL compilers that would interfere with an UPDATE..FROM or DELETE..FROM..USING statement that was then SELECTed from as a CTE.

References: #6303

[orm] [bug] [regression] ¶

Fixed a cache leak involving the with_expression() loader option, where the given SQL expression would not be correctly considered as part of the cache key.

Additionally, fixed regression involving the corresponding query_expression() feature. While the bug technically exists in 1.3 as well, it was not exposed until 1.4. The «default expr» value of null() would be rendered when not needed, and additionally was also not adapted correctly when the ORM rewrites statements such as when using joined eager loading. The fix ensures «singleton» expressions like NULL and true aren’t «adapted» to refer to columns in ORM statements, and additionally ensures that a query_expression() with no default expression doesn’t render in the statement if a with_expression() isn’t used.

References: #6259

[orm] [bug] ¶

Fixed issue in the new feature of Session.refresh() introduced by #1763 where eagerly loaded relationships are also refreshed, where the lazy="raise" and lazy="raise_on_sql" loader strategies would interfere with the immediateload() loader strategy, thus breaking the feature for relationships that were loaded with selectinload(), subqueryload() as well.

References: #6252

[engine] [bug] ¶

The Dialect.has_table() method now raises an informative exception if a non-Connection is passed to it, as this incorrect behavior seems to be common. This method is not intended for external use outside of a dialect. Please use the Inspector.has_table() method or for cross-compatibility with older SQLAlchemy versions, the Engine.has_table() method.

[sql] [feature] ¶

The tuple returned by CursorResult.inserted_primary_key is now a Row object with a named tuple interface on top of the existing tuple interface.

References: #3314

[sql] [bug] [regression] ¶

Fixed regression where the BindParameter object would not properly render for an IN expression (i.e. using the «post compile» feature in 1.4) if the object were copied from either an internal cloning operation, or from a pickle operation, and the parameter name contained spaces or other special characters.

References: #6249

[sql] [bug] [regression] [sqlite] ¶

Fixed regression where the introduction of the INSERT syntax «INSERT… VALUES (DEFAULT)» was not supported on some backends that do however support «INSERT..DEFAULT VALUES», including SQLite. The two syntaxes are now each individually supported or non-supported for each dialect, for example MySQL supports «VALUES (DEFAULT)» but not «DEFAULT VALUES». Support for Oracle has also been enabled.

References: #6254

[mypy] [change] ¶

Updated Mypy plugin to only use the public plugin interface of the semantic analyzer.

[mypy] [bug] ¶

Revised the fix for OrderingList from version 1.4.7 which was testing against the incorrect API.

References: #6205

[asyncio] [bug] ¶

Fix typo that prevented setting the bind attribute of an AsyncSession to the correct value.

References: #6220

[mssql] [bug] [regression] ¶

Fixed an additional regression in the same area as that of #6173, #6184, where using a value of 0 for OFFSET in conjunction with LIMIT with SQL Server would create a statement using «TOP», as was the behavior in 1.3, however due to caching would then fail to respond accordingly to other values of OFFSET. If the «0» wasn’t first, then it would be fine. For the fix, the «TOP» syntax is now only emitted if the OFFSET value is omitted entirely, that is, Select.offset() is not used. Note that this change now requires that if the «with_ties» or «percent» modifiers are used, the statement can’t specify an OFFSET of zero, it now needs to be omitted entirely.

References: #6265

[orm] [bug] [regression] ¶

Fixed regression where the subqueryload() loader strategy would fail to correctly accommodate sub-options, such as a defer() option on a column, if the «path» of the subqueryload were more than one level deep.

References: #6221

[orm] [bug] [regression] ¶

Fixed regression where the merge_frozen_result() function relied upon by the dogpile.caching example was not included in tests and began failing due to incorrect internal arguments.

References: #6211

[orm] [bug] [regression] ¶

Fixed critical regression where the Session could fail to «autobegin» a new transaction when a flush occurred without an existing transaction in place, implicitly placing the Session into legacy autocommit mode which commit the transaction. The Session now has a check that will prevent this condition from occurring, in addition to repairing the flush issue.

Additionally, scaled back part of the change made as part of #5226 which can run autoflush during an unexpire operation, to not actually do this in the case of a Session using legacy Session.autocommit mode, as this incurs a commit within a refresh operation.

References: #6233

[orm] [bug] [regression] ¶

Fixed regression where the ORM compilation scheme would assume the function name of a hybrid property would be the same as the attribute name in such a way that an AttributeError would be raised, when it would attempt to determine the correct name for each element in a result tuple. A similar issue exists in 1.3 but only impacts the names of tuple rows. The fix here adds a check that the hybrid’s function name is actually present in the __dict__ of the class or its superclasses before assigning this name; otherwise, the hybrid is considered to be «unnamed» and ORM result tuples will use the naming scheme of the underlying expression.

References: #6215

[orm] [bug] [regression] ¶

Fixed critical regression caused by the new feature added as part of #1763, eager loaders are invoked on unexpire operations. The new feature makes use of the «immediateload» eager loader strategy as a substitute for a collection loading strategy, which unlike the other «post-load» strategies was not accommodating for recursive invocations between mutually-dependent relationships, leading to recursion overflow errors.

References: #6232

[engine] [bug] [regression] ¶

Fixed up the behavior of the Row object when dictionary access is used upon it, meaning converting to a dict via dict(row) or accessing members using strings or other objects i.e. row["some_key"] works as it would with a dictionary, rather than raising TypeError as would be the case with a tuple, whether or not the C extensions are in place. This was originally supposed to emit a 2.0 deprecation warning for the «non-future» case using LegacyRow, and was to raise TypeError for the «future» Row class. However, the C version of Row was failing to raise this TypeError, and to complicate matters, the Session.execute() method now returns Row in all cases to maintain consistency with the ORM result case, so users who didn’t have C extensions installed would see different behavior in this one case for existing pre-1.4 style code.

Therefore, in order to soften the overall upgrade scheme as most users have not been exposed to the more strict behavior of Row up through 1.4.6, LegacyRow and Row both provide for string-key access as well as support for dict(row), in all cases emitting the 2.0 deprecation warning when SQLALCHEMY_WARN_20 is enabled. The Row object still uses tuple-like behavior for __contains__, which is probably the only noticeable behavioral change compared to LegacyRow, other than the removal of dictionary-style methods values() and items().

References: #6218

[sql] [bug] [regression] ¶

Enhanced the «expanding» feature used for ColumnOperators.in_() operations to infer the type of expression from the right hand list of elements, if the left hand side does not have any explicit type set up. This allows the expression to support stringification among other things. In 1.3, «expanding» was not automatically used for ColumnOperators.in_() expressions, so in that sense this change fixes a behavioral regression.

References: #6222

[sql] [bug] ¶

Fixed the «stringify» compiler to support a basic stringification of a «multirow» INSERT statement, i.e. one with multiple tuples following the VALUES keyword.

[schema] [bug] [regression] ¶

Fixed regression where usage of a token in the Connection.execution_options.schema_translate_map dictionary which contained special characters such as braces would fail to be substituted properly. Use of square bracket characters [] is now explicitly disallowed as these are used as a delimiter character in the current implementation.

References: #6216

[mypy] [bug] ¶

Fixed issue in Mypy plugin where the plugin wasn’t inferring the correct type for columns of subclasses that don’t directly descend from TypeEngine, in particular that of TypeDecorator and UserDefinedType.

[tests] [change] ¶

Added a new flag to DefaultDialect called supports_schemas; third party dialects may set this flag to False to disable SQLAlchemy’s schema-level tests when running the test suite for a third party dialect.

[orm] [bug] [regression] ¶

Fixed regression where a deprecated form of Query.join() were used, passing a series of entities to join from without any ON clause in a single Query.join() call, would fail to function correctly.

References: #6203

[orm] [bug] [regression] ¶

Fixed critical regression where the Query.yield_per() method in the ORM would set up the internal Result to yield chunks at a time, however made use of the new Result.unique() method which uniques across the entire result. This would lead to lost rows since the ORM is using id(obj) as the uniquing function, which leads to repeated identifiers for new objects as already-seen objects are garbage collected. 1.3’s behavior here was to «unique» across each chunk, which does not actually produce «uniqued» results when results are yielded in chunks. As the Query.yield_per() method is already explicitly disallowed when joined eager loading is in place, which is the primary rationale for the «uniquing» feature, the «uniquing» feature is now turned off entirely when Query.yield_per() is used.

This regression only applies to the legacy Query object; when using 2.0 style execution, «uniquing» is not automatically applied. To prevent the issue from arising from explicit use of Result.unique(), an error is now raised if rows are fetched from a «uniqued» ORM-level Result if any yield per API is also in use, as the purpose of yield_per is to allow for arbitrarily large numbers of rows, which cannot be uniqued in memory without growing the number of entries to fit the complete result size.

References: #6206

[sql] [bug] [mssql] [oracle] [regression] ¶

Fixed further regressions in the same area as that of #6173 released in 1.4.5, where a «postcompile» parameter, again most typically those used for LIMIT/OFFSET rendering in Oracle and SQL Server, would fail to be processed correctly if the same parameter rendered in multiple places in the statement.

References: #6202

[sql] [bug] ¶

Executing a Subquery using Connection.execute() is deprecated and will emit a deprecation warning; this use case was an oversight that should have been removed from 1.4. The operation will now execute the underlying Select object directly for backwards compatibility. Similarly, the CTE class is also not appropriate for execution. In 1.3, attempting to execute a CTE would result in an invalid «blank» SQL statement being executed; since this use case was not working it now raises ObjectNotExecutableError. Previously, 1.4 was attempting to execute the CTE as a statement however it was working only erratically.

References: #6204

[schema] [bug] ¶

The Table object now raises an informative error message if it is instantiated without passing at least the Table.name and Table.metadata arguments positionally. Previously, if these were passed as keyword arguments, the object would silently fail to initialize correctly.

This change is also backported to: 1.3.25

References: #6135

[mypy] [bug] ¶

Applied a series of refactorings and fixes to accommodate for Mypy «incremental» mode across multiple files, which previously was not taken into account. In this mode the Mypy plugin has to accommodate Python datatypes expressed in other files coming in with less information than they have on a direct run.

Additionally, a new decorator declarative_mixin() is added, which is necessary for the Mypy plugin to be able to definifitely identify a Declarative mixin class that is otherwise not used inside a particular Python file.

References: #6147

[mypy] [bug] ¶

Fixed issue where the Mypy plugin would fail to interpret the «collection_class» of a relationship if it were a callable and not a class. Also improved type matching and error reporting for collection-oriented relationships.

References: #6205

[asyncio] [usecase] [postgresql] ¶

Added accessors .sqlstate and synonym .pgcode to the .orig attribute of the SQLAlchemy exception class raised by the asyncpg DBAPI adapter, that is, the intermediary exception object that wraps on top of that raised by the asyncpg library itself, but below the level of the SQLAlchemy dialect.

References: #6199

[orm] [bug] [regression] ¶

Fixed regression where the joinedload() loader strategy would not successfully joinedload to a mapper that is mapper against a CTE construct.

References: #6172

[orm] [bug] [regression] ¶

Scaled back the warning message added in #5171 to not warn for overlapping columns in an inheritance scenario where a particular relationship is local to a subclass and therefore does not represent an overlap.

References: #6171

[sql] [bug] [postgresql] ¶

Fixed bug in new FunctionElement.render_derived() feature where column names rendered out explicitly in the alias SQL would not have proper quoting applied for case sensitive names and other non-alphanumeric names.

References: #6183

[sql] [bug] [regression] ¶

Fixed regression where use of the Operators.in_() method with a Select object against a non-table-bound column would produce an AttributeError, or more generally using a ScalarSelect that has no datatype in a binary expression would produce invalid state.

References: #6181

[sql] [bug] ¶

Added a new flag to the Dialect class called Dialect.supports_statement_cache. This flag now needs to be present directly on a dialect class in order for SQLAlchemy’s query cache to take effect for that dialect. The rationale is based on discovered issues such as #6173 revealing that dialects which hardcode literal values from the compiled statement, often the numerical parameters used for LIMIT / OFFSET, will not be compatible with caching until these dialects are revised to use the parameters present in the statement only. For third party dialects where this flag is not applied, the SQL logging will show the message «dialect does not support caching», indicating the dialect should seek to apply this flag once they have verified that no per-statement literal values are being rendered within the compilation phase.

References: #6184

[schema] [bug] ¶

Introduce a new parameter Enum.omit_aliases in Enum type allow filtering aliases when using a pep435 Enum. Previous versions of SQLAlchemy kept aliases in all cases, creating database enum type with additional states, meaning that they were treated as different values in the db. For backward compatibility this flag defaults to False in the 1.4 series, but will be switched to True in a future version. A deprecation warning is raise if this flag is not specified and the passed enum contains aliases.

References: #6146

[mypy] [bug] ¶

Fixed issue in mypy plugin where newly added support for as_declarative() needed to more fully add the DeclarativeMeta class to the mypy interpreter’s state so that it does not result in a name not found error; additionally improves how global names are setup for the plugin including the Mapped name.

References: #sqlalchemy/sqlalchemy2-stubs/#14

[asyncio] [bug] ¶

Fixed issue where the asyncio extension could not be loaded if running Python 3.6 with the backport library of contextvars installed.

References: #6166

[postgresql] [bug] [regression] ¶

Fixed regression caused by #6023 where the PostgreSQL cast operator applied to elements within an ARRAY when using psycopg2 would fail to use the correct type in the case that the datatype were also embedded within an instance of the Variant adapter.

Additionally, repairs support for the correct CREATE TYPE to be emitted when using a Variant(ARRAY(some_schema_type)).

This change is also backported to: 1.3.25

References: #6182

[postgresql] [bug] ¶

Fixed typo in the fix for #6099 released in 1.4.4 that completely prevented this change from working correctly, i.e. the error message did not match what was actually emitted by pg8000.

References: #6099

[postgresql] [bug] ¶

Fixed issue where the PostgreSQL PGInspector, when generated against an Engine, would fail for .get_enums(), .get_view_names(), .get_foreign_table_names() and .get_table_oid() when used against a «future» style engine and not the connection directly.

References: #6170

[mysql] [bug] [regression] ¶

Fixed regression in the MySQL dialect where the reflection query used to detect if a table exists would fail on very old MySQL 5.0 and 5.1 versions.

References: #6163

[mssql] [bug] ¶

Fixed a regression in MSSQL 2012+ that prevented the order by clause to be rendered when offset=0 is used in a subquery.

References: #6163

[oracle] [bug] [regression] ¶

Fixed critical regression where the Oracle compiler would not maintain the correct parameter values in the LIMIT/OFFSET for a select due to a caching issue.

References: #6173

[orm] [bug] ¶

Fixed critical issue in the new PropComparator.and_() feature where loader strategies that emit secondary SELECT statements such as selectinload() and lazyload() would fail to accommodate for bound parameters in the user-defined criteria in terms of the current statement being executed, as opposed to the cached statement, causing stale bound values to be used.

This also adds a warning for the case where an object that uses lazyload() in conjunction with PropComparator.and_() is attempted to be serialized; the loader criteria cannot reliably be serialized and deserialized and eager loading should be used for this case.

References: #6139

[orm] [bug] [regression] ¶

Fixed missing method Session.get() from the ScopedSession interface.

References: #6144

[engine] [usecase] ¶

Modified the context manager used by Transaction so that an «already detached» warning is not emitted by the ending of the context manager itself, if the transaction were already manually rolled back inside the block. This applies to regular transactions, savepoint transactions, and legacy «marker» transactions. A warning is still emitted if the .rollback() method is called explicitly more than once.

References: #6155

[engine] [bug] ¶

Repair wrong arguments to exception handling method in CursorResult.

References: #6138

[postgresql] [bug] [reflection] ¶

Fixed issue in PostgreSQL reflection where a column expressing «NOT NULL» will supersede the nullability of a corresponding domain.

This change is also backported to: 1.3.24

References: #6161

[postgresql] [bug] ¶

Modified the is_disconnect() handler for the pg8000 dialect, which now accommodates for a new InterfaceError emitted by pg8000 1.19.0. Pull request courtesy Hamdi Burak Usul.

References: #6099

[misc] [bug] ¶

Adjusted the usage of the importlib_metadata library for loading setuptools entrypoints in order to accommodate for some deprecation changes.

[orm] [bug] ¶

Fixed a bug where python 2.7.5 (default on CentOS 7) wasn’t able to import sqlalchemy, because on this version of Python exec "statement" and exec("statement") do not behave the same way. The compatibility exec_() function was used instead.

References: #6069

[orm] [bug] ¶

Fixed bug where ORM queries using a correlated subquery in conjunction with column_property() would fail to correlate correctly to an enclosing subquery or to a CTE when Select.correlate_except() were used in the property to control correlation, in cases where the subquery contained the same selectables as ones within the correlated subquery that were intended to not be correlated.

References: #6060

[orm] [bug] ¶

Fixed bug where combinations of the new «relationship with criteria» feature could fail in conjunction with features that make use of the new «lambda SQL» feature, including loader strategies such as selectinload and lazyload, for more complicated scenarios such as polymorphic loading.

References: #6131

[orm] [bug] ¶

Repaired support so that the ClauseElement.params() method can work correctly with a Select object that includes joins across ORM relationship structures, which is a new feature in 1.4.

References: #6124

[orm] [bug] ¶

Fixed issue where a «removed in 2.0» warning were generated internally by the relationship loader mechanics.

References: #6115

[orm] [declarative] [bug] [regression] ¶

Fixed regression where the .metadata attribute on a per class level would not be honored, breaking the use case of per-class-hierarchy MetaData for abstract declarative classes and mixins.

References: #6128

[engine] [bug] [regression] ¶

Restored the ResultProxy name back to the sqlalchemy.engine namespace. This name refers to the LegacyCursorResult object.

References: #6119

[schema] [bug] ¶

Adjusted the logic that emits DROP statements for Sequence objects among the dropping of multiple tables, such that all Sequence objects are dropped after all tables, even if the given Sequence is related only to a Table object and not directly to the overall MetaData object. The use case supports the same Sequence being associated with more than one Table at a time.

This change is also backported to: 1.3.24

References: #6071

[mypy] [bug] ¶

Added support for the Mypy extension to correctly interpret a declarative base class that’s generated using the as_declarative() function as well as the registry.as_declarative_base() method.

[mypy] [bug] ¶

Fixed bug in Mypy plugin where the Python type detection for the Boolean column type would produce an exception; additionally implemented support for Enum, including detection of a string-based enum vs. use of Python enum.Enum.

References: #6109

[postgresql] [bug] [types] ¶

Adjusted the psycopg2 dialect to emit an explicit PostgreSQL-style cast for bound parameters that contain ARRAY elements. This allows the full range of datatypes to function correctly within arrays. The asyncpg dialect already generated these internal casts in the final statement. This also includes support for array slice updates as well as the PostgreSQL-specific ARRAY.contains() method.

This change is also backported to: 1.3.24

References: #6023

[postgresql] [bug] [reflection] ¶

Fixed reflection of identity columns in tables with mixed case names in PostgreSQL.

References: #6129

[sqlite] [feature] [asyncio] ¶

Added support for the aiosqlite database driver for use with the SQLAlchemy asyncio extension.

References: #5920

[sqlite] [bug] [regression] ¶

Repaired the pysqlcipher dialect to connect correctly which had regressed in 1.4, and added test + CI support to maintain the driver in working condition. The dialect now imports the sqlcipher3 module for Python 3 by default before falling back to pysqlcipher3 which is documented as now being unmaintained.

References: #5848

[orm] [usecase] [dataclasses] ¶

Added support for the declared_attr object to work in the context of dataclass fields.

References: #6100

[orm] [bug] [dataclasses] ¶

Fixed issue in new ORM dataclasses functionality where dataclass fields on an abstract base or mixin that contained column or other mapping constructs would not be mapped if they also included a «default» key within the dataclasses.field() object.

References: #6093

[orm] [bug] [regression] ¶

Fixed regression where the Query.selectable accessor, which is a synonym for Query.__clause_element__(), got removed, it’s now restored.

References: #6088

[orm] [bug] [regression] ¶

Fixed regression where use of an unnamed SQL expression such as a SQL function would raise a column targeting error if the query itself were using joinedload for an entity and was also being wrapped in a subquery by the joinedload eager loading process.

References: #6086

[orm] [bug] [regression] ¶

Fixed regression where the Query.filter_by() method would fail to locate the correct source entity if the Query.join() method had been used targeting an entity without any kind of ON clause.

References: #6092

[orm] [bug] [regression] ¶

Fixed regression where the SQL compilation of a Function would not work correctly if the object had been «annotated», which is an internal memoization process used mostly by the ORM. In particular it could affect ORM lazy loads which make greater use of this feature in 1.4.

References: #6095

[orm] [bug] ¶

Fixed regression where the ConcreteBase would fail to map at all when a mapped column name overlapped with the discriminator column name, producing an assertion error. The use case here did not function correctly in 1.3 as the polymorphic union would produce a query that ignored the discriminator column entirely, while emitting duplicate column warnings. As 1.4’s architecture cannot easily reproduce this essentially broken behavior of 1.3 at the select() level right now, the use case now raises an informative error message instructing the user to use the .ConcreteBase._concrete_discriminator_name attribute to resolve the conflict. To assist with this configuration, .ConcreteBase._concrete_discriminator_name may be placed on the base class only where it will be automatically used by subclasses; previously this was not the case.

References: #6090

[engine] [bug] [regression] ¶

Restored top level import for sqlalchemy.engine.reflection. This ensures that the base Inspector class is properly registered so that inspect() works for third party dialects that don’t otherwise import this package.

[sql] [bug] [regression] ¶

Fixed issue where using a func that includes dotted packagenames would fail to be cacheable by the SQL caching system due to a Python list of names that needed to be a tuple.

References: #6101

[sql] [bug] [regression] ¶

Fixed regression in the case() construct, where the «dictionary» form of argument specification failed to work correctly if it were passed positionally, rather than as a «whens» keyword argument.

References: #6097

[mypy] [bug] ¶

Fixed issue in MyPy extension which crashed on detecting the type of a Column if the type were given with a module prefix like sa.Integer().

References: #sqlalchemy/sqlalchemy2-stubs/2

[postgresql] [usecase] ¶

Rename the column name used by a reflection query that used a reserved word in some postgresql compatible databases.

References: #6982

[orm] [bug] [regression] ¶

Fixed regression where producing a Core expression construct such as select() using ORM entities would eagerly configure the mappers, in an effort to maintain compatibility with the Query object which necessarily does this to support many backref-related legacy cases. However, core select() constructs are also used in mapper configurations and such, and to that degree this eager configuration is more of an inconvenience, so eager configure has been disabled for the select() and other Core constructs in the absence of ORM loading types of functions such as Load.

The change maintains the behavior of Query so that backwards compatibility is maintained. However, when using a select() in conjunction with ORM entities, a «backref» that isn’t explicitly placed on one of the classes until mapper configure time won’t be available unless configure_mappers() or the newer configure() has been called elsewhere. Prefer using relationship.back_populates for more explicit relationship configuration which does not have the eager configure requirement.

References: #6066

[orm] [bug] [regression] ¶

Fixed a critical regression in the relationship lazy loader where the SQL criteria used to fetch a related many-to-one object could go stale in relation to other memoized structures within the loader if the mapper had configuration changes, such as can occur when mappers are late configured or configured on demand, producing a comparison to None and returning no object. Huge thanks to Alan Hamlett for their help tracking this down late into the night.

References: #6055

[orm] [bug] [regression] ¶

Fixed regression where the Query.exists() method would fail to create an expression if the entity list of the Query were an arbitrary SQL column expression.

References: #6076

[orm] [bug] [regression] ¶

Fixed regression where calling upon Query.count() in conjunction with a loader option such as joinedload() would fail to ignore the loader option. This is a behavior that has always been very specific to the Query.count() method; an error is normally raised if a given Query has options that don’t apply to what it is returning.

References: #6052

[orm] [bug] [regression] ¶

Fixed regression in Session.identity_key(), including that the method and related methods were not covered by any unit test as well as that the method contained a typo preventing it from functioning correctly.

References: #6067

[orm] [declarative] [bug] [regression] ¶

Fixed bug where user-mapped classes that contained an attribute named «registry» would cause conflicts with the new registry-based mapping system when using DeclarativeMeta. While the attribute remains something that can be set explicitly on a declarative base to be consumed by the metaclass, once located it is placed under a private class variable so it does not conflict with future subclasses that use the same name for other purposes.

References: #6054

[engine] [bug] [regression] ¶

The Python namedtuple() has the behavior such that the names count and index will be served as tuple values if the named tuple includes those names; if they are absent, then their behavior as methods of collections.abc.Sequence is maintained. Therefore the Row and LegacyRow classes have been fixed so that they work in this same way, maintaining the expected behavior for database rows that have columns named «index» or «count».

References: #6074

[mssql] [bug] [regression] ¶

Fixed regression where a new setinputsizes() API that’s available for pyodbc was enabled, which is apparently incompatible with pyodbc’s fast_executemany() mode in the absence of more accurate typing information, which as of yet is not fully implemented or tested. The pyodbc dialect and connector has been modified so that setinputsizes() is not used at all unless the parameter use_setinputsizes is passed to the dialect, e.g. via create_engine(), at which point its behavior can be customized using the DialectEvents.do_setinputsizes() hook.

References: #6058

[bug] [regression] ¶

Added back items and values to ColumnCollection class. The regression was introduced while adding support for duplicate columns in from clauses and selectable in ticket #4753.

References: #6068

[orm] [bug] ¶

Removed very old warning that states that passive_deletes is not intended for many-to-one relationships. While it is likely that in many cases placing this parameter on a many-to-one relationship is not what was intended, there are use cases where delete cascade may want to be disallowed following from such a relationship.

This change is also backported to: 1.3.24

References: #5983

[orm] [bug] ¶

Fixed issue where the process of joining two tables could fail if one of the tables had an unrelated, unresolvable foreign key constraint which would raise NoReferenceError within the join process, which nonetheless could be bypassed to allow the join to complete. The logic which tested the exception for significance within the process would make assumptions about the construct which would fail.

This change is also backported to: 1.3.24

References: #5952

[orm] [bug] ¶

Fixed issue where the MutableComposite construct could be placed into an invalid state when the parent object was already loaded, and then covered by a subsequent query, due to the composite properties“ refresh handler replacing the object with a new one not handled by the mutable extension.

This change is also backported to: 1.3.24

References: #6001

[orm] [bug] ¶

Fixed regression where the relationship.query_class parameter stopped being functional for «dynamic» relationships. The AppenderQuery remains dependent on the legacy Query class; users are encouraged to migrate from the use of «dynamic» relationships to using with_parent() instead.

References: #5981

[orm] [bug] [regression] ¶

Fixed regression where Query.join() would produce no effect if the query itself as well as the join target were against a Table object, rather than a mapped class. This was part of a more systemic issue where the legacy ORM query compiler would not be correctly used from a Query if the statement produced had not ORM entities present within it.

References: #6003

[orm] [bug] [asyncio] ¶

The API for AsyncSession.delete() is now an awaitable; this method cascades along relationships which must be loaded in a similar manner as the AsyncSession.merge() method.

References: #5998

[orm] [bug] ¶

The unit of work process now turns off all «lazy=“raise“» behavior altogether when a flush is proceeding. While there are areas where the UOW is sometimes loading things that aren’t ultimately needed, the lazy=»raise» strategy is not helpful here as the user often does not have much control or visibility into the flush process.

References: #5984

[engine] [bug] ¶

Fixed bug where the «schema_translate_map» feature failed to be taken into account for the use case of direct execution of DefaultGenerator objects such as sequences, which included the case where they were «pre-executed» in order to generate primary key values when implicit_returning was disabled.

This change is also backported to: 1.3.24

References: #5929

[engine] [bug] ¶

Improved engine logging to note ROLLBACK and COMMIT which is logged while the DBAPI driver is in AUTOCOMMIT mode. These ROLLBACK/COMMIT are library level and do not have any effect when AUTOCOMMIT is in effect, however it’s still worthwhile to log as these indicate where SQLAlchemy sees the «transaction» demarcation.

References: #6002

[engine] [bug] [regression] ¶

Fixed a regression where the «reset agent» of the connection pool wasn’t really being utilized by the Connection when it were closed, and also leading to a double-rollback scenario that was somewhat wasteful. The newer architecture of the engine has been updated so that the connection pool «reset-on-return» logic will be skipped when the Connection explicitly closes out the transaction before returning the pool to the connection.

References: #6004

[sql] [change] ¶

Altered the compilation for the CTE construct so that a string is returned representing the inner SELECT statement if the CTE is stringified directly, outside of the context of an enclosing SELECT; This is the same behavior of FromClause.alias() and Select.subquery(). Previously, a blank string would be returned as the CTE is normally placed above a SELECT after that SELECT has been generated, which is generally misleading when debugging.

[sql] [bug] ¶

Fixed bug where the «percent escaping» feature that occurs with dialects that use the «format» or «pyformat» bound parameter styles was not enabled for the Operators.op() and custom_op constructs, for custom operators that use percent signs. The percent sign will now be automatically doubled based on the paramstyle as necessary.

References: #6016

[sql] [bug] [regression] ¶

Fixed regression where the «unsupported compilation error» for unknown datatypes would fail to raise correctly.

References: #5979

[sql] [bug] [regression] ¶

Fixed regression where usage of the standalone distinct() used in the form of being directly SELECTed would fail to be locatable in the result set by column identity, which is how the ORM locates columns. While standalone distinct() is not oriented towards being directly SELECTed (use select.distinct() for a regular SELECT DISTINCT..) , it was usable to a limited extent in this way previously (but wouldn’t work in subqueries, for example). The column targeting for unary expressions such as «DISTINCT <col>» has been improved so that this case works again, and an additional improvement has been made so that usage of this form in a subquery at least generates valid SQL which was not the case previously.

The change additionally enhances the ability to target elements in row._mapping based on SQL expression objects in ORM-enabled SELECT statements, including whether the statement was invoked by connection.execute() or session.execute().

References: #6008

[schema] [bug] [sqlite] ¶

Fixed issue where the CHECK constraint generated by Boolean or Enum would fail to render the naming convention correctly after the first compilation, due to an unintended change of state within the name given to the constraint. This issue was first introduced in 0.9 in the fix for issue #3067, and the fix revises the approach taken at that time which appears to have been more involved than what was needed.

This change is also backported to: 1.3.24

References: #6007

[schema] [bug] ¶

Repaired / implemented support for primary key constraint naming conventions that use column names/keys/etc as part of the convention. In particular, this includes that the PrimaryKeyConstraint object that’s automatically associated with a Table will update its name as new primary key Column objects are added to the table and then to the constraint. Internal failure modes related to this constraint construction process including no columns present, no name present or blank name present are now accommodated.

This change is also backported to: 1.3.24

References: #5919

[schema] [bug] ¶

Deprecated all schema-level .copy() methods and renamed to _copy(). These are not standard Python «copy()» methods as they typically rely upon being instantiated within particular contexts which are passed to the method as optional keyword arguments. The Table.tometadata() method is the public API that provides copying for Table objects.

References: #5953

[mypy] [feature] ¶

Rudimentary and experimental support for Mypy has been added in the form of a new plugin, which itself depends on new typing stubs for SQLAlchemy. The plugin allows declarative mappings in their standard form to both be compatible with Mypy as well as to provide typing support for mapped classes and instances.

References: #4609

[postgresql] [usecase] [asyncio] [mysql] ¶

Added an asyncio.Lock() within SQLAlchemy’s emulated DBAPI cursor, local to the connection, for the asyncpg and aiomysql dialects for the scope of the cursor.execute() and cursor.executemany() methods. The rationale is to prevent failures and corruption for the case where the connection is used in multiple awaitables at once.

While this use case can also occur with threaded code and non-asyncio dialects, we anticipate this kind of use will be more common under asyncio, as the asyncio API is encouraging of such use. It’s definitely better to use a distinct connection per concurrent awaitable however as concurrency will not be achieved otherwise.

For the asyncpg dialect, this is so that the space between the call to prepare() and fetch() is prevented from allowing concurrent executions on the connection from causing interface error exceptions, as well as preventing race conditions when starting a new transaction. Other PostgreSQL DBAPIs are threadsafe at the connection level so this intends to provide a similar behavior, outside the realm of server side cursors.

For the aiomysql dialect, the mutex will provide safety such that the statement execution and the result set fetch, which are two distinct steps at the connection level, won’t get corrupted by concurrent executions on the same connection.

References: #5967

[postgresql] [bug] ¶

Fixed issue where using aggregate_order_by would return ARRAY(NullType) under certain conditions, interfering with the ability of the result object to return data correctly.

This change is also backported to: 1.3.24

References: #5989

[mssql] [bug] ¶

Fix a reflection error for MSSQL 2005 introduced by the reflection of filtered indexes.

References: #5919

[usecase] [ext] ¶

Add new parameter AutomapBase.prepare.reflection_options to allow passing of MetaData.reflect() options like only or dialect-specific reflection options like oracle_resolve_synonyms.

References: #5942

[bug] [ext] ¶

The sqlalchemy.ext.mutable extension now tracks the «parents» collection using the InstanceState associated with objects, rather than the object itself. The latter approach required that the object be hashable so that it can be inside of a WeakKeyDictionary, which goes against the behavioral contract of the ORM overall which is that ORM mapped objects do not need to provide any particular kind of __hash__() method and that unhashable objects are supported.

References: #6020

[orm] [feature] ¶

The ORM used in 2.0 style can now return ORM objects from the rows returned by an UPDATE..RETURNING or INSERT..RETURNING statement, by supplying the construct to Select.from_statement() in an ORM context.

[orm] [bug] ¶

Fixed issue in new 1.4/2.0 style ORM queries where a statement-level label style would not be preserved in the keys used by result rows; this has been applied to all combinations of Core/ORM columns / session vs. connection etc. so that the linkage from statement to result row is the same in all cases. As part of this change, the labeling of column expressions in rows has been improved to retain the original name of the ORM attribute even if used in a subquery.

References: #5933

[engine] [bug] [postgresql] ¶

Continued with the improvement made as part of #5653 to further support bound parameter names, including those generated against column names, for names that include colons, parenthesis, and question marks, as well as improved test support, so that bound parameter names even if they are auto-derived from column names should have no problem including for parenthesis in psycopg2’s «pyformat» style.

As part of this change, the format used by the asyncpg DBAPI adapter (which is local to SQLAlchemy’s asyncpg dialect) has been changed from using «qmark» paramstyle to «format», as there is a standard and internally supported SQL string escaping style for names that use percent signs with «format» style (i.e. to double percent signs), as opposed to names that use question marks with «qmark» style (where an escaping system is not defined by pep-249 or Python).