1.4 Changelog¶

[orm] [bug] ¶

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

References: #9728

[orm] [bug] ¶

Исправлена ошибка, при которой различные ORM-специфичные геттеры, такие как ORMExecuteState.is_column_load, ORMExecuteState.is_relationship_load, ORMExecuteState.loader_strategy_path и т.д., выдавали ошибку AttributeError, если сам SQL-оператор представлял собой «составной select», например, UNION.

References: #9634

[orm] [bug] ¶

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

References: #9590

[sql] [bug] ¶

Исправлена ошибка/регрессия, при которой использование bindparam() с тем же именем, что и столбец, в методе Update.values() в Update, а также в методе Insert.values() в Insert только в версии 2.0 в некоторых случаях приводило к тому, что SQL-выражение, в котором был представлен параметр, не выполнялось, заменяясь новым параметром с тем же именем и отбрасывая все остальные элементы SQL-выражения, такие как SQL-функции и т.д. В данном случае речь идет об операторах, построенных на основе сущностей ORM, а не простых экземпляров Table, но это может произойти и в том случае, если оператор был вызван с помощью Session или Connection.

Update часть проблемы присутствовала как в 2.0, так и в 1.4 и перенесена в 1.4.

References: #9075

[sql] [bug] ¶

Исправлена ошибка stringify для DDL-конструкций CreateSchema и DropSchema, которая при строке без диалекта приводила к ошибке AttributeError.

References: #7664

[sql] [bug] ¶

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

References: #9506

[mypy] [bug] ¶

В плагин mypy внесены коррективы, учитывающие некоторые потенциальные изменения, которые могут быть внесены в проблему #236 sqlalchemy2-stubs при использовании SQLAlchemy 1.4. Эти изменения синхронизируются с SQLAlchemy 2.0. Изменения также обратно совместимы со старыми версиями sqlalchemy2-stubs.

[mypy] [bug] ¶

Исправлен сбой в плагине mypy, который мог произойти как в версии 1.4, так и в версии 2.0, если использовался декоратор для декоратора mapped(), на который ссылалось выражение, содержащее более двух компонентов (например, @Backend.mapper_registry.mapped). Теперь этот сценарий игнорируется; при использовании плагина выражение декоратора должно быть двухкомпонентным (т.е. @reg.mapped).

References: #9102

[postgresql] [bug] ¶

В диалект asyncpg добавлена поддержка возврата значения cursor.rowcount для операторов SELECT, если оно доступно. Хотя это не является типичным использованием cursor.rowcount, другие диалекты PostgreSQL обычно предоставляют это значение. Pull request любезно предоставлен Майклом Горвеном.

References: #9048

[mysql] [usecase] ¶

Добавлена поддержка отражения индексов MySQL для корректного отражения словаря mysql_length, который ранее игнорировался.

References: #9047

[mssql] [bug] ¶

Исправлена ошибка, при которой имя схемы, заданное со скобками, но без точек внутри имени, для таких параметров, как Table.schema, не интерпретировалось в контексте документированного поведения диалекта SQL Server по интерпретации явных скобок как разделителей токенов, впервые добавленного в 1.2 для #2626, при обращении к имени схемы в операциях отражения. Первоначальное предположение для поведения #2626 состояло в том, что специальная интерпретация скобок была значима только при наличии точек, однако на практике скобки не включаются как часть имени идентификатора во всех операциях рендеринга SQL, поскольку они не являются допустимыми символами в обычных или разграниченных идентификаторах. Pull request courtesy Shan.

References: #9133

[oracle] [bug] ¶

В отраженные типы добавлено ROWID, так как этот тип может использоваться в операторе «CREATE TABLE».

References: #5047

[general] [change] ¶

Новое предупреждение об устаревании «uber warning» теперь выдается во время выполнения программы в первый раз, когда обычно выдается любое предупреждение об устаревании SQLAlchemy 2.0, но не установлена переменная окружения SQLALCHEMY_WARN_20. Предупреждение выдается не более одного раза, после чего устанавливается логическое значение, предотвращающее его повторное появление.

Данное предупреждение об устаревании призвано уведомить пользователей, которые, возможно, не установили в файлах требований соответствующее ограничение для защиты от неожиданного обновления SQLAlchemy 2.0, а также предупредить о том, что процесс обновления SQLAlchemy 2.0 доступен, поскольку первый полноценный релиз 2.0 ожидается очень скоро. Предупреждение об устаревании может быть отключено установкой переменной окружения SQLALCHEMY_SILENCE_UBER_WARNING в значение "1".

References: #8983

[general] [bug] ¶

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

References: #8995

[orm] [bug] ¶

Исправлена проблема внутреннего обхода SQL для операторов DML типа Update и Delete, которая приводила, помимо прочих потенциальных проблем, к специфической проблеме использования лямбда-операторов с функцией обновления/удаления ORM.

References: #9033

[engine] [bug] ¶

Исправлено давнее состояние гонки в пуле соединений, которое могло возникать при использовании схем eventlet/gevent monkeypatching в сочетании с условиями eventlet/gevent Timeout, когда проверка пула соединений, прерванная из-за таймаута, не успевала очистить состояние отказа, что приводило к «утечке» базовой записи соединения, а иногда и самого соединения с базой данных, оставляя пул в неработоспособном состоянии с недоступными записями. Впервые эта проблема была выявлена и исправлена в SQLAlchemy 1.2 для #4225, однако режимы отказа, обнаруженные в этом исправлении, не учитывали BaseException, а не Exception, что не позволяло перехватить эвентлет/гевент Timeout. Кроме того, был выявлен и исправлен блок внутри начального соединения с пулом, в котором появился блок BaseException -> «clean failed connect», учитывающий то же самое условие в этом месте. Большое спасибо пользователю Github @niklaus за упорную работу по выявлению и описанию этой сложной проблемы.

References: #8974

[sql] [bug] ¶

Добавлен параметр FunctionElement.column_valued.joins_implicitly, который позволяет предотвратить появление предупреждения о «картезианском произведении» при использовании таблично-значных или столбцово-значных функций. Этот параметр уже был введен для FunctionElement.table_valued() в #7845, однако его не удалось добавить и для FunctionElement.column_valued().

References: #9009

[sql] [bug] ¶

Исправлена ошибка, когда при использовании выражения, тип которого включал TypeEngine.bind_expression(), в контексте «расширяющего» (т.е. «IN») параметра в сочетании с параметром компилятора literal_binds, компиляция SQL заканчивалась неудачей (assertion fail в 2.0, NoneType error в 1.4).

References: #8989

[sql] [bug] ¶

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

References: #9029

[postgresql] [usecase] ¶

Добавлен тип PostgreSQL MACADDR8. Pull request любезно предоставлен Asim Farooq.

References: #8393

[postgresql] [bug] ¶

Исправлена ошибка, при которой параметр PostgreSQL Insert.on_conflict_do_update.constraint принимал объект Index, но не разворачивал этот индекс в отдельные индексные выражения, а вместо этого выводил его имя в предложение ON CONFLICT ON CONSTRAINT, которое не принимается PostgreSQL; форма «constraint name» принимает только уникальные или исключающие имена ограничений. Параметр продолжает принимать индекс, но теперь разлагает его на составные выражения для рендеринга.

References: #9023

[sqlite] [bug] ¶

Исправлена регрессия, вызванная добавленной в 1.4.45 поддержкой отражения частичных индексов на SQLite для #8804, когда команда прагмы index_list в очень старых версиях SQLite (возможно, до 3.8.9) не возвращала текущее ожидаемое количество столбцов, что приводило к исключениям, возникающим при отражении таблиц и индексов.

References: #8969

[tests] [bug] ¶

Исправлена проблема в файле tox.ini, когда изменения в серии tox 4.0 в формате «passenv» приводили к некорректной работе tox, в частности, вызывая ошибку начиная с tox 4.0.6.

[tests] [bug] ¶

Добавлено новое правило исключения для сторонних диалектов unusual_column_name_characters, которое может быть «закрыто» для сторонних диалектов, не поддерживающих имена колонок с необычными символами, такими как точки, косые черты или знаки процента, даже если имя правильно заключено в кавычки.

References: #9002

[orm] [bug] ¶

Исправлена ошибка, при которой Session.merge() не сохранял текущее загруженное содержимое атрибутов отношений, указанных параметром relationship.viewonly, что приводило к нарушению стратегий, использующих Session.merge() для извлечения полностью загруженных объектов из кэша и других подобных приемов. В связанном с этим изменении исправлена проблема, когда объект, содержащий загруженное отношение, которое, тем не менее, было настроено как lazy='raise' на отображении, терпел неудачу при передаче в Session.merge(); теперь проверка на «повышение» приостанавливается в процессе слияния, предполагая, что параметр Session.merge.load остается по умолчанию True.

В целом это поведенческая корректировка изменения, введенного в серии 1.4 начиная с версии #4994, которое убрало «слияние» из набора каскадов, применяемых по умолчанию к отношениям «только для просмотра». Поскольку отношения «viewonly» не сохраняются ни при каких обстоятельствах, разрешение передачи их содержимого при «merge» не влияет на поведение сохранения целевого объекта. Это позволяет Session.merge() корректно использовать один из вариантов его применения - добавление в Session объектов, которые были загружены в другом месте, часто для восстановления из кэша.

References: #8862

[orm] [bug] ¶

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

References: #8881

[engine] [bug] ¶

Исправлена проблема, при которой метод Result.freeze() не работал для текстового SQL, использующего text() или Connection.exec_driver_sql().

References: #8963

[sql] [usecase] ¶

Теперь в случае неудачи любой операции рендеринга «literal bindparam» выбрасывается информативное сообщение re-raise с указанием самого значения и используемого типа данных, чтобы помочь в отладке при рендеринге буквальных параметров в операторе.

References: #8800

[sql] [bug] ¶

Исправлен ряд проблем, связанных с расположением, а иногда и идентичностью отображаемых связанных параметров, например, для SQLite, asyncpg, MySQL, Oracle и других. В некоторых скомпилированных формах порядок параметров сохранялся некорректно, например, в функции PostgreSQL regexp_replace(), во «вложенной» конструкции CTE, впервые появившейся в #4123, а также в таблицах с выбором, сформированных методом FunctionElement.column_valued() в Oracle.

References: #8827

[asyncio] [bug] ¶

Из AsyncResult удален нефункциональный метод merge(). Этот метод никогда не работал и был включен в AsyncResult по ошибке.

References: #8952

[postgresql] [bug] ¶

Внесена поправка в то, как диалект PostgreSQL учитывает типы столбцов при отражении столбцов из таблицы, для учета альтернативных бэкендов, которые могут возвращать NULL из функции PG format_type().

References: #8748

[sqlite] [usecase] ¶

Добавлена поддержка бэкенда SQLite для отражения ключевых слов «DEFERRABLE» и «INITIALLY», которые могут присутствовать в конструкции внешнего ключа. Pull request любезно предоставлен Майклом Горвеном.

References: #8903

[sqlite] [usecase] ¶

Добавлена поддержка отражения ориентированных на выражения критериев WHERE, включенных в индексы на диалекте SQLite, аналогично тому, как это делается на диалекте PostgreSQL. Pull request любезно предоставлен Тобиасом Пфайффером.

References: #8804

[sqlite] [bug] ¶

Резервное копирование исправления отражения SQLite уникальных ограничений в присоединенных схемах, выпущенного в 2.0 в виде небольшой части #4379. Ранее уникальные ограничения в присоединенных схемах игнорировались отражением SQLite. Pull request любезно предоставлен Майклом Горвеном.

References: #8866

[oracle] [bug] ¶

Продолжение исправления ошибки Oracle #8708, выпущенной в версии 1.4.43, в которой имена связанных параметров, начинающиеся с символов подчеркивания, запрещенных Oracle, все еще не приводились в надлежащий вид при любых обстоятельствах.

References: #8708

[oracle] [bug] ¶

Исправлена проблема в компиляторе Oracle, когда синтаксис для FunctionElement.column_valued() был неверен, что приводило к появлению имени COLUMN_VALUE без корректной квалификации исходной таблицы.

References: #8945

[sql] [bug] ¶

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

References: #8790

[postgresql] [bug] [mssql] ¶

Только для диалектов PostgreSQL и SQL Server компилятор настроен таким образом, что при выводе выражений столбцов в предложении RETURNING для элементов SQL-выражений, генерирующих метку, предлагается использовать метку «non anon», которая используется в операторах SELECT; основным примером является SQL-функция, которая может выдаваться как часть типа столбца, где имя метки по умолчанию должно совпадать с именем столбца. Это восстанавливает не вполне определенное поведение, которое изменилось в версии 1.4.21 из-за #6718, #6710. Диалект Oracle имеет другую реализацию RETURNING и не был затронут этой проблемой. В версии 2.0 внесены общие изменения для широкого расширения поддержки RETURNING в других бэкендах.

References: #8770

[oracle] [bug] ¶

Исправлена проблема в диалекте Oracle, когда оператор INSERT, использующий insert(some_table).values(...).returning(some_table) сразу против всего объекта Table, не выполнялся, вызывая исключение.

[tests] [bug] ¶

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

References: #8793

[tests] [bug] ¶

В тестовый набор, тестирующий плагин Mypy, внесены изменения в версии Mypy 0.990, касающиеся обработки вывода сообщений, которые влияют на интерпретацию sys.path при определении необходимости вывода заметок и ошибок для определенных файлов. Это изменение нарушило работу тестового набора, так как файлы в самой тестовой директории больше не выдавали сообщений при запуске под управлением API mypy.

[orm] [bug] ¶

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

References: #8738

[orm] [bug] ¶

Исправлена ошибка, связанная с конструкциями Select, когда комбинации Select.select_from() с Select.join(), а также при использовании Select.join_from() приводили к тому, что функция with_loader_criteria(), а также критерии IN, необходимые для запросов наследования одной таблицы, не отображались в тех случаях, когда в предложении columns запроса не была явно указана левая сторона сущности JOIN. Теперь правильная сущность передается в объект Join, который генерируется внутренне, что позволяет корректно добавлять критерии к левосторонней сущности.

References: #8721

[orm] [bug] ¶

При использовании опции with_loader_criteria() в качестве опции загрузчика, добавленной к определенному «пути загрузчика», например, при использовании ее внутри Load.options(), теперь выдается информативное исключение. Такое использование не поддерживается, поскольку with_loader_criteria() предназначена только для использования в качестве опции загрузчика верхнего уровня. Ранее возникала внутренняя ошибка.

References: #8711

[orm] [bug] ¶

Улучшен «режим словаря» для Session.get(), благодаря чему имена синонимов, ссылающиеся на имена атрибутов первичного ключа, могут быть указаны в именованном словаре.

References: #8753

[orm] [bug] ¶

Исправлена проблема, при которой загрузка «selectin_polymorphic» для отображателей наследования работала некорректно, если параметр Mapper.polymorphic_on ссылался на SQL-выражение, которое не было непосредственно отображено на класс.

References: #8704

[orm] [bug] ¶

Исправлена проблема, когда при использовании объекта Query в качестве итератора базовый курсор DBAPI не закрывался, если в процессе итерации возникало определенное пользователем исключение, что приводило к закрытию итератора интерпретатором Python. При использовании Query.yield_per() для создания курсоров на стороне сервера это приводило к обычным для MySQL проблемам, связанным с рассинхронизацией курсоров на стороне сервера, и без прямого доступа к объекту Result код конечного пользователя не мог получить доступ к курсору, чтобы закрыть его.

Для решения проблемы внутри метода итератора применяется catch для GeneratorExit, который закроет объект result в тех случаях, когда итератор был прерван, и по определению будет закрыт интерпретатором Python.

В рамках этого изменения, реализованного в серии 1.4, было обеспечено наличие методов .close() во всех реализациях Result, включая ScalarResult, MappingResult. В версии 2.0 это изменение также включает новые паттерны менеджера контекста для использования с классами Result.

References: #8710

[engine] [bug] [regression] ¶

Исправлена проблема, при которой крючок события PoolEvents.reset() вызывался не во всех случаях, когда Connection был закрыт и находился в процессе возврата своего DBAPI-соединения в пул соединений.

Сценарий заключался в том, что хук Connection уже выполнил .rollback() на своем DBAPI-соединении в процессе возврата соединения в пул, где он инструктировал пул соединений не выполнять свой собственный «сброс», чтобы сэкономить на дополнительном вызове метода. Однако это не позволяло использовать пользовательские схемы сброса пула в рамках данного хука, поскольку такие хуки по определению выполняют нечто большее, чем просто вызов .rollback(), и должны вызываться при любых обстоятельствах. Это была регрессия, появившаяся в версии 1.4.

В версии 1.4 функция PoolEvents.checkin() остается актуальной в качестве альтернативного крючка событий для использования в пользовательских реализациях «сброса». В версии 2.0 появится улучшенная версия PoolEvents.reset(), которая будет вызываться для дополнительных сценариев, таких как завершение asyncio-соединений, а также ей будет передаваться контекстная информация о сбросе, что позволит реализовать схемы «пользовательского сброса соединений», которые могут по-разному реагировать на различные сценарии сброса.

References: #8717

[engine] [bug] ¶

Обеспечено включение во все объекты Result метода Result.close(), а также атрибута Result.closed, в том числе в ScalarResult и MappingResult.

References: #8710

[sql] [bug] ¶

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

References: #8724

[mssql] [bug] ¶

Исправлена проблема с Inspector.has_table(), которая при использовании к временной таблице диалекта SQL Server приводила к ошибке на некоторых вариантах Azure из-за лишнего запроса информационной схемы, который не поддерживается на этих версиях сервера. Pull request любезно предоставлен Майком Барри.

References: #8714

[mssql] [bug] [reflection] ¶

Исправлена проблема с Inspector.has_table(), которая при использовании против представления с диалектом SQL Server ошибочно возвращала False, что связано с регрессией в серии 1.4, удалившей поддержку этой функции на SQL Server. В серии 2.0, использующей другую архитектуру отражения, эта проблема отсутствует. Добавлена тестовая поддержка, чтобы убедиться, что has_table() продолжает работать в соответствии со спецификацией, касающейся представлений.

References: #8700

[oracle] [bug] ¶

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

References: #8708

[oracle] [bug] ¶

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

References: #8744

[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] ¶

В Core реализована новая опция Connection.execution_options.yield_per для выполнения Connection, которая повторяет аналогичную опцию 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 любезно предоставлен tchapi.

References: #8196

[asyncio] [bug] ¶

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

References: #8145

[postgresql] [bug] ¶

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

В рамках этого изменения была сохранена поддержка другого непреднамеренно работавшего стиля мультихостов, который представляет собой формат ?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 „No corresponding transaction found. (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» в виде фиксированной вызываемой функции на уровне модуля, которая производит SQL-выражение. Специальная «лямбда» не может быть пикирована, а объект SQL-выражения обычно не является полностью пикируемым напрямую.

References: #8109

[engine] [bug] ¶

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

References: #8115

[sql] [bug] ¶

Исправлено несколько наблюдаемых состояний гонки, связанных с lambda_stmt(), включая проблему «собачьей кучи» при первоначальном анализе нового объекта кода Python в нескольких одновременных потоках, которая приводила как к проблемам с производительностью, так и к некоторому внутреннему повреждению состояния. Кроме того, для версий Python до 3.10 было исправлено состояние гонки, которое могло возникнуть при «клонировании» конструкции выражения, находящейся в процессе компиляции или другого доступа в другом потоке, из-за того, что мемоизированные атрибуты изменяли __dict__ во время итерации; в частности, к этому чувствительна конструкция 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, не передавало корректное состояние mapper / mapped table в 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 любезно предоставлен Alex Grönholm.

References: #7943

[postgresql] [bug] ¶

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

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» по-прежнему блокируется от режима «исполняемых значений», поскольку в предложении DO UPDATE могут присутствовать дополнительные параметры, которые не могут быть переданы в пакет (что и было первоначальной проблемой, исправленной в #6581).

References: #7880

[orm] [usecase] ¶

К функции with_polymorphic() добавлена функция with_polymorphic.adapt_on_names, которая позволяет указать полиморфную нагрузку (обычно с конкретным отображением) против альтернативного 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] [bug] [regression] ¶

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

References: #7868

[orm] [bug] ¶

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

References: #7801

[orm] [bug] [performance] ¶

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

References: #7823

[orm] [bug] ¶

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

References: #7799

[orm] [bug] ¶

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

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 добавлен недостающий метод AsyncSession.invalidate().

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-конструкцию. Ранее при передаче таких вызываемых объектов, что является распространенной типографской ошибкой при работе с SQL-конструкциями, связанными с методами, они интерпретировались как цели «лямбда SQL», которые должны быть вызваны во время компиляции, что приводило к тихим сбоям. Поскольку данная возможность не предназначалась для использования с методами, объекты методов теперь отвергаются.

References: #7032

[mypy] [bug] ¶

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

References: #7321

[asyncio] [usecase] ¶

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

References: #7580

[postgresql] [usecase] ¶

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

References: #7561

[postgresql] [bug] [asyncpg] ¶

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

References: #7537

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

Исправлено отражение покрывающих индексов, в результате чего в словаре отраженных индексов в качестве части записи dialect_options сообщается include_columns, что позволяет завершить цикл отражение->создание. Для обратной совместимости включенные столбцы продолжают присутствовать и под ключом 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 courtesy 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 дженерики в сочетании с классом 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] ¶

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

References: #7388

[orm] [deprecated] ¶

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

References: #4390

[engine] [usecase] ¶

В класс URL добавлена поддержка copy() и deepcopy(). 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, когда нельзя было создать вариант стратегии загрузчика, нацеленный на атрибут цели с помощью конструкции 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 был добавлен Result.close() и реализован для реализаций фильтрованных результатов, используемых 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.extend_existing для дополнения существующего Table параметр Table.implicit_returning размещался некорректно.

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 к типу «float» PostgreSQL вместо «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 любезно предоставлен Кевином Кирше (Kevin Kirsche).

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, как это происходит в таких местах, как объединенная ускоренная загрузка в сочетании с limit/offset. В целом это была регрессия, связанная с выпуском #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 логику «разотождествления столбцов», когда одно и то же выражение при повторении получает метку «extra anonymous», с тем чтобы логика более агрессивно дедуплицировала эти метки, когда повторяющийся элемент каждый раз является одним и тем же объектом выражения Python, как это происходит в случаях использования значений «singleton» типа null(). Это основано на наблюдении, что, по крайней мере, некоторые базы данных (например, MySQL, но не SQLite) выдают ошибку, если одна и та же метка повторяется внутри подзапроса.

References: #7153

[mypy] [bug] ¶

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

References: #6435

[postgresql] [bug] ¶

Добавлено условие «отключения» для сообщения об ошибке «Ошибка SSL SYSCALL: Bad address», о чем сообщил psycopg2. Pull request любезно предоставлен Зиком Брехтелем (Zeke Brechtel).

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, которые автоматически используются DBAPI mysqlclient (применимо как к 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(), используемому внутри процесса слияния, что позволяет применять ускоренную загрузку отношений и т.д., когда процесс слияния загружает новый объект. Pull request любезно предоставлен Дэниелом Стоуном.

References: #6955

[orm] [bug] [regression] ¶

Исправлена проблема ORM, когда выражения столбцов, передаваемые в query() или в ORM-выражение 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 или используемым async-драйвером. Для стандартных pep-249 DBAPI это всегда будет тот же объект, что и в dbapi_connection. Для асинхронного драйвера это будет базовый объект соединения, поддерживающий только асинхронный режим.

Атрибут .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. Заметим, что «быстрый insertmany» PostgreSQL использует «RETURNING» по определению, когда SQL-оператор передается драйверу; в целом, флаг create_engine.implicit_returning является унаследованным и не имеет реального применения в современной SQLAlchemy, и будет устаревшим в отдельном изменении.

References: #6963

[sql] [usecase] ¶

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

References: #4123

[sql] [bug] ¶

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

References: #7052

[sql] [bug] ¶

Исправлены две проблемы, когда комбинации select() и join() при адаптации для формирования копии элемента не полностью копировали состояние всех объектов столбцов, связанных с подзапросами. Основная проблема, которую это вызывало, заключалась в том, что при использовании метода ClauseElement.params() (который, вероятно, следует перевести в категорию legacy, поскольку он неэффективен и чреват ошибками) оставались копии старых объектов 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 invalid isolation level на драйвере pysqlite не указывалось, что «AUTOCOMMIT» является одним из допустимых уровней изоляции.

[mssql] [bug] [reflection] ¶

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

References: #6910

[oracle] [bug] [performance] ¶

Добавлен 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 не установлен, с соответствующими пропусками для тестов, связанных с асинхронностью.

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, а также в других рецептах, таких как определение «идентификатора шарда» для расширения горизонтального разделения, будет корректно передаваться в eager и lazy loaders независимо от того, был ли в конечном итоге вызван кэшированный запрос.

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 from «a to b», что не работало для случая, когда цепочка соединений имела более одного элемента.

References: #6886

[sql] [bug] ¶

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

[schema] [enum] ¶

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

References: #6146

[mypy] [usecase] ¶

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

References: #6759, #6804

[postgresql] [bug] ¶

В операторы PostgreSQL «overlaps», «contained_by», «contains» добавлен флаг «is_comparison», чтобы они работали в соответствующих контекстах 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, например, для eager loading, polymorphic loading и т.д.

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.union(), новая используемая структура неправомерно передавалась во вложенный Query, в результате чего инструкции 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, не срабатывал корректно при создании/выгрузке, если использовалась функция 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 любезно предоставлен Miłosz Stypiński.

References: #6538

[engine] [bug] ¶

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

References: #5348

[engine] [bug] ¶

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

References: #6665

[sql] [usecase] ¶

Добавить в конструктор PickleType параметр impl, позволяющий использовать любой произвольный тип вместо стандартной реализации LargeBinary. Pull request courtesy 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, выдавалось предупреждение «overlaps», введенное в 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 в ORM-совместимом select() также следует этим правилам, что, в частности, позволяет корректно отображать рекурсивные 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» неявно запускала транзакцию, что при использовании драйвера psycopg2 мешало использованию пользовательских транзакционных флагов, таких как режим «только чтение» PostgreSQL.

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, когда в значениях INSERT указывалось значение колонки IDENTITY, что приводило к срабатыванию функции SQLAlchemy по установке IDENTITY INSERT в значение «on»; именно при такой директиве карта перевода схемы не выполнялась.

References: #6658

[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] [performance] [regression] ¶

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

References: #6596

[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 deprecated для удаления в 2.0 станет стандартным поведением в SQLAlchemy 2.0, добавление элемента в коллекцию, которая является уникальной, например set или dict, не вызывало каскадного события, если объект уже был связан в этой коллекции через обратную ссылку. Это исправление представляет собой фундаментальное изменение механики работы с коллекциями, поскольку вводит новое состояние события, которое может срабатывать при мутации коллекции, даже если в ней не происходит никаких изменений; для этого действия теперь используется новый крючок события AttributeEvents.append_wo_mutation().

References: #6471

[orm] [bug] [regression] ¶

Исправлена регрессия, связанная с адаптацией выражения для маркированных составных элементов ORM, таких как выражения дискриминатора наследования одной таблицы с условными знаками или CASE-выражения, которая могла привести к некорректной адаптации псевдослучайных выражений, например, используемых в операциях join / joinedload в ORM, например, к ссылке на неправильную таблицу в предложении 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 также содержал секцию username:password.

References: #6482

[engine] [bug] ¶

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

References: #6329

[sql] [bug] [regression] ¶

Исправлена регрессия в стратегии динамического загрузчика и relationship() в целом, когда параметр 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. В настоящее время усилия направлены на пакет stub, а наличие типов в двух местах ухудшает ситуацию, так как типы в исходниках SQLAlchemy обычно устарели по сравнению с версиями в stubs.

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] ¶

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

References: #6459

[sql] [bug] ¶

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

References: #6460

[mysql] [bug] [documentation] ¶

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

References: #5397

[orm] [bug] [regression] ¶

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

References: #6426

[engine] [usecase] [orm] ¶

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

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

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

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

References: #6288

[engine] [bug] [regression] ¶

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

References: #6427

[sql] [bug] [regression] ¶

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

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() в целом для работы с выражениями столбцов даже в контексте, отличном от нормального.

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] ¶

Исправлена регрессия, связанная с тем, что при инстанцировании движка async до запуска любого цикла asyncio создавался цикл #6337, который asyncio.Lock мог быть присоединен к неправильному циклу, что приводило к сообщению об ошибке 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] ¶

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

References: #6391

[orm] [bug] ¶

Исправлены две разные проблемы, в основном затрагивающие hybrid_property, которые возникали при распространенных сценариях неправильной конфигурации, которые в 1.3 молчаливо игнорировались, а в 1.4 стали неудачными, когда реализация «выражения» возвращала не ClauseElement, например, булево значение. В обоих случаях поведение 1.3 заключалось в молчаливом игнорировании неправильной конфигурации и попытке интерпретировать значение как SQL-выражение, что приводило к некорректному запросу.

• Исправлена проблема взаимодействия системы атрибутов с hybrid_property, когда если метод __clause_element__() атрибута возвращал не:class:_sql.ClauseElement объект, то внутренний AttributeError приводил к тому, что атрибут возвращал функцию expression на самом hybrid_property, так как ошибка атрибута была против имени .expression, которое вызывало метод __getattr__() в качестве запасного варианта. Теперь это происходит в явном виде. В версии 1.3 не:class:_sql.ClauseElement возвращалось напрямую.

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

References: #6350

[orm] [bug] ¶

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

References: #6378

[orm] [bug] [regression] ¶

Исправлена проблема, при которой новое поведение autobegin не приводило к «автозапуску» в случае изменения атрибутов существующего постоянного объекта, что влияло на поведение Session.rollback(), поскольку не создавался снимок для отката. Механика «изменения атрибутов» была обновлена, чтобы обеспечить «автозапуск», который не выполняет никакой работы с базой данных, при изменении атрибутов персистентного объекта таким же образом, как и при вызове Session.add(). Это регресс, поскольку в версии 1.3 метод rollback() всегда имел транзакцию для отката и каждый раз завершался.

References: #6359, #6360

[orm] [bug] [regression] ¶

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

References: #6386

[orm] [bug] [regression] ¶

Исправлена регрессия в hybrid_property, когда гибрид против SQL-функции в некоторых случаях выдавал ошибку AttributeError при попытке сгенерировать запись для коллекции .c подзапроса; помимо прочего, это влияло на его использование в случаях, подобных Query.count().

References: #6401

[orm] [bug] [dataclasses] ¶

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

References: #6346

[orm] [bug] ¶

Исправлена проблема с методом (устаревшим в 1.4) ForeignKeyConstraint.copy(), который приводил к ошибке при вызове с аргументом schema.

References: #6353

[engine] [bug] ¶

Исправлена проблема, при которой использование явного выражения Sequence приводило к непоследовательному поведению «inline» для конструкции Insert, включающей несколько фраз значений; первый seq был inline, а последующие - «pre-execute», что приводило к непоследовательному упорядочиванию последовательности. Теперь выражения последовательности полностью инлайновые.

References: #6361

[sql] [bug] ¶

Пересмотрено выражение «EMPTY IN», которое больше не зависит от использования подзапроса, так как это вызывало некоторые проблемы с совместимостью и производительностью. Новый подход для выбранных баз данных использует преимущества использования выражения IN с возвратом NULL в сочетании с обычным выражением «1 != 1» или «1 = 1», дополненным операторами AND или OR. Это выражение теперь используется по умолчанию для всех бэкендов, кроме SQLite, который все еще имел некоторые проблемы совместимости с кортежами «IN» для старых версий SQLite.

Сторонние диалекты по-прежнему могут переопределять отображение выражения «пустое множество», реализуя новый метод компилятора def visit_empty_set_op_expr(self, type_, expand_op), который имеет приоритет над существующим def visit_empty_set_expr(self, element_types), который остается в силе.

References: #6258, #6397

[sql] [bug] [regression] ¶

Исправлена ошибка, при которой использование конструкции text() внутри предложения columns конструкции Select, для которой лучше использовать конструкцию literal_column(), тем не менее, не позволяло корректно работать конструкциям типа union(). Другие случаи использования, например, построение подзапросов, продолжают работать так же, как и в предыдущих версиях, где конструкция text() молча опускается из коллекции экспортируемых столбцов. Также исправлено аналогичное использование в ORM.

References: #6343

[sql] [bug] [regression] ¶

Исправлена регрессия, связанная с устаревшими методами, такими как Select.append_column(), при которой внутренние утверждения не выполнялись.

References: #6261

[sql] [bug] [regression] ¶

Исправлена регрессия, вызванная #5395, когда отстройка проверки последовательностей в select() приводила к сбоям при выполнении запросов в стиле 2.0 с отображенным классом, который также имеет метод __iter__(). Настроил проверку еще раз, чтобы учесть это, а также некоторые другие интересные сценарии __iter__().

References: #6300

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

Убедитесь, что диалект MySQL и MariaDB игнорирует конструкцию Identity при отображении ключевого слова AUTO_INCREMENT в таблице create.

Обновлен компилятор Oracle и PostgreSQL, который не выводит Identity, если версия базы данных его не поддерживает (Oracle < 12 и PostgreSQL < 10). Ранее он отображался независимо от версии базы данных.

References: #6338

[postgresql] [bug] ¶

Исправлена очень старая проблема, из-за которой тип данных Enum не наследовал параметр MetaData.schema объекта MetaData, когда этот объект передавался в Enum с помощью Enum.metadata.

References: #6373

[sqlite] [usecase] ¶

По умолчанию используется пул SingletonThreadPool для баз данных in-memory SQLite, созданных с использованием имен файлов URI. Ранее по умолчанию использовался пул NullPool, который предполагал совместное использование одной и той же базы данных несколькими движками.

References: #6379

[mssql] [bug] [schema] ¶

Добавить поддержку TypeEngine.as_generic() для столбцов sqlalchemy.dialects.mysql.BIT, отображая их на Boolean.

References: #6345

[mssql] [bug] [regression] ¶

Исправлена регрессия, вызванная появлением #6306, добавившего поддержку DateTime(timezone=True), при которой прежнее поведение драйвера pyodbc, заключавшееся в неявном сбросе tzinfo из даты с учетом временной зоны при INSERT в колонку DATETIME с учетом временной зоны, терялось, что приводило к ошибке SQL Server при вставке объектов с учетом временной зоны в колонки базы данных, не учитывающие временную зону.

References: #6366

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

Исправлена регрессия, в результате которой недавние изменения в поддержке классов данных Python приводили к тому, что класс, сопоставленный с ORM, не мог успешно переопределить метод __new__().

References: #6331

[engine] [bug] [regression] ¶

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

References: #6337

[orm] [usecase] ¶

Изменено поведение, исправленное в #6232, где стратегия загрузчика immediateload больше не входит в рекурсивные циклы; модификация заключается в том, что при нетерпеливой загрузке (joinedload, selectinload или subqueryload) из A->bs->B, которая затем указывает immediateload для простого manytoone B->a->A, находящегося в карте идентификации, заполняется B->A, так что этот атрибут снова заполняется при загрузке коллекции A/A.bs. Это позволяет объектам быть функциональными при отсоединении.

[orm] [bug] ¶

Исправлена ошибка в новой функции with_loader_criteria(), когда при использовании класса mixin с declared_attr() на атрибуте, к которому обращались внутри пользовательской лямбды, выдавалось предупреждение об использовании не отображенного объявленного атрибута при первой инициализации вызываемой лямбды. Теперь это предупреждение предотвращается с помощью специального инструментария для этого шага инициализации лямбды.

References: #6320

[orm] [bug] [regression] ¶

Исправлена дополнительная регрессия, вызванная функцией «eagerloaders on refresh», добавленной в #1763, где операция обновления исторически устанавливала флаг populate_existing, который, учитывая новую функцию, теперь перезаписывает ожидающие изменения в нетерпеливо загруженных объектах, когда autoflush равен false. Флаг populate_existing для этого случая был отключен, и для обеспечения обновления нужных атрибутов был использован более специфический метод.

References: #6326

[orm] [bug] [result] ¶

Исправлена проблема при использовании стиля выполнения 2.0, которая не позволяла использовать Result.scalar_one() или Result.scalar_one_or_none() после вызова Result.unique() для случая, когда ORM в любом случае возвращает одноэлементную строку.

References: #6299

[sql] [bug] ¶

Исправлена проблема в компиляторе SQL, когда связанные параметры, заданные для конструкции Values, не отслеживались позиционно, если находились внутри конструкции CTE, что негативно сказывалось на драйверах баз данных, поддерживающих VALUES + ctes и использующих позиционные параметры, в частности, SQL Server, а также asyncpg. Также исправлена поддержка флагов компилятора, таких как literal_binds.

References: #6327

[sql] [bug] ¶

Исправлены и устранены проблемы, связанные с пользовательскими функциями и другими произвольными конструкциями выражений, которые в рамках механики маркировки столбцов SQLAlchemy пытались использовать str(obj) для получения строкового представления для использования в качестве анонимного имени столбца в коллекции .c подзапроса. Это очень устаревшее поведение, которое плохо работает и приводит к множеству проблем, поэтому оно было изменено, чтобы больше не выполнять компиляцию путем создания специальных методов на FunctionElement для обработки этого случая, так как функции SQL являются единственным случаем, когда оно используется. Следствием такого поведения является то, что немаркированному столбцовому выражению без производного имени будет присваиваться произвольная метка, начинающаяся с префикса "_no_label" в коллекции .c подзапроса; ранее они представлялись либо как общая структуризация этого выражения, либо как внутренний символ.

References: #6256

[schema] [bug] ¶

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

References: #6287

[mypy] [bug] ¶

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

References: #6255

[mssql] [usecase] ¶

Параметр DateTime.timezone при установке значения True теперь будет использовать тип столбца DATETIMEOFFSET в SQL Server при эмуляции DDL, а не DATETIME, где флаг молча игнорировался.

References: #6306

[bug] [declarative] [regression] ¶

Исправлена ошибка instrument_declarative(), вызывающая несуществующий метод реестра.

References: #6291

[orm] [usecase] ¶

Установлена поддержка synoynm() в сочетании с гибридным свойством, полностью настроен assocaitionproxy, в том числе могут быть созданы синонимы, связывающие эти конструкции, которые полностью работают. Ранее такое поведение было полуявно запрещено, но поскольку оно не во всех случаях давало сбой, была добавлена явная поддержка assoc proxy и гибридов.

References: #6267

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

Исправлена критическая проблема производительности, когда при обходе конструкции select() выполнялся обход повторяющегося произведения представленных предложений FROM, поскольку каждое из них ссылалось на столбцы в предложении columns; для серии вложенных подзапросов с большим количеством столбцов это могло привести к большой задержке и значительному увеличению памяти. Этот обход используется множеством SQL- и ORM-функций, включая ORM Session, когда он настроен на «table-per-bind», и хотя это не самый распространенный случай использования, похоже, что Flask-SQLAlchemy жестко закодирован на его использование, поэтому проблема затрагивает пользователей Flask-SQLAlchemy. Обход был исправлен на унификацию в предложениях FROM, что, по сути, неявно происходило в архитектуре до версии 1.4.

References: #6304

[orm] [bug] [regression] ¶

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

References: #6272

[sql] [bug] [regression] ¶

Исправлена ошибка, при которой пустой оператор in для кортежа приводил к ошибке при компиляции с опцией literal_binds=True.

References: #6290

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

Исправлена ошибка аргумента в компиляторах default и PostgreSQL, которая мешала выполнению оператора UPDATE..FROM или DELETE..FROM..USING, из которого затем производился выбор в виде CTE.

References: #6303

[orm] [bug] [regression] ¶

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

Кроме того, исправлена регрессия, связанная с соответствующей функцией query_expression(). Хотя технически эта ошибка существует и в 1.3, она была обнаружена только в 1.4. Значение «expr по умолчанию» null() приводилось, когда оно не требовалось, а также не адаптировалось корректно, когда ORM переписывала выражения, например, при использовании объединенной ускоренной загрузки. Исправление гарантирует, что «одиночные» выражения типа NULL и true не будут «адаптированы» для ссылок на столбцы в ORM-выражениях, а также гарантирует, что query_expression() без выражения по умолчанию не будет отображаться в выражении, если with_expression() не используется.

References: #6259

[orm] [bug] ¶

Исправлена проблема, связанная с новой функцией Session.refresh(), введенной в #1763, когда нетерпеливо загруженные отношения также обновляются, когда стратегии загрузчика lazy="raise" и lazy="raise_on_sql" мешали стратегии загрузчика immediateload(), что нарушало работу функции для отношений, которые были загружены с помощью , , а также для отношений, загруженных с помощью selectinload(), subqueryload().

References: #6252

[engine] [bug] ¶

Метод Dialect.has_table() теперь вызывает информативное исключение, если ему передается не-Connection, поскольку такое некорректное поведение, по-видимому, встречается часто. Этот метод не предназначен для использования вне диалекта. Пожалуйста, используйте метод Inspector.has_table() или для кросс-совместимости со старыми версиями SQLAlchemy метод Engine.has_table().

[sql] [feature] ¶

Кортеж, возвращаемый командой CursorResult.inserted_primary_key, теперь представляет собой объект Row с именованным интерфейсом поверх существующего интерфейса tuple.

References: #3314

[sql] [bug] [regression] ¶

Исправлена ошибка, при которой объект BindParameter не отображался должным образом для выражения IN (т.е. при использовании функции «post compile» в 1.4), если объект копировался из внутренней операции клонирования или из операции pickle, а имя параметра содержало пробелы или другие специальные символы.

References: #6249

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

Исправлена регрессия, при которой введение синтаксиса INSERT «INSERT… VALUES (DEFAULT)» не поддерживался некоторыми бэкендами, которые, однако, поддерживают «INSERT..DEFAULT VALUES», включая SQLite. Теперь эти два синтаксиса поддерживаются или не поддерживаются отдельно для каждого диалекта, например, MySQL поддерживает «VALUES (DEFAULT)», но не «DEFAULT VALUES». Также была включена поддержка Oracle.

References: #6254

[mypy] [change] ¶

Обновлен плагин Mypy, который теперь использует только публичный интерфейс плагина семантического анализатора.

[mypy] [bug] ¶

Переработано исправление для OrderingList из версии 1.4.7, которое тестировалось на некорректном API.

References: #6205

[asyncio] [bug] ¶

Исправлена опечатка, из-за которой атрибут bind не мог установить правильное значение для атрибута AsyncSession.

References: #6220

[mssql] [bug] [regression] ¶

Исправлена дополнительная регрессия в той же области, что и в #6173, #6184, когда при использовании значения 0 для OFFSET в сочетании с LIMIT в SQL Server создавался оператор, использующий «TOP», как это было в 1.3, однако из-за кэширования он не реагировал соответствующим образом на другие значения OFFSET. Если «0» не было первым, то все было бы в порядке. Для исправления, синтаксис «TOP» теперь выдается только в том случае, если значение OFFSET опущено полностью, то есть не используется Select.offset(). Обратите внимание, что это изменение требует, чтобы при использовании модификаторов «with_ties» или «percent» в операторе нельзя было указывать значение OFFSET, равное нулю, теперь его нужно опускать полностью.

References: #6265

[orm] [bug] [regression] ¶

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

References: #6221

[orm] [bug] [regression] ¶

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

References: #6211

[orm] [bug] [regression] ¶

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

Кроме того, уменьшена часть изменений, сделанных в рамках #5226, которые могут выполнять autoflush во время операции unexpire, чтобы не делать этого в случае Session, использующего унаследованный режим Session.autocommit, поскольку это приводит к фиксации в рамках операции refresh.

References: #6233

[orm] [bug] [regression] ¶

Исправлена ошибка, при которой схема компиляции ORM предполагала, что имя функции гибридного свойства совпадает с именем атрибута, в результате чего возникала ошибка AttributeError при попытке определить правильное имя для каждого элемента в кортеже результатов. Аналогичная проблема существует и в 1.3, но касается она только имен строк кортежа. Исправление добавляет проверку того, что имя функции гибрида действительно присутствует в __dict__ класса или его суперклассов, прежде чем присваивать это имя; в противном случае гибрид считается «безымянным», и кортежи результатов ORM будут использовать схему именования базового выражения.

References: #6215

[orm] [bug] [regression] ¶

Исправлена критическая регрессия, вызванная новой функцией, добавленной в #1763, - вызов загрузчиков нетерпения на операциях unexpire. Новая возможность использует стратегию «немедленной загрузки» eager loader в качестве замены стратегии загрузки коллекции, которая, в отличие от других стратегий «после загрузки», не учитывала рекурсивные вызовы между взаимозависимыми отношениями, что приводило к ошибкам переполнения рекурсии.

References: #6232

[engine] [bug] [regression] ¶

Исправлено поведение объекта Row при обращении к нему по словарю, т.е. преобразование в dict через dict(row) или обращение к его членам через строки или другие объекты, т.е. row["some_key"] работает как в случае со словарем, а не вызывает TypeError, как в случае с кортежем, независимо от наличия или отсутствия расширений Си. Изначально предполагалось, что для «небудущего» случая использования LegacyRow будет выдаваться предупреждение об устаревании версии 2.0, а для «будущего» класса Row будет выдаваться предупреждение TypeError. Однако версия Row на языке Си не могла выдать это предупреждение TypeError, и, чтобы усложнить ситуацию, метод Session.execute() теперь возвращает Row во всех случаях, чтобы сохранить согласованность с результатом ORM, поэтому пользователи, у которых не установлены расширения на языке Си, будут видеть другое поведение в этом единственном случае для существующего кода в стиле pre-1.4.

Поэтому, чтобы смягчить общую схему обновления, поскольку большинство пользователей не сталкивались с более строгим поведением Row вплоть до версии 1.4.6, LegacyRow и Row обеспечивают как доступ по строковым ключам, так и поддержку dict(row), во всех случаях выдавая предупреждение о депривации 2.0 при включении SQLALCHEMY_WARN_20. Объект Row по-прежнему использует кортежеподобное поведение для __contains__, что, пожалуй, является единственным заметным изменением в поведении по сравнению с LegacyRow, если не считать удаления методов values() и items() в стиле словаря.

References: #6218

[sql] [bug] [regression] ¶

Усовершенствована функция «расширения», используемая для операций ColumnOperators.in_(), позволяющая выводить тип выражения из правого списка элементов, если в левой части не задан явный тип. Это позволяет выражению, в частности, поддерживать строку. В версии 1.3 «расширение» не использовалось автоматически для выражений ColumnOperators.in_(), так что в этом смысле данное изменение исправляет регрессию в поведении.

References: #6222

[sql] [bug] ¶