1.0 Changelog¶
1.0.19¶
Released: August 3, 2017oracle¶
Исправлена регрессия производительности, вызванная исправлением для #3937, когда cx_Oracle в версии 5.3 удалил символ
.UNICODE
из своего пространства имен, что было интерпретировано как включение режима «WITH_UNICODE» в cx_Oracle, который вызывает функции на стороне SQLAlchemy, преобразующие все строки в юникод, что приводит к снижению производительности. На самом деле, по словам автора cx_Oracle, режим «WITH_UNICODE» был полностью удален в версии 5.1, поэтому дорогостоящие функции преобразования юникода больше не нужны и отключаются, если cx_Oracle 5.1 или выше обнаружен под Python 2. Также восстановлено предупреждение против режима «WITH_UNICODE», которое было удалено при #3937.References: #4035
1.0.18¶
Released: July 24, 2017oracle¶
Исправление режима WITH_UNICODE в cx_Oracle, которое было обнаружено благодаря тому, что cx_Oracle 5.3 теперь, похоже, жестко кодирует этот флаг в сборке; внутренний метод, использующий этот режим, использовал неправильную сигнатуру.
References: #3937
tests¶
Исправлена проблема в тестировании фикстур, которая была несовместима с изменением, внесенным в Python 3.6.2 в отношении менеджеров контекста.
References: #4034
1.0.17¶
Released: January 17, 2017orm¶
misc¶
Исправлено предупреждение Python 3.6 DeprecationWarnings, связанное с экранированными строками без модификатора „r“, и добавлено тестовое покрытие для Python 3.6.
References: #3886
1.0.16¶
Released: November 15, 2016orm¶
Исправлена ошибка в
Session.bulk_update_mappings()
, когда атрибут первичного ключа с альтернативным именем не отслеживался должным образом в операторе UPDATE.References: #3849
Исправлена ошибка, когда объединенная ускоренная загрузка не работала для полиморфно загруженного отображателя, где polymorphic_on был установлен на выражение без отображения, такое как выражение CASE.
References: #3800
Исправлена ошибка, при которой ошибка ArgumentError, возникающая при некорректной привязке, отправленной в сессию через
Session.bind_mapper()
,Session.bind_table()
или конструктор, не была корректно вызвана.References: #3798
Исправлена ошибка в
Session.bulk_save()
, когда UPDATE не функционировал корректно в сочетании с отображением, реализующим счетчик id версии.References: #3781
Исправлена ошибка, при которой
Mapper.attrs
,Mapper.all_orm_descriptors
и другие производные атрибуты не обновлялись, когда свойства маппера или другие ORM-конструкции добавлялись к мапперу/классу после первого вызова этих аксессоров.References: #3778
mssql¶
Изменен запрос, используемый для получения «имени схемы по умолчанию», с запроса к таблице principals базы данных на использование функции «schema_name()», так как были получены сообщения о том, что прежняя система была недоступна в редакции Azure Data Warehouse. Есть надежда, что это наконец-то будет работать во всех версиях SQL Server и стилях аутентификации.
References: #3810
Обновлена схема получения информации о версии сервера для pyodbc, чтобы использовать SQL Server SERVERPROPERTY(), а не полагаться на pyodbc.SQL_DBMS_VER, который по-прежнему ненадежен, особенно с FreeTDS.
References: #3814
Добавлен код ошибки 20017 «неожиданный EOF от сервера» в список исключений разъединения, которые приводят к сбросу пула соединений. Pull request любезно предоставлен Кеном Роббинсом.
References: #3791
Исправлена ошибка в диалекте pyodbc (а также в неработающем диалекте adodbapi), когда точка с запятой в полях password или username могла быть интерпретирована как разделитель для другого токена; теперь при наличии точки с запятой значения берутся в кавычки.
References: #3762
misc¶
Исправлена ошибка, при которой установка подкласса однотабличной таблицы inh подкласса объединенной таблицы, включающего дополнительный столбец, приводила к повреждению коллекции внешних ключей сопоставленной таблицы, что мешало инициализации отношений.
References: #3797
1.0.15¶
Released: September 1, 2016orm¶
sql¶
Исправлена ошибка в
Table
, когда внутренний метод_reset_exported()
повреждал состояние объекта. Этот метод предназначен для выбираемых объектов и вызывается ORM в некоторых случаях; ошибочная конфигурация маппера может привести к тому, что ORM вызовет этот метод на объектеTable
.References: #3755
mysql¶
Добавлена поддержка разбора булевых и целочисленных аргументов MySQL/Connector в строке запроса URL: connection_timeout, connect_timeout, pool_size, get_warnings, raise_on_warnings, raw, consume_results, ssl_verify_cert, force_ipv6, pool_reset_session, compress, allow_local_infile, use_pure.
References: #3787
misc¶
Исправлена ошибка в
sqlalchemy.ext.baked
, когда при использовании нескольких загрузчиков подзапросов распаковка запроса с жадным загрузчиком подзапросов не выполнялась из-за проблемы с объемом переменной. Pull request любезно предоставлен Марком Ханенбергом.References: #3743
1.0.14¶
Released: July 6, 2016examples¶
Исправлена регрессия в примере examples/vertical/dictlike-polymorphic.py, из-за которой он не запускался.
References: #3704
engine¶
Исправлена ошибка в отражении межсхемного внешнего ключа в сочетании с аргументом
MetaData.schema
, когда ссылающаяся таблица, присутствующая в схеме «по умолчанию», терпела неудачу, поскольку не было способа указатьTable
, что для схемы указано «пусто». Специальный символsqlalchemy.schema.BLANK_SCHEMA
был добавлен в качестве доступного значения дляTable.schema
иSequence.schema
, указывая, что имя схемы должно быть принудительноNone
, даже если указаноMetaData.schema
.References: #3716
sql¶
Исправлена проблема в операторе отрицания в математике SQL, когда тип выражения больше не был числовым типом оригинала. Это приводило к проблемам, когда тип определял поведение набора результатов.
References: #3735
Исправлена ошибка, при которой методы
__getstate__
/__setstate__
для sqlalchemy.util.Properties были нерабочими из-за перехода в серии 1.0 на__slots__
. Проблема потенциально влияла на некоторые сторонние приложения. Pull request любезно предоставлен Питером Малдером.References: #3728
FromClause.count()
ожидает депривации в версии 1.1. Эта функция использует произвольный столбец в таблице и не является надежной; для использования в ядре следует предпочестьfunc.count()
.References: #3724
Исправлена ошибка в структуре
CTE
, из-за которой она не клонировалась должным образом при использовании объединения, как это часто бывает в рекурсивных CTE. Неправильное клонирование приводило к ошибкам при использовании CTE в различных контекстах ORM, например, в контекстеcolumn_property()
.References: #3722
Исправлена ошибка, при которой
Table.tometadata()
создавал дубликатUniqueConstraint
для каждого объектаColumn
, содержащего параметрunique=True
.References: #3721
postgresql¶
Исправлена ошибка, при которой типы
TypeDecorator
иVariant
недостаточно глубоко проверялись диалектом PostgreSQL, чтобы определить, нужно ли выводить SMALLSERIAL или BIGSERIAL, а не SERIAL.References: #3739
oracle¶
Исправлена ошибка в
Select.with_for_update.of
, когда подход Oracle «rownum» к LIMIT/OFFSET не учитывал выражения внутри предложения «OF», которые должны быть указаны на самом верхнем уровне, ссылаясь на выражения внутри подзапроса. Теперь выражения добавляются в подзапрос, если это необходимо.References: #3741
1.0.13¶
Released: May 16, 2016orm¶
Исправлена ошибка в стратегии «evaluate» в
Query.update()
иQuery.delete()
, из-за которой связанный параметр с «вызываемым» значением не принимался, как это происходит при фильтрации по выражению равенства «многие-к-одному» вдоль отношения.References: #3700
Исправлена ошибка, из-за которой слушатели событий, используемые для обратных ссылок, могли быть непреднамеренно применены несколько раз при использовании глубокой иерархии наследования классов в сочетании с несколькими шагами настройки маппера.
References: #3710
Исправлена ошибка, при которой передача конструкции
text()
в методQuery.group_by()
вызывала ошибку, вместо того, чтобы интерпретировать объект как фрагмент SQL.References: #3706
Анонимная маркировка применяется к конструкции
func
, которая передается вcolumn_property()
, так что если один и тот же атрибут дважды упоминается как выражение колонки, имена де-анонимизируются, что позволяет избежать ошибок «двусмысленной колонки». Ранее, чтобы имя было деанонимизировано, необходимо было применить.label(None)
.References: #3663
Исправлена регрессия, появившаяся в серии 1.0 при загрузке ORM, когда исключение, возникающее при отсутствии ожидаемого столбца, ошибочно выдавало ошибку
NoneType
, а не ожидаемоеNoSuchColumnError
.References: #3658
examples¶
Изменен пример «направленного графа», чтобы больше не считать целочисленные идентификаторы узлов значимыми; ссылки «выше» / «ниже» теперь допускают взаимные ребра в обоих направлениях.
References: #3698
sql¶
Исправлена ошибка, когда при использовании
case_sensitive=False
сEngine
в наборе результатов неправильно учитывались дублирующиеся имена столбцов в наборе результатов, что вызывало ошибку при выполнении оператора в версии 1.0 и предотвращало работу исключения «неоднозначный столбец» в версии 1.1.References: #3690
Исправлена ошибка, при которой отрицание выражения EXISTS неправильно типизировалось как boolean в результате, а также не могло быть анонимно выделено в списке SELECT, как это происходит в случае неотрицательной конструкции EXISTS.
References: #3682
Исправлена ошибка, при которой исключение «unconsumed column names» не возникало в случае, когда
Insert.values()
вызывалось со списком отображений параметров, а не с одним отображением параметров. Pull request любезно предоставлен Athena Yao.References: #3666
postgresql¶
Добавлена поддержка обнаружения разъединения для строки ошибки «SSL error: decryption failed or bad record mac». Pull request любезно предоставлен Iuri de Silvio.
References: #3715
mssql¶
Исправлена ошибка, при которой предложение ROW_NUMBER OVER, применяемое для OFFSET selects в SQL Server, неправомерно подставляло простой столбец из локального оператора, который пересекался с именем метки, используемой в критерии ORDER BY оператора.
References: #3711
Исправлена регрессия, появившаяся в серии 1.0, из-за которой диалекты Oracle и SQL Server неправильно учитывали столбцы набора результатов, когда эти диалекты оборачивали SELECT в подзапрос, чтобы обеспечить поведение LIMIT/OFFSET, а исходный оператор SELECT ссылался на один и тот же столбец несколько раз, например, на столбец и метку этого же столбца. Эта проблема связана с #3658 тем, что при возникновении ошибки она также вызывала ошибку
NoneType
, а не сообщала, что не может найти столбец.References: #3657
oracle¶
Исправлена ошибка в процессе подключения cx_Oracle, которая вызывала ошибку TypeError, когда пользователь, пароль или dsn были пустыми. Это препятствовало внешней аутентификации к базам данных Oracle и не позволяло подключиться к dsn по умолчанию. Строка подключения oracle:// теперь выполняет вход в dsn по умолчанию, используя имя пользователя операционной системы, что эквивалентно подключению через „/“ в sqlplus.
References: #3705
Исправлена ошибка в прокси результата, используемого в основном Oracle при работе с бинарными и другими типами LOB, из-за которой при использовании кэширования запросов/высказываний процессоры результата на уровне типа, в частности те, которые требуются самому бинарному типу, а также любые другие процессоры, терялись после первого запуска высказывания из-за того, что они удалялись из метаданных кэшированного результата.
References: #3699
misc¶
Исправлена ошибка в преобразовании «to_list», когда единичный объект bytes превращался в список отдельных символов. Это влияло, в частности, на использование метода
Query.get()
для первичного ключа, который является байтовым объектом.References: #3660
1.0.12¶
Released: February 15, 2016orm¶
Исправлена ошибка в
Session.merge()
, когда объект с составным первичным ключом, имеющим значения для некоторых, но не всех полей PK, выдавал оператор SELECT, пропуская в запрос внутренний символ NEVER_SET, вместо того, чтобы определить, что у этого объекта нет первичного ключа с возможностью поиска и не следует выдавать SELECT.References: #3647
Исправлена регрессия с версии 0.9, когда система опций загрузчика в стиле 0.9 не учитывала несколько опций загрузчика
undefer_group()
в одном запросе. Теперь несколько вариантовundefer_group()
будут учитываться даже для одной и той же сущности.References: #3623
engine¶
Пересмотр #2696, впервые выпущенного в версии 1.0.10, который пытается обойти отсутствие в Python 2 контекстного сообщения об исключениях, выдавая предупреждение об исключении, которое было прервано вторым исключением при попытке отката уже завершившейся транзакции; эта проблема продолжает возникать для бэкендов MySQL в сочетании с неожиданно потерянной точкой сохранения, которая затем вызывает ошибку «нет такой точки сохранения» при попытке отката, скрывая исходное состояние.
Подход был обобщен на функцию Core «safe reraise», которая выполняется в ORM и Core в любом месте, где транзакция откатывается в ответ на ошибку, возникшую при попытке фиксации, включая контекстные менеджеры, предоставляемые
Session
иConnection
, и выполняется для таких операций, как сбой на «RELEASE SAVEPOINT». Ранее исправление действовало только для определенного пути в процессе ORM flush/commit; теперь оно действует и для всех транзакционных менеджеров контекста.References: #2696
sql¶
Исправлена проблема, при которой флаг «literal_binds» не распространялся для конструкций
insert()
,update()
илиdelete()
при компиляции в строковый SQL. Pull request любезно предоставлен Тимом Тейтом.References: #3643
Исправлена проблема, когда непреднамеренное использование переопределения Python
__contains__
с выражением столбца (например, с помощью'x' in col
) приводило к бесконечному циклу в случае типа ARRAY, так как Python откладывает это на доступ__getitem__
, который никогда не возникает для этого типа. В целом, все использование__contains__
теперь вызывает ошибку NotImplementedError.References: #3642
Исправлена ошибка в конструкции метаданных
Table
, появившаяся примерно в серии 0.9, когда добавление колонок вTable
, который был непикирован, не позволяло правильно установитьColumn
в коллекции „c“, что приводило к проблемам в таких областях, как конфигурация ORM. Это могло повлиять на такие примеры использования, какextend_existing
и другие.References: #3632
postgresql¶
Исправлена ошибка в конструкции
text()
, при которой выражение с двойной точкой с запятой, напримерsome\:\:expr
, как это чаще всего требуется при отображении выражений CAST в стиле PostgreSQL, не выводилось должным образом.References: #3644
mssql¶
Исправлен синтаксис функции
extract()
при использовании на MSSQL в отношении значения времени даты; кавычки вокруг ключевого слова удалены. Pull request любезно предоставлен Гийомом Думенком.References: #3624
Исправлена регрессия 1.0, при которой нетерпеливая выборка cursor.rowcount больше не вызывалась для оператора UPDATE или DELETE, переданного через обычный текст или конструкцию
text()
, что влияло на те драйверы, которые стирают cursor.rowcount после закрытия курсора, например, драйверы SQL Server ODBC и Firebird.References: #3622
oracle¶
Исправлена небольшая проблема в компиляторе Jython Oracle, связанная с рендерингом «RETURNING», которая позволяет этому в настоящее время не поддерживаемому/непроверенному диалекту рудиментарно работать с серией 1.0. Pull request любезно предоставлен Карлосом Ривасом.
References: #3621
misc¶
Исправлена ошибка, при которой в некоторых сценариях перевыбора исключений исключение прикреплялось к самому себе как «причина»; хотя интерпретатор Python 3 не возражает против этого, в iPython это могло привести к бесконечным циклам.
References: #3625
1.0.11¶
Released: December 22, 2015orm¶
Исправлена регрессия, вызванная в 1.0.10 исправлением для #3593, когда добавленная проверка на полиморфный joinload из соединения poly_subclass->class->poly_baseclass не работала для сценария class->poly_subclass->class.
References: #3611
Исправлена ошибка, при которой
Session.bulk_update_mappings()
и связанные с ним не сбивали счетчик идентификатора версии при его использовании. Опыт здесь все еще немного грубоват, так как в данных словарях требуется исходный идентификатор версии, и пока нет чистого отчета об ошибках.References: #3610
Основные исправления флага
Mapper.eager_defaults
, этот флаг не будет корректно использоваться в случае, если будет выпущено несколько операторов UPDATE, либо как часть операции flush, либо как часть операции массового обновления. Кроме того, в операторах обновления без необходимости выдавался RETURNING.References: #3609
Исправлена ошибка, при которой использование метода
Query.select_from()
приводило к неудачному последующему вызову методаQuery.with_parent()
.References: #3606
sql¶
Исправлена ошибка в
Update.return_defaults()
, из-за которой все удерживающие столбцы по умолчанию вставки, не включенные в предложение SET (например, столбцы первичного ключа), выводились в RETURNING, даже если это UPDATE.References: #3609
mysql¶
Корректировка регулярного выражения, используемого для анализа представлений MySQL, так что мы больше не предполагаем наличие ключевого слова «ALGORITHM» в отраженном источнике представления, поскольку некоторые пользователи сообщали о его отсутствии в некоторых средах Amazon RDS.
References: #3613
Добавлены новые зарезервированные слова для MySQL 5.7 в диалект MySQL, включая „generated“, „optimizer_costs“, „stored“, „virtual“. Pull request любезно предоставлен Ханно Шлихтингом.
misc¶
Дополнительные исправления для метода #3605, метода pop на
MutableDict
, где не был включен аргумент «default».References: #3605
Исправлена ошибка в системе запеченных загрузчиков, когда общесистемный monkeypatch для настройки запеченных ленивых загрузчиков вмешивался в другие стратегии загрузчиков, которые полагаются на ленивую загрузку в качестве запасного варианта, например, объединенные и нетерпеливые загрузчики подзапросов, что приводило к исключениям
IndexError
во время настройки маппера.References: #3612
1.0.10¶
Released: December 11, 2015orm¶
Исправлена проблема, при которой post_update для отношения «многие к одному» не выдавал UPDATE в случае, когда атрибут был установлен на None и не был загружен ранее.
References: #3599
Исправлена ошибка, которая на самом деле является регрессией, возникшей между версиями 0.8.0 и 0.8.1, из-за #2714. В случае, когда при нетерпеливой загрузке необходимо соединиться через отношение, связанное с подклассом, когда также использовался «with_polymorphic», не удавалось соединиться с правильной сущностью.
References: #3593
Исправлена ошибка объединенной загрузки, которая возникала, когда a. запрос включал критерии ограничения/смещения, что заставляло выполнять подзапрос b. отношение использовало «вторичное» c. primaryjoin отношения ссылался на столбец, который либо не является частью первичного ключа, либо является PK col в объединенной таблице подкласса наследования, который находится под другим именем атрибута, чем столбец первичного ключа родительской таблицы d. в запросе отложены столбцы, которые присутствуют в primaryjoin, обычно через невключение в load_only(); необходимый столбец(и) не будет присутствовать в подзапросе и создаст некорректный SQL.
References: #3592
Редкий случай, возникающий, когда операция
Session.rollback()
терпит неудачу в области действия операцииSession.flush()
, которая вызывает исключение, как это наблюдалось в некоторых случаях MySQL SAVEPOINT, не позволяет наблюдать исходное исключение базы данных, когда оно было вызвано при флеше, но только на Py2K, поскольку Py2K не поддерживает цепочку исключений; на Py3K вызывающее исключение вызывается цепочкой. В качестве обходного пути в этом конкретном случае выдается предупреждение, показывающее по крайней мере строковое сообщение исходной ошибки базы данных, прежде чем мы перейдем к вызову исключения, вызвавшего откат.References: #2696
orm declarative¶
Исправлена ошибка, из-за которой в Py2K литерал unicode не принимался в качестве строкового имени класса или другого аргумента в декларативных выражениях с использованием
backref()
наrelationship()
. Pull request любезно предоставлен Nils Philippsen.
sql¶
Добавлена поддержка упорядоченных по параметрам клаузул SET в операторе UPDATE. Эта возможность доступна путем передачи флага
update.preserve_parameter_order
либо в основную конструкциюUpdate
, либо добавлением его в словарьQuery.update.update_args
на уровне ORM, также передавая сами параметры в виде списка из двух кортежей. Спасибо Gorka Eguileor за реализацию и тесты.Исправлена проблема в конструкции
Insert.from_select()
, из-за которой в конструкцииSelect
при компиляции конструкции._raw_columns
коллекцияInsert
мутировала на месте, когда целевая конструкцияTable
имела значения по умолчанию на стороне Python. КонструкцияSelect
будет компилироваться отдельно с ошибочным столбцом, присутствующим после компиляцииInsert
, а сам операторInsert
будет неудачным при второй попытке компиляции из-за дублирования связанных параметров.References: #3603
Исправлена ошибка, при которой CREATE TABLE с таблицей без столбцов, но с ограничением, таким как ограничение CHECK, приводила к ошибочной запятой в определении; этот сценарий может произойти, например, с таблицей PostgreSQL INHERITS, которая не имеет собственных столбцов.
References: #3598
postgresql¶
Исправлена проблема, из-за которой модификатор SELECT, специфичный для PostgreSQL «FOR UPDATE OF», не срабатывал, если у ссылающейся таблицы был квалификатор схемы; PG требует, чтобы имя схемы было опущено. Pull request любезно предоставлен Дианой Кларк.
References: #3573
Исправлена ошибка, при которой некоторые разновидности SQL-выражений, переданных в предложение «where» в
ExcludeConstraint
, не принимались корректно. Pull request courtesy aisch.Исправлен атрибут
.python_type
вINTERVAL
, чтобы возвращатьdatetime.timedelta
таким же образом, как и атрибутpython_type
, а не подниматьNotImplementedError
.References: #3571
mysql¶
Исправлена ошибка в отражении MySQL, когда «дробная часть секций» типов
DATETIME
,TIMESTAMP
иTIME
неправильно помещалась в атрибутtimezone
, который не используется MySQL, вместо атрибутаfsp
.References: #3602
mssql¶
Добавлена ошибка «20006: Write to the server failed» в список ошибок разъединения для драйвера pymssql, так как было замечено, что эта ошибка делает соединение непригодным для использования.
References: #3585
В случае, если SQL сервер возвращает неверный формат даты или времени из столбца DATE или TIME, теперь выдается описательная ошибка ValueError, а не ошибка NoneType. Pull request любезно предоставлен Эдом Ависом.
Исправлена проблема, при которой DDL, созданные для типов MSSQL DATETIME2, TIME и DATETIMEOFFSET с точностью «ноль», не генерировали поле точности. Pull request любезно предоставлен Jacobo de Vera.
tests¶
Учебники по ORM и Core, которые всегда были в формате doctest, теперь выполняются в рамках обычного набора модульных тестов как в Python 2, так и в Python 3.
misc¶
В класс
dict.pop()
добавлена поддержка методовdict.popitem()
иMutableDict
.References: #3605
Обновления внутренних вызовов getargspec(), некоторые обновления фикстур, связанные с py36, и изменения в двух итераторах для «возврата» вместо повышения StopIteration, чтобы тесты проходили без ошибок и предупреждений на Py3.5, Py3.6, запросы на pull любезно предоставлены Джейкобом Макдональдом, Лури де Сильвио и Филом Джонсом.
Исправлена проблема в запеченных запросах, когда метод .get(), используемый напрямую или в рамках ленивой загрузки, не учитывал «get clause» маппера как часть ключа кэша, что приводило к несоответствию связанных параметров при повторной генерации clause. Это условие кэшируется картографами на лету, но в сильно параллельных сценариях может генерироваться более одного раза при первом обращении.
References: #3597
1.0.9¶
Released: October 20, 2015orm¶
Добавлен новый метод
Query.one_or_none()
; такой же, какQuery.one()
, но возвращает None, если ряд не найден. Pull request любезно предоставлен esiegerman.Исправлена регрессия в 1.0, когда новая возможность использования «executemany» для операторов UPDATE в ORM (например, UPDATE statements are now batched with executemany() in a flush) ломалась на PostgreSQL и других бэкендах RETURNING при использовании схем генерации версий на стороне сервера, поскольку значение на стороне сервера получалось через RETURNING, который не поддерживается executemany.
References: #3556
Исправлена редкая ошибка TypeError, которая могла возникнуть при строковом определении некоторых типов опций внутреннего загрузчика колонок во внутреннем журнале.
References: #3539
Исправлена ошибка в
Session.bulk_save_objects()
, когда сопоставленный столбец, имеющий какое-то значение «fetch on update» и не присутствующий локально в данном объекте, вызывал ошибку AttributeError в операции.References: #3525
Исправлена регрессия 1.0, когда стратегия загрузчика «noload» не работала для отношений «многие-к-одному». Загрузчик использовал API для помещения «None» в словарь, который больше не записывал значение; это побочный эффект #3061.
References: #3510
examples¶
Исправлены две проблемы в примере «history_meta», когда отслеживание истории могло столкнуться с пустой историей, и когда столбец, ключевой для альтернативного имени атрибута, не отслеживался должным образом. Исправления любезно предоставлены Алексом Фрейзером.
sql¶
Исправлена ошибка в 1.0-релизе default-processor для оператора вставки multi-VALUES, #3288, когда тип столбца для столбца, удерживающего значение по умолчанию, не передавался в скомпилированный оператор в случае, когда использовалось значение по умолчанию, что приводило к тому, что обработчики типов на уровне биндов не вызывались.
References: #3520
postgresql¶
Корректировка новой функции PostgreSQL отражения опций хранения и использования #3455, выпущенной в версии 1.0.6, для отключения функции для версий PostgreSQL < 8.2, где столбец
reloptions
не предоставляется; это позволяет Amazon Redshift снова работать, поскольку он основан на версии PostgreSQL 8.0.x. Исправление любезно предоставлено Питом Холлобоном.
oracle¶
Исправлена поддержка cx_Oracle версии 5.2, из-за которой SQLAlchemy сбивался с определения версии под Python 3 и случайно не использовал правильный режим юникода для Python 3. Это приводило к таким проблемам, как неверная интерпретация связанных переменных как NULL и отсутствие возврата строк.
This change is also backported to: 0.7.0b1
References: #3491
Исправлена ошибка в диалекте Oracle, при которой отражение таблиц и других символов с именами, заключенными в кавычки для принудительного перевода во все строчные регистры, не идентифицировались должным образом в запросах на отражение. Конструкция
quoted_name
теперь применяется к входящим именам символов, которые определяются как принудительно переведенные в нижний регистр в процессе «нормализации имен».References: #3548
misc¶
Добавлен параметр
AssociationProxy.info
в конструкторAssociationProxy
, чтобы соответствовать аксессоруAssociationProxy.info
, который был добавлен в #2971. Это возможно потому, чтоAssociationProxy
конструируется явно, в отличие от гибрида, который конструируется неявно через синтаксис декоратора.References: #3551
Исправлены две проблемы, связанные с отражением Sybase, позволяющие отражать таблицы без первичных ключей, а также гарантирующие, что SQL-оператор, участвующий в определении внешнего ключа, предварительно фетчится, чтобы избежать проблем с драйверами при вложенных запросах. Исправления предоставлены Евгением Запольским; обратите внимание, что в настоящее время мы не можем протестировать Sybase для локальной проверки этих изменений.
1.0.8¶
Released: July 22, 2015engine¶
Исправлена критическая проблема, из-за которой обработчик события «checkout» пула мог быть вызван для устаревшего соединения без вызова обработчика события «connect», в случае, когда пул пытался переподключиться после того, как был аннулирован и потерпел неудачу; устаревшее соединение оставалось в наличии и использовалось при последующих попытках. Эта проблема имеет большее влияние в серии 1.0 после 1.0.2, так как в обработчике событий также передается пустой словарь
.info
; до 1.0.2 словарь.info
остается предыдущим.This change is also backported to: 0.7.0b1
References: #3497
sqlite¶
Исправлена ошибка в диалекте SQLite, при которой отражение ограничений UNIQUE, включающих неалфавитные символы в именах, такие как точки или пробелы, не отражалось с их именем.
This change is also backported to: 0.9.10
References: #3495
misc¶
Исправлена проблема, когда определенный базовый класс в utils не реализовывал
__slots__
, что означало, что все подклассы этого класса также не реализовывали его, отрицая смысл использования__slots__
. Это не вызвало никаких проблем, кроме как на IronPython, который, очевидно, не реализует поведение__slots__
совместимо с cPython.References: #3494
1.0.7¶
Released: July 20, 2015orm¶
Исправлена регрессия 1.0, когда объекты значений, которые переопределяют
__eq__()
для возврата объекта, не поддерживающего булевы значения, например, некоторые типы geoalchemy, а также типы numpy, проверялись наbool()
во время операции обновления единицы работы, тогда как в 0.9 возвращаемое значение__eq__()
проверялось на «is True» для защиты от этого.References: #3469
Исправлена регрессия 1.0, при которой «отложенный» атрибут не заполнялся корректно, если он был загружен в рамках «оптимизированной загрузки наследования», которая представляет собой специальный SELECT, выдаваемый в случае наследования объединенной таблицы, используемый для заполнения просроченных или невыгруженных атрибутов в объединенной таблице без загрузки базовой таблицы. Это связано с тем, что SQLA 1.0 больше не догадывается о загрузке отложенных столбцов, и они должны быть направлены явно.
References: #3468
Исправлена регрессия 1.0, когда «родительская сущность» атрибута, сопоставленного с синонимом, поверх объекта
aliased()
разрешалась в оригинальный маппер, а не в его версиюaliased()
, что создавало проблемы дляQuery
, который полагается на этот атрибут (например, это единственный представительный атрибут, заданный в конструкторе), чтобы определить правильное предложение FROM для запроса.References: #3466
orm declarative¶
Исправлена ошибка в расширении
AbstractConcreteBase
, когда столбец, установленный в базе ABC и имеющий другое имя атрибута по сравнению с именем столбца, неправильно отображался на конечный базовый класс. В версии 0.9 ошибка не проявлялась, тогда как в версии 1.0 она вызывала ошибку ArgumentError, поэтому до версии 1.0 она могла быть не замечена.References: #3480
engine¶
Исправлена регрессия, при которой новые методы на
ResultProxy
, используемые объектом ORMQuery
(часть улучшения производительности #3175), не вызывали исключение «этот результат не возвращает строки» в случае, когда драйвер (обычно MySQL) не может правильно сгенерировать cursor.description; вместо этого возникала ошибка AttributeError против NoneType.References: #3481
Исправлена регрессия, в результате которой
ResultProxy.keys()
возвращало некорректируемые имена внутренних символов для «анонимных» меток, которые являются типами меток «foo_1», которые мы видим сгенерированными для SQL-функций без меток и подобных. Это было побочным эффектом повышения производительности, реализованного в #918.References: #3483
sql¶
Добавлен метод
ColumnElement.cast()
, который выполняет ту же задачу, что и отдельная функцияcast()
. Pull request любезно предоставлен Себастьяном Банком.References: #3459
Исправлена ошибка, при которой принудительное использование литеральной константы
True
илиFalse
в сочетании сand_()
илиor_()
приводило к ошибке AttributeError.References: #3490
Исправлена потенциальная проблема, при которой пользовательский подкласс
FunctionElement
или другой элемент колонки, неверно указывающий „None“ или любой другой недопустимый объект в качестве атрибута.type
, будет сообщать об этом исключении вместо переполнения рекурсии.References: #3485
Исправлена ошибка, при которой оператор modulus SQL не работал в обратном направлении из-за отсутствия метода
__rmod__
. Pull request любезно предоставлен dan-gittik.
schema¶
Добавлена поддержка аргументов MINVALUE, MAXVALUE, NO MINVALUE, NO MAXVALUE и CYCLE для CREATE SEQUENCE, поддерживаемых PostgreSQL и Oracle. Pull request любезно предоставлен jakeogh.
1.0.6¶
Released: June 25, 2015orm¶
Исправлена серьезная регрессия в серии 1.0, когда функция version_id_counter приводила к увеличению счетчика версий объекта, когда в строке объекта не было никаких изменений, но вместо этого объекты, связанные с ним через отношения (например, обычно многие к одному), были ассоциированы или деассоциированы с ним, что приводило к оператору UPDATE, который обновлял счетчик версий объекта и ничего больше. В случае использования относительно недавней функции счетчика версий «на стороне сервера» и/или «программно/условно» (например, установка значения version_id_generator в False), ошибка могла привести к тому, что UPDATE без корректного предложения SET будет выдан.
References: #3465
Исправлена регрессия 1.0, при которой улучшенное поведение однонаследственных объединений #3222 происходит неадекватно для JOIN по явным критериям объединения с однонаследственным подклассом, который не использует никакого дискриминатора, что приводит к дополнительному предложению «AND NULL».
References: #3462
Исправлена ошибка в новой функции
Session.bulk_update_mappings()
, когда столбцы первичного ключа, используемые в предложении WHERE для нахождения строки, также включались в предложение SET, устанавливая их значение в себя без необходимости. Pull request любезно предоставлен Патриком Хейсом.References: #3451
Исправлена регрессия непредвиденного использования, в результате которой пользовательские объекты
Comparator
, которые использовали метод__clause_element__()
и возвращали объект, который был ORM-mappedInstrumentedAttribute
, а не явноColumnElement
, не обрабатывались корректно при передаче в качестве выражения вSession.query()
. Логика в 0.9 оказалась успешной, так что теперь этот вариант использования поддерживается.References: #3448
sql¶
Исправлена ошибка, при которой адаптация клаузулы, применяемая к объекту
Label
, не могла вместить помеченное выражение SQL во всех случаях, так что любая операция SQL, использующаяLabel.self_group()
, использовала бы исходное неадаптированное выражение. Одним из последствий этого может быть то, что конструкция ORMaliased()
будет не полностью вмещать атрибуты, отображаемыеcolumn_property
, так что при использовании свойства в некоторых видах SQL-сравнений может произойти утечка неадаптированной таблицы.References: #3445
postgresql¶
Добавлена поддержка параметров хранения в CREATE INDEX, используя новый аргумент ключевого слова
postgresql_with
. Также добавлена поддержка отражения для поддержки как флагаpostgresql_with
, так и флагаpostgresql_using
, которые теперь будут устанавливаться на отражаемых объектахIndex
, а также присутствовать в новом словаре «dialect_options» в результате работыInspector.get_indexes()
. Pull request любезно предоставлен Питом Холлобоном.См.также
postgresql_index_storage
References: #3455
Добавлена новая опция выполнения
max_row_buffer
, которая интерпретируется диалектом psycopg2 при использовании опцииstream_results
, устанавливающей ограничение на размер буфера строк, который может быть выделен. Это значение также предоставляется на основе целочисленного значения, переданного вQuery.yield_per()
. Pull request courtesy mcclurem.Исправили эту проблему, впервые выпущенную в версии 1.0.5, чтобы снова исправить поддержку psycopg2cffi JSONB, так как они внезапно включили безусловное декодирование типов JSONB в версии 2.7.1. Обнаружение версии теперь указывает на 2.7.1, где мы должны ожидать, что DBAPI будет выполнять кодирование json для нас.
References: #3439
Исправлена конструкция
ExcludeConstraint
для поддержки общих возможностей, которые теперь есть у других объектов, таких какIndex
, что выражение столбца может быть указано как произвольное выражение SQL, такое какcast
илиtext
.References: #3454
mssql¶
Исправлена проблема при использовании типа
VARBINARY
в сочетании с INSERT из NULL + pyodbc; pyodbc требует передачи специального объекта для сохранения NULL. Поскольку типVARBINARY
теперь обычно используется по умолчанию дляLargeBinary
из-за #3039, эта проблема частично является регрессией в версии 1.0. Драйвер pymssql, похоже, не затронут.References: #3464
misc¶
Исправлена внутренняя процедура «мемоизации» для типов методов так, что дескриптор Python больше не используется; исправлена проверяемость этих методов, включая поддержку документации Sphinx.
References: #2077
1.0.5¶
Released: June 7, 2015orm¶
Добавлено новое событие
InstanceEvents.refresh_flush()
, вызываемое, когда значение по умолчанию уровня INSERT или UPDATE, полученное через RETURNING или Python-side default, вызывается в процессе flush. Это сделано для обеспечения крючка, который больше не присутствует в результате #3167, когда события атрибутов и валидации больше не вызываются в процессе flush.References: #3427
Облегченный именованный кортеж», используемый, когда
Query
возвращает строки, не смог правильно реализовать__slots__
, так что у него все еще был__dict__
. Это решено, но в крайне маловероятном случае, если кто-то присваивал значения возвращаемым кортежам, это больше не будет работать.References: #3420
engine¶
Добавлено новое событие двигателя
ConnectionEvents.engine_disposed()
. Вызывается после вызова методаEngine.dispose()
.Внесены изменения в хук плагина движка, в результате которых метод
URL.get_dialect()
будет продолжать возвращать конечный объектDialect
, когда используется плагин диалекта, без необходимости, чтобы вызывающая сторона знала о методеDialect.get_dialect_cls()
.References: #3379
Исправлена ошибка, при которой известные булевы значения, используемые
engine_from_config()
, разбирались неправильно; к ним относилисьpool_threadlocal
и аргумент psycopg2use_native_unicode
.References: #3435
Добавлена поддержка для случая, когда неправильный DBAPI имеет имена исключений pep-249, связанные с классами исключений с совершенно другими именами, что не позволяет SQLAlchemy обернуть ошибку соответствующим образом. Используемый диалект SQLAlchemy должен реализовать новый аксессор
DefaultDialect.dbapi_exception_translation_map
для поддержки этой возможности; сейчас это реализовано для диалекта py-postgresql.References: #3421
Исправлена ошибка, связанная с тем, что при использовании обработчиков событий проверки пула и попытках подключения в самом обработчике, которые заканчивались неудачей, собственная запись о подключении не освобождалась до тех пор, пока не освобождался стек-трейс самой ошибки подключения. Для случая, когда используется тестовый пул, состоящий только из одного соединения, это означает, что пул будет полностью проверен до тех пор, пока не будет освобожден стек-трассировка этого соединения. Это в основном влияет на очень специфические сценарии отладки и вряд ли будет заметно в каком-либо производственном приложении. Исправление применяет явную проверку записи перед повторным вызовом пойманного исключения.
References: #3419
sql¶
Добавлена официальная поддержка для CTE, используемого SELECT, присутствующего внутри
Insert.from_select()
. Такое поведение случайно работало до версии 0.9.9, когда оно перестало работать из-за несвязанных изменений в составе #3248. Обратите внимание, что это отображение условия WITH после INSERT, перед SELECT; полная функциональность CTE, отображаемых на верхнем уровне INSERT, UPDATE, DELETE - это новая функция, предназначенная для более позднего выпуска.This change is also backported to: 0.9.10
References: #3418
postgresql¶
Исправлены некоторые проблемы с типизацией и тестированием, связанные с диалектом pypy psycopg2cffi, в частности то, что текущая версия 2.7.0 не имеет встроенной поддержки типа JSONB. Определение версии для функций psycopg2 было настроено на конкретную подверсию для psycopg2cffi. Кроме того, было включено покрытие тестами всей серии функций psycopg2 под psycopg2cffi.
References: #3439
mssql¶
Добавлен новый флаг диалекта MSSQL
legacy_schema_aliasing
, который при установке в False отключает очень старое и устаревшее поведение, заключающееся в попытке компилятора превратить все имена таблиц с квалификацией схемы в имена псевдонимов, чтобы решить старые и более не локализуемые проблемы, когда SQL сервер не мог разобрать многокомпонентное имя идентификатора при любых обстоятельствах. Такое поведение препятствовало корректной работе более сложных операторов, включая те, которые используют подсказки, а также CRUD-операторов, в которые встроены коррелирующие операторы SELECT. Вместо того чтобы продолжать исправлять эту функцию для работы с более сложными операторами, лучше просто отключить ее, поскольку она больше не нужна ни для одной современной версии SQL-сервера. Флаг по умолчанию имеет значение True для серии 1.0.x, оставляя текущее поведение неизменным для этой серии версий. В серии 1.1 по умолчанию будет установлено значение False. Для серии 1.0, если ни одно из значений не установлено явно, при первом использовании в операторе таблицы с выравниванием по схеме выдается предупреждение, что предполагает установку флага в False для всех современных версий SQL Server.См.также
legacy_schema_rendering
misc¶
Добавлена поддержка передачи
*args
в начальную вызываемую переменную запроса baked, так же, как*args
поддерживаются для методовBakedQuery.add_criteria()
иBakedQuery.with_criteria()
. Первоначальный PR любезно предоставлен Naoki INADA.Добавлен новый полупубличный метод в
MutableBase
MutableBase._get_listen_keys()
. Переопределение этого метода необходимо в том случае, если подклассуMutableBase
нужно, чтобы при перехвате событийInstanceEvents.refresh()
илиInstanceEvents.refresh_flush()
распространялись события для ключей атрибутов, отличных от ключа, с которым связан изменяемый тип. Текущим примером этого являются композиты, использующиеMutableComposite
.References: #3427
Исправлена регрессия в расширении
sqlalchemy.ext.mutable
в результате исправления ошибки #3167, когда события атрибутов и валидации больше не вызываются в процессе смыва. Расширение mutable полагалось на такое поведение в случае, когда за генерацию нового значения при INSERT или UPDATE отвечал Python на уровне столбца, или когда значение извлекалось из условия RETURNING для режима «eager defaults». Новое значение не будет подвержено никакому событию при заполнении, и изменяемое расширение не сможет установить надлежащее принуждение или прослушивание истории. Добавлено новое событиеInstanceEvents.refresh_flush()
, которое теперь используется расширяемым расширением для этого случая.References: #3427
1.0.4¶
Released: May 7, 2015orm¶
Исправлена регрессия непредвиденного использования, когда в странном случае, когда первичное соединение отношения включало сравнение с нехешируемым типом, таким как HSTORE, ленивая загрузка не выполнялась из-за хеш-ориентированной проверки параметров оператора. В версии 1.0 в результате #3061 было изменено для использования хеширования, а в версии #3368 - для случаев, более распространенных, чем «load on pending». Теперь значения предварительно проверяются на наличие атрибута
__hash__
.References: #3416
Либерализовано утверждение, которое было добавлено как часть #3347 для защиты от неизвестных условий при сращивании внутренних объединений внутри объединенных нетерпеливых загрузок с
innerjoin=True
; если некоторые из объединений используют «вторичную» таблицу, утверждение должно развернуть дальнейшие объединения, чтобы пройти.Исправлено / добавлено в тесты еще больше выражений, которые были признаны неудачными с новым значением ключа „entity“, добавленным в
Query.column_descriptions
, логика обнаружения выражения «from» снова переработана для учета столбцов из aliased классов, а также для сообщения правильного значения флага «aliased» в этих случаях.
schema¶
Исправлена ошибка в улучшенной логике присоединения ограничений, введенной в #3341, когда в необычном случае ограничения, ссылающегося на смесь объектов
Column
и строковых имен столбцов одновременно, логика автоматического присоединения по столбцам будет пропущена; чтобы ограничение было автоматически присоединено в этом случае, все столбцы должны быть собраны в целевой таблице заранее. В документ по миграции добавлен новый раздел, касающийся первоначальной функции, а также данного изменения.References: #3411
tests¶
Исправлен импорт, из-за которого «pypy setup.py test» не работал корректно.
This change is also backported to: 0.9.10
References: #3406
misc¶
Исправлена ошибка, из-за которой при использовании расширенной системы инструментации атрибутов не возникало корректное исключение, когда
class_mapper()
вызывались с недопустимым входом, который также не был слабо ссылаемым, например, целым числом.This change is also backported to: 0.9.10
References: #3408
1.0.3¶
Released: April 30, 2015orm¶
Исправлена регрессия из 0.9.10 до релиза, связанная с #3349, когда проверка состояния запроса на
Query.update()
илиQuery.delete()
сравнивала пустой кортеж с самим собой, используяis
, что на PyPy не давало результатаTrue
в этом случае; это ошибочно выдавало предупреждение в 0.9 и вызывало исключение в 1.0.References: #3405
Исправлена регрессия в версии 0.9.10 до релиза, когда новое добавление
entity
к аксессоруQuery.column_descriptions
приводило к ошибке, если целевая сущность создавалась из core selectable, такого как объектTable
илиCTE
.Исправлена регрессия в процессе промывки, когда атрибут устанавливался в SQL выражение для UPDATE, и SQL выражение при сравнении с предыдущим значением атрибута давало SQL сравнение, отличное от
==
или!=
, возникало исключение «Boolean value of this clause is not defined». Исправление гарантирует, что блок работы не будет интерпретировать SQL-выражение таким образом.References: #3402
Исправлена неожиданная регрессия использования #2992, когда текстовые элементы, помещенные в предложение
Query.order_by()
в сочетании с объединенной ускоренной загрузкой, добавлялись в предложение columns внутреннего запроса таким образом, что они принимались за имена столбцов, привязанных к таблице, в случае, когда объединенная ускоренная загрузка должна обернуть запрос в подзапрос для учета ограничения/смещения.Первоначально такое поведение было намеренным, поскольку запрос типа
query(User).order_by('name').limit(1)
будет упорядочиваться поuser.name
, даже если запрос был изменен с помощью присоединенной ускоренной загрузки, чтобы оказаться внутри подзапроса, поскольку'name'
будет интерпретирован как символ, который должен быть расположен в клаузе FROM, в данном случаеUser.name
, который затем будет скопирован в клаузулу columns, чтобы обеспечить его присутствие для ORDER BY. Однако эта функция не может предусмотреть случай, когдаorder_by("name")
ссылается на конкретное имя метки, присутствующее в локальном предложении columns, а не на имя, связанное с selectable в предложении FROM.Кроме того, функция также не справляется с устаревшими случаями, такими как
order_by("name desc")
, которые, хотя и выдают предупреждение о том, что здесь следует использоватьtext()
(обратите внимание, что проблема не затрагивает случаи, когдаtext()
используется явно), все же выдают запрос, отличный от предыдущего, где выражение «name desc» копируется в предложение columns неподобающим образом. Решение проблемы заключается в том, что аспект функции «объединенная ускоренная загрузка» будет пропускать эти так называемые выражения «ссылка на метку» при дополнении внутреннего предложения columns, как если бы они уже были конструкциямиtext()
.References: #3392
Исправлена регрессия, касающаяся события
MapperEvents.instrument_class()
, когда его вызов был перенесен на время после инструментации класса менеджером класса, что противоположно тому, что явно указано в документации к событию. Обоснованием для такого перехода послужило то, что Declarative предпринял шаг установки полного «менеджера инструментария» для класса до его отображения для целей новых возможностей@declared_attr
, описанных в Improvements to declarative mixins, @declared_attr and related features, но изменение также было сделано вопреки классическому использованиюmapper()
для согласованности. Однако SQLSoup полагается на то, что событие инструментации произойдет до любой инструментации при классическом отображении. Поведение возвращено в случае классического и декларативного отображения, последнее реализовано с помощью простой мемоизации без использования менеджера классов.References: #3388
Исправлена проблема в событии new
QueryEvents.before_compile()
, когда изменения, внесенные в коллекцию сущностей объектаQuery
для загрузки в рамках события, отображались в SQL, но не отражались в процессе загрузки.References: #3387
engine¶
Добавлены новые функции для поддержки плагинов движка/пула с расширенной функциональностью. Добавлена новая функция «мягкого аннулирования» в пул соединений на уровне обертки проверяемого соединения, а также
_ConnectionRecord
. Это работает аналогично современному аннулированию пула в том смысле, что соединения не закрываются активно, а утилизируются только при следующей проверке; по сути, это версия этой функции для каждого соединения. В дополнение к этому добавлено новое событиеPoolEvents.soft_invalidate()
.Также добавлен новый флаг
ExceptionContext.invalidate_pool_on_disconnect
. Позволяет обработчику ошибок вConnectionEvents.handle_error()
поддерживать состояние «разъединения», но обрабатывать вызов invalidate на отдельных соединениях определенным образом внутри события.References: #3379
Добавлено новое событие
do_connect
, которое позволяет перехватить/заменить момент вызова хукаDialect.connect()
для создания DBAPI-соединения. Также добавлены хуки плагинов диалектовDialect.get_dialect_cls()
иDialect.engine_created()
, которые позволяют внешним плагинам добавлять события к существующим диалектам, используя точки входа.References: #3355
sql¶
Добавлен метод-заполнитель
TypeEngine.compare_against_backend()
, который теперь используется миграциями Alembic начиная с версии 0.7.6. Определяемые пользователем типы могут реализовать этот метод, чтобы помочь в сравнении типа с типом, отраженным из базы данных.Исправлена ошибка, при которой усечение длинных меток в SQL могло привести к появлению метки, перекрывающей другую метку, которая не усекалась; это происходило потому, что порог длины для усечения был больше, чем часть метки, которая остается после усечения. Теперь эти два значения стали одинаковыми; label_length - 6. Эффект заключается в том, что более короткие метки столбцов будут «усечены» там, где раньше они не были бы усечены.
References: #3396
Исправлена регрессия, связанная с #3282, когда коллекция
tables
, переданная в качестве аргумента ключевого слова в событияхDDLEvents.before_create()
,DDLEvents.after_create()
,DDLEvents.before_drop()
иDDLEvents.after_drop()
, больше не была списком таблиц, а вместо этого была списком кортежей, содержащим вторую запись с внешними ключами, которые нужно добавить или удалить. Поскольку коллекцияtables
, хотя и задокументирована как не всегда стабильная, на нее стали полагаться, это изменение считается регрессией. Кроме того, в некоторых случаях для «drop» эта коллекция была итератором, который при преждевременной итерации приводил к сбою операции. Теперь коллекция представляет собой список объектов таблицы во всех случаях, и теперь добавлено тестовое покрытие для формата этой коллекции.References: #3391
misc¶
Исправлена ошибка в ассоциативном прокси, когда сравнение any()/has() для атрибута relationship->scalar, не являющегося объектом, не выполнялось, например,
filter(Parent.some_collection_to_attribute.any(Child.attr == 'foo'))
.References: #3397
1.0.2¶
Released: April 24, 2015orm declarative¶
Исправлена неожиданная регрессия использования декларативных аксессоров
__declare_first__
и__declare_last__
, когда они больше не вызывались на суперклассе декларативной базы.References: #3383
sql¶
Исправлена регрессия, которая была неправильно исправлена в версии 1.0.0b4 (поэтому она стала двумя регрессиями); сообщения о том, что операторы SELECT могли группировать по имени метки и терпеть неудачу, были неверно истолкованы, что некоторые бэкенды, такие как SQL Server, вообще не должны выдавать ORDER BY или GROUP BY по простому имени метки; на самом деле, мы забыли, что 0. 9 уже выдавал ORDER BY на простое имя метки для всех бэкендов, как описано в Конструкции меток теперь могут отображаться только в виде своего имени в ORDER BY, хотя 1.0 включает переписывание этой логики как часть #2992. Что касается эмиссии GROUP BY по простой метке, то даже в PostgreSQL есть случаи, когда он выдает ошибку, даже если метка для группировки должна быть очевидной, поэтому ясно, что GROUP BY никогда не должна отображаться таким образом автоматически.
В версии 1.0.2 SQL Server, Firebird и другие бэкенды снова будут выдавать ORDER BY для простого имени метки при передаче конструкции
Label
, которая также присутствует в предложении columns. Кроме того, ни один бэкенд не будет выдавать GROUP BY на имя простой метки только при передаче конструкцииLabel
.
1.0.1¶
Released: April 23, 2015orm¶
Исправлена проблема, при которой запрос вида
query(B).filter(B.a != A(id=7))
выдавал символNEVER_SET
, если задавался переходный объект. Для постоянного объекта всегда использовалось сохраняемое значение базы данных, а не текущее установленное значение. Если предположить, что включена функция autoflush, это обычно не будет заметно для постоянных значений, так как любые ожидающие изменения будут удалены первыми в любом случае. Однако это противоречит логике, используемой для неотрицательного сравненияquery(B).filter(B.a == A(id=7))
, которое использует текущее значение и дополнительно позволяет сравнивать с переходными объектами. Теперь при сравнении используется текущее значение, а не значение, хранящееся в базе данных.В отличие от других проблем
NEVER_SET
, которые в этом выпуске исправлены как регрессии, вызванные #3061, эта конкретная проблема присутствует как минимум в версии 0.8, а возможно и раньше, однако она была обнаружена в результате исправления связанных с ней проблемNEVER_SET
.References: #3374
Исправлена неожиданная регрессия использования, вызванная #3061, когда символ NEVER_SET мог просочиться в запросы, ориентированные на отношения, включая запросы
filter()
иwith_parent()
. СимволNone
возвращается во всех случаях, однако многие из этих запросов никогда не поддерживались корректно в любом случае, и производят сравнения с NULL без использования оператора IS. По этой причине предупреждение также добавляется к тому подмножеству запросов отношений, которые в настоящее время не предусматриваютIS NULL
.References: #3371
Исправлена регрессия, вызванная #3061, когда символ NEVER_SET мог просочиться в запрос lazyload, после того как произошла очистка отложенного объекта. Обычно это происходило в отношениях «многие-к-одному», которые не используют простую стратегию «get». Хорошей новостью является то, что исправление повышает эффективность по сравнению с 0.9, поскольку теперь мы можем полностью пропустить оператор SELECT при обнаружении символов NEVER_SET в параметрах; до #3061 мы не могли определить, установлен ли здесь символ None или нет.
References: #3368
engine¶
Добавлено строковое значение
"none"
к тем, которые принимаются параметромPool.reset_on_return
в качестве синонима дляNone
, так что строковые значения могут использоваться для всех настроек, что позволяет утилитам типаengine_from_config()
использовать их без проблем.This change is also backported to: 0.9.10
References: #3375
sql¶
Исправлена проблема, при которой прямой запрос SELECT EXISTS не мог присвоить правильный тип результата Boolean отображению результата, и вместо этого в карту результата просачивались типы столбцов из запроса. Эта проблема существует также в 0.9 и более ранних версиях, однако в этих версиях она имеет меньшее влияние. В версии 1.0, благодаря #918, это становится регрессией, поскольку теперь мы полагаемся на то, что отображение результатов будет очень точным, иначе мы можем назначить процессоры типа результата неправильному столбцу. Во всех версиях эта проблема также приводит к тому, что простой EXISTS не применяет обработчик типа Boolean, что приводит к простым значениям 1/0 для бэкендов без встроенных boolean вместо True/False. Исправление заключается в том, что аргумент колонки EXISTS будет помечен аноном, как и другие выражения колонок; аналогичное исправление реализовано для чисто булевых выражений типа
not_(True())
.References: #3372
sqlite¶
Исправлена регрессия, связанная с #3282, когда из-за того, что мы пытаемся предположить наличие ALTER при создании/удалении схем, в случае SQLite мы просто говорили не беспокоиться о внешних ключах вообще, поскольку ALTER недоступен, при создании и удалении таблиц. Это означает, что сортировка таблиц в случае SQLite была практически пропущена, и для подавляющего большинства случаев использования SQLite это не является проблемой.
Однако пользователи, выполняющие DROP на SQLite с таблицами, содержащими данные и с включенной ссылочной целостностью, будут сталкиваться с ошибками, поскольку сортировка зависимостей имеет значение в случае DROP с принудительными ограничениями, когда в этих таблицах есть данные (SQLite все еще с радостью позволит вам создавать внешние ключи к несуществующим таблицам и сбрасывать таблицы, ссылающиеся на существующие таблицы с включенными ограничениями, пока нет данных, на которые ссылаются).
Чтобы сохранить новую возможность #3282 и при этом позволить операции SQLite DROP поддерживать упорядоченность, мы теперь выполняем сортировку с учетом полных FK, и если мы встречаем неразрешимый цикл, только тогда мы отказываемся от попытки сортировки таблиц; вместо этого мы выдаем предупреждение и переходим к несортированному списку. Если среда нуждается в упорядоченных DROP и имеет циклы внешних ключей, то в предупреждении отмечается, что им нужно восстановить флаг
use_alter
для своих объектовForeignKey
иForeignKeyConstraint
, чтобы только эти объекты были опущены из сортировки зависимостей.См.также
The use_alter flag on ForeignKeyConstraint is (usually) no longer needed - содержит обновленную заметку о SQLite.
References: #3378
firebird¶
Исправлена регрессия, связанная с #3034, когда предложения ограничения/смещения неправильно интерпретировались диалектом Firebird. Pull request любезно предоставлен effem-git.
References: #3380
Исправлена поддержка режима «literal_binds» при использовании limit/offset с Firebird, так что значения снова отображаются в строку при выборе этого режима. Связано с #3034.
References: #3381
1.0.0¶
Released: April 16, 2015orm¶
Добавлен новый аргумент
Query.update.update_args
, который позволяет передавать kw-аргументы, такие какmysql_limit
, в базовую конструкциюUpdate
. Pull request любезно предоставлен Амиром Садофи.Выявлено несоответствие при обработке
Query.join()
к одной и той же цели более одного раза; неявное вычитание происходит только в случае соединения отношений, а благодаря #3233 в версии 1.0 соединение с одной и той же таблицей дважды ведет себя иначе, чем в версии 0.9, поскольку оно больше не является ошибочным псевдонимом. Чтобы помочь документировать это изменение, формулировка относительно #3233 в примечаниях к миграции была обобщена, и было добавлено предупреждение, когдаQuery.join()
вызывается против одного и того же целевого отношения более одного раза.References: #3367
Внесено небольшое улучшение в эвристику отношений при определении удаленной стороны с полусамостоятельными (например, два объединенных подкласса inh ссылаются друг на друга), не простыми условиями присоединения, так что parententity учитывается и может уменьшить необходимость использования аннотации
remote()
; это может восстановить некоторые случаи, которые могли работать без аннотации до 0.9.4 через #2948.References: #3364
sql¶
Топологическая сортировка, используемая для сортировки объектов
Table
и доступная через коллекциюMetaData.sorted_tables
, теперь будет производить детерминированное упорядочивание; то есть, одинаковое упорядочивание каждый раз при задании набора таблиц с определенными именами и зависимостями. Это поможет при сравнении DDL-скриптов и в других случаях. Таблицы отправляются в топологическую сортировку отсортированными по именам, а сама топологическая сортировка будет обрабатывать входящие данные в упорядоченном виде. Pull request любезно предоставлен Себастьяном Банком.References: #3084
Исправлена проблема, при которой объект
MetaData
, использующий соглашение об именовании, не мог корректно работать с pickle. Атрибут пропускался, что приводило к несоответствиям и сбоям, если непикированный объектMetaData
использовался для создания дополнительных таблиц.This change is also backported to: 0.9.10
References: #3362
postgresql¶
Исправлена давняя ошибка, когда тип
Enum
, используемый с диалектом psycopg2 в сочетании с неаскриптивными значениями иnative_enum=False
, не мог правильно декодировать результаты возврата. Это происходило из-за того, что тип PGENUM
раньше был отдельным типом без опции «non native».This change is also backported to: 0.9.10
References: #3354
mssql¶
Исправлена регрессия, при которой механика «last inserted id» не сохраняла правильное значение для MSSQL при INSERT, когда значение первичного ключа присутствовало в параметрах вставки перед выполнением, а также в случае, когда INSERT из SELECT указывал целевые столбцы как объекты столбцов, а не как строковые ключи.
References: #3360
Использование конструктора
Binary
, который теперь присутствует в pymssql, вместо его исправления. Pull request любезно предоставлен Рамиро Моралесом.
tests¶
Исправлен путь, используемый при запуске тестов; для sqla_nose.py и py.test префикс «./lib» снова вставляется в начало sys.path, но только если sys.flags.no_user_site не установлен; это делает его похожим на то, как Python по умолчанию помещает «.» в текущий путь. Для tox мы теперь устанавливаем флаг PYTHONNOUSERSITE.
References: #3356
1.0.0b5¶
Released: April 3, 2015orm¶
Исправлена ошибка, при которой отслеживание состояния в нескольких вложенных операциях
Session.begin_nested()
не распространяло флаг «dirty» для объекта, который был обновлен во внутренней точке сохранения, в результате чего при откате внутренней точки сохранения объект не был частью состояния, которое истекло, и поэтому возвращался к своему состоянию базы данных.This change is also backported to: 0.9.10
References: #3352
Query
не поддерживает объединения, подвыборы или специальные предложения FROM при использовании методовQuery.update()
илиQuery.delete()
; вместо молчаливого игнорирования этих полей, если были вызваны методы типаQuery.join()
илиQuery.select_from()
, выдается ошибка. В версии 0.9.10 при этом выдается только предупреждение.References: #3349
Добавлен вызов list() вокруг слабого словаря, используемого в фазе фиксации сессии, который без него мог вызвать ошибку «dictionary changed size during iter», если сборка мусора взаимодействовала в процессе. Изменение было внесено в #3139.
Fixed a bug related to «nested» inner join eager loading, which exists in 0.9 as well but is more of a regression in 1.0 due to #3008 which turns on «nested» by default, such that a joined eager load that travels across sibling paths from a common ancestor using innerjoin=True will correctly splice each «innerjoin» sibling into the appropriate part of the join, when a series of inner/outer joins are mixed together.
References: #3347
sql¶
The warning emitted by the unicode type for a non-unicode type has been liberalized to warn for values that aren’t even string values, such as integers; previously, the updated warning system of 1.0 made use of string formatting operations which would raise an internal TypeError. While these cases should ideally raise totally, some backends like SQLite and MySQL do accept them and are potentially in use by legacy code, not to mention that they will always pass through if unicode conversion is turned off for the target backend.
References: #3346
postgresql¶
1.0.0b4¶
Released: March 29, 2015sql¶
Fixed bug in new «label resolution» feature of #2992 where a label that was anonymous, then labeled again with a name, would fail to be locatable via a textual label. This situation occurs naturally when a mapped
column_property()
is given an explicit label in a query.References: #3340
Fixed bug in new «label resolution» feature of #2992 where the string label placed in the order_by() or group_by() of a statement would place higher priority on the name as found inside the FROM clause instead of a more locally available name inside the columns clause.
References: #3335
schema¶
The «auto-attach» feature of constraints such as
UniqueConstraint
andCheckConstraint
has been further enhanced such that when the constraint is associated with non-table-boundColumn
objects, the constraint will set up event listeners with the columns themselves such that the constraint auto attaches at the same time the columns are associated with the table. This in particular helps in some edge cases in declarative but is also of general use.References: #3341
mysql¶
Fixed unicode support for PyMySQL when using an «executemany» operation with unicode parameters. SQLAlchemy now passes both the statement as well as the bound parameters as unicode objects, as PyMySQL generally uses string interpolation internally to produce the final statement, and in the case of executemany does the «encode» step only on the final statement.
This change is also backported to: 0.9.10
References: #3337
mssql¶
Turned off the «simple order by» flag on the MSSQL, Oracle dialects; this is the flag that per #2992 causes an order by or group by an expression that’s also in the columns clause to be copied by label, even if referenced as the expression object. The behavior for MSSQL is now the old behavior that copies the whole expression in by default, as MSSQL can be picky on these particularly in GROUP BY expressions. The flag is also turned off defensively for the Firebird and Sybase dialects.
Примечание
this resolution was incorrect, please see version 1.0.2 for a rework of this resolution.
References: #3338
1.0.0b3¶
Released: March 20, 2015mysql¶
Repaired the commit for issue #2771 which was inadvertently commented out.
References: #2771
1.0.0b2¶
Released: March 20, 2015orm¶
Fixed unexpected use regression from pullreq github:137 where Py2K unicode literals (e.g.
u""
) would not be accepted by therelationship.cascade
option. Pull request courtesy Julien Castets.References: #3327
orm declarative¶
Loosened some restrictions that were added to
@declared_attr
objects, such that they were prevented from being called outside of the declarative process; this is related to the enhancements of #3150 which allow@declared_attr
to return a value that is cached based on the current class as it’s being configured. The exception raise has been removed, and the behavior changed so that outside of the declarative process, the function decorated by@declared_attr
is called every time just like a regular@property
, without using any caching, as none is available at this stage.References: #3331
engine¶
The «auto close» for
ResultProxy
is now a «soft» close. That is, after exhausting all rows using the fetch methods, the DBAPI cursor is released as before and the object may be safely discarded, but the fetch methods may continue to be called for which they will return an end-of-result object (None for fetchone, empty list for fetchmany and fetchall). Only ifResultProxy.close()
is called explicitly will these methods raise the «result is closed» error.
mysql¶
Fixed the
BIT
type on Py3K which was not using theord()
function correctly. Pull request courtesy David Marin.This change is also backported to: 0.9.10
References: #3333
Fixes to fully support using the
'utf8mb4'
MySQL-specific charset with MySQL dialects, in particular MySQL-Python and PyMySQL. In addition, MySQL databases that report more unusual charsets such as „koi8u“ or „eucjpms“ will also work correctly. Pull request courtesy Thomas Grainger.References: #2771
1.0.0b1¶
Released: March 13, 2015Version 1.0.0b1 is the first release of the 1.0 series. Many changes described here are also present in the 0.9 and sometimes the 0.8 series as well. For changes that are specific to 1.0 with an emphasis on compatibility concerns, see What’s New in SQLAlchemy 1.0?.
general¶
Structural memory use has been improved via much more significant use of
__slots__
for many internal objects. This optimization is particularly geared towards the base memory size of large applications that have lots of tables and columns, and greatly reduces memory size for a variety of high-volume objects including event listening internals, comparator objects and parts of the ORM attribute and loader strategy system.The
__module__
attribute is now set for all those SQL and ORM functions that are derived as «public factory» symbols, which should assist with documentation tools being able to report on the target module.References: #3218
orm¶
Added a new entry
"entity"
to the dictionaries returned byQuery.column_descriptions
. This refers to the primary ORM mapped class or aliased class that is referred to by the expression. Compared to the existing entry for"type"
, it will always be a mapped entity, even if extracted from a column expression, or None if the given expression is a pure core expression. See also #3403 which repaired a regression in this feature which was unreleased in 0.9.10 but was released in the 1.0 version.This change is also backported to: 0.9.10
References: #3320
Added new parameter
Session.connection.execution_options
which may be used to set up execution options on aConnection
when it is first checked out, before the transaction has begun. This is used to set up options such as isolation level on the connection before the transaction starts.См.также
Настройка уровней изоляции транзакций / DBAPI AUTOCOMMIT - new documentation section detailing best practices for setting transaction isolation with sessions.
This change is also backported to: 0.9.9
References: #3296
Added new method
Session.invalidate()
, functions similarly toSession.close()
, except also callsConnection.invalidate()
on all connections, guaranteeing that they will not be returned to the connection pool. This is useful in situations e.g. dealing with gevent timeouts when it is not safe to use the connection further, even for rollbacks.This change is also backported to: 0.9.9
The «primaryjoin» model has been stretched a bit further to allow a join condition that is strictly from a single column to itself, translated through some kind of SQL function or expression. This is kind of experimental, but the first proof of concept is a «materialized path» join condition where a path string is compared to itself using «like». The
ColumnOperators.like()
operator has also been added to the list of valid operators to use in a primaryjoin condition.This change is also backported to: 0.9.5
References: #3029
Added new utility function
make_transient_to_detached()
which can be used to manufacture objects that behave as though they were loaded from a session, then detached. Attributes that aren’t present are marked as expired, and the object can be added to a Session where it will act like a persistent one.This change is also backported to: 0.9.5
References: #3017
Added a new event suite
QueryEvents
. TheQueryEvents.before_compile()
event allows the creation of functions which may place additional modifications toQuery
objects before the construction of the SELECT statement. It is hoped that this event be made much more useful via the advent of a new inspection system that will allow for detailed modifications to be made againstQuery
objects in an automated fashion.См.также
QueryEvents
References: #3317
The subquery wrapping which occurs when joined eager loading is used with a one-to-many query that also features LIMIT, OFFSET, or DISTINCT has been disabled in the case of a one-to-one relationship, that is a one-to-many with
relationship.uselist
set to False. This will produce more efficient queries in these cases.References: #3249
Mapped state internals have been reworked to allow for a 50% reduction in callcounts specific to the «expiration» of objects, as in the «auto expire» feature of
Session.commit()
and forSession.expire_all()
, as well as in the «cleanup» step which occurs when object states are garbage collected.References: #3307
A warning is emitted when the same polymorphic identity is assigned to two different mappers in the same hierarchy. This is typically a user error and means that the two different mapping types cannot be correctly distinguished at load time. Pull request courtesy Sebastian Bank.
References: #3262
A new series of
Session
methods which provide hooks directly into the unit of work’s facility for emitting INSERT and UPDATE statements has been created. When used correctly, this expert-oriented system can allow ORM-mappings to be used to generate bulk insert and update statements batched into executemany groups, allowing the statements to proceed at speeds that rival direct use of the Core.См.также
References: #3100
Added a parameter
Query.join.isouter
which is synonymous with callingQuery.outerjoin()
; this flag is to provide a more consistent interface compared to CoreFromClause.join()
. Pull request courtesy Jonathan Vanasco.References: #3217
Added new event handlers
AttributeEvents.init_collection()
andAttributeEvents.dispose_collection()
, which track when a collection is first associated with an instance and when it is replaced. These handlers supersede thecollection.linker()
annotation. The old hook remains supported through an event adapter.The
Query
will raise an exception whenQuery.yield_per()
is used with mappings or options where either subquery eager loading, or joined eager loading with collections, would take place. These loading strategies are not currently compatible with yield_per, so by raising this error, the method is safer to use. Eager loads can be disabled with thelazyload('*')
option orQuery.enable_eagerloads()
.A new implementation for
KeyedTuple
used by theQuery
object offers dramatic speed improvements when fetching large numbers of column-oriented rows.References: #3176
The behavior of
joinedload.innerjoin
as well asrelationship.innerjoin
is now to use «nested» inner joins, that is, right-nested, as the default behavior when an inner join joined eager load is chained to an outer join eager load.References: #3008
UPDATE statements can now be batched within an ORM flush into more performant executemany() call, similarly to how INSERT statements can be batched; this will be invoked within flush to the degree that subsequent UPDATE statements for the same mapping and table involve the identical columns within the VALUES clause, that no SET-level SQL expressions are embedded, and that the versioning requirements for the mapping are compatible with the backend dialect’s ability to return a correct rowcount for an executemany operation.
The
info
parameter has been added to the constructor forSynonymProperty
andComparableProperty
.References: #2963
The
InspectionAttr.info
collection is now moved down toInspectionAttr
, where in addition to being available on allMapperProperty
objects, it is also now available on hybrid properties, association proxies, when accessed viaMapper.all_orm_descriptors
.References: #2971
Mapped attributes marked as deferred without explicit undeferral will now remain «deferred» even if their column is otherwise present in the result set in some way. This is a performance enhancement in that an ORM load no longer spends time searching for each deferred column when the result set is obtained. However, for an application that has been relying upon this, an explicit
undefer()
or similar option should now be used.The
proc()
callable passed to thecreate_row_processor()
method of customBundle
classes now accepts only a single «row» argument.Deprecated event hooks removed:
populate_instance
,create_instance
,translate_row
,append_result
См.также
Fixed bug in subquery eager loading where a long chain of eager loads across a polymorphic-subclass boundary in conjunction with polymorphic loading would fail to locate the subclass-link in the chain, erroring out with a missing property name on an
AliasedClass
.This change is also backported to: 0.9.5, 0.8.7
References: #3055
Fixed ORM bug where the
class_mapper()
function would mask AttributeErrors or KeyErrors that should raise during mapper configuration due to user errors. The catch for attribute/keyerror has been made more specific to not include the configuration step.This change is also backported to: 0.9.5, 0.8.7
References: #3047
Fixed bugs in ORM object comparisons where comparison of many-to-one
!= None
would fail if the source were an aliased class, or if the query needed to apply special aliasing to the expression due to aliased joins or polymorphic querying; also fixed bug in the case where comparing a many-to-one to an object state would fail if the query needed to apply special aliasing due to aliased joins or polymorphic querying.This change is also backported to: 0.9.9
References: #3310
Fixed bug where internal assertion would fail in the case where an
after_rollback()
handler for aSession
incorrectly adds state to thatSession
within the handler, and the task to warn and remove this state (established by #2389) attempts to proceed.This change is also backported to: 0.9.9
References: #3309
Fixed bug where TypeError raised when
Query.join()
called with unknown kw arguments would raise its own TypeError due to broken formatting. Pull request courtesy Malthe Borch.This change is also backported to: 0.9.9
Fixed bug in lazy loading SQL construction whereby a complex primaryjoin that referred to the same «local» column multiple times in the «column that points to itself» style of self-referential join would not be substituted in all cases. The logic to determine substitutions here has been reworked to be more open-ended.
This change is also backported to: 0.9.9
References: #3300
The «wildcard» loader options, in particular the one set up by the
load_only()
option to cover all attributes not explicitly mentioned, now takes into account the superclasses of a given entity, if that entity is mapped with inheritance mapping, so that attribute names within the superclasses are also omitted from the load. Additionally, the polymorphic discriminator column is unconditionally included in the list, just in the same way that primary key columns are, so that even with load_only() set up, polymorphic loading of subtypes continues to function correctly.This change is also backported to: 0.9.9
References: #3287
Fixed bug where if an exception were thrown at the start of a
Query
before it fetched results, particularly when row processors can’t be formed, the cursor would stay open with results pending and not actually be closed. This is typically only an issue on an interpreter like PyPy where the cursor isn’t immediately GC’ed, and can in some circumstances lead to transactions/ locks being open longer than is desirable.This change is also backported to: 0.9.9
References: #3285
Fixed a leak which would occur in the unsupported and highly non-recommended use case of replacing a relationship on a fixed mapped class many times, referring to an arbitrarily growing number of target mappers. A warning is emitted when the old relationship is replaced, however if the mapping were already used for querying, the old relationship would still be referenced within some registries.
This change is also backported to: 0.9.9
References: #3251
Fixed bug regarding expression mutations which could express itself as a «Could not locate column» error when using
Query
to select from multiple, anonymous column entities when querying against SQLite, as a side effect of the «join rewriting» feature used by the SQLite dialect.This change is also backported to: 0.9.9
References: #3241
Fixed bug where the ON clause for
Query.join()
, andQuery.outerjoin()
to a single-inheritance subclass usingof_type()
would not render the «single table criteria» in the ON clause if thefrom_joinpoint=True
flag were set.This change is also backported to: 0.9.9
References: #3232
Fixed bug that affected generally the same classes of event as that of #3199, when the
named=True
parameter would be used. Some events would fail to register, and others would not invoke the event arguments correctly, generally in the case of when an event was «wrapped» for adaption in some other way. The «named» mechanics have been rearranged to not interfere with the argument signature expected by internal wrapper functions.This change is also backported to: 0.9.8
References: #3197
Fixed bug that affected many classes of event, particularly ORM events but also engine events, where the usual logic of «de duplicating» a redundant call to
listen()
with the same arguments would fail, for those events where the listener function is wrapped. An assertion would be hit within registry.py. This assertion has now been integrated into the deduplication check, with the added bonus of a simpler means of checking deduplication across the board.This change is also backported to: 0.9.8
References: #3199
Fixed warning that would emit when a complex self-referential primaryjoin contained functions, while at the same time remote_side was specified; the warning would suggest setting «remote side». It now only emits if remote_side isn’t present.
This change is also backported to: 0.9.8
References: #3194
Fixed a regression caused by #2976 released in 0.9.4 where the «outer join» propagation along a chain of joined eager loads would incorrectly convert an «inner join» along a sibling join path into an outer join as well, when only descendant paths should be receiving the «outer join» propagation; additionally, fixed related issue where «nested» join propagation would take place inappropriately between two sibling join paths.
This change is also backported to: 0.9.7
References: #3131
Fixed a regression from 0.9.0 due to #2736 where the
Query.select_from()
method no longer set up the «from entity» of theQuery
object correctly, so that subsequentQuery.filter_by()
orQuery.join()
calls would fail to check the appropriate «from» entity when searching for attributes by string name.This change is also backported to: 0.9.7
Fixed bug where items that were persisted, deleted, or had a primary key change within a savepoint block would not participate in being restored to their former state (not in session, in session, previous PK) after the outer transaction were rolled back.
This change is also backported to: 0.9.7
References: #3108
Fixed bug in subquery eager loading in conjunction with
with_polymorphic()
, the targeting of entities and columns in the subquery load has been made more accurate with respect to this type of entity and others.This change is also backported to: 0.9.7
References: #3106
Additional checks have been added for the case where an inheriting mapper is implicitly combining one of its column-based attributes with that of the parent, where those columns normally don’t necessarily share the same value. This is an extension of an existing check that was added via #1892; however this new check emits only a warning, instead of an exception, to allow for applications that may be relying upon the existing behavior.
This change is also backported to: 0.9.5
References: #3042
Modified the behavior of
load_only()
such that primary key columns are always added to the list of columns to be «undeferred»; otherwise, the ORM can’t load the row’s identity. Apparently, one can defer the mapped primary keys and the ORM will fail, that hasn’t been changed. But as load_only is essentially saying «defer all but X», it’s more critical that PK cols not be part of this deferral.This change is also backported to: 0.9.5
References: #3080
Fixed a few edge cases which arise in the so-called «row switch» scenario, where an INSERT/DELETE can be turned into an UPDATE. In this situation, a many-to-one relationship set to None, or in some cases a scalar attribute set to None, may not be detected as a net change in value, and therefore the UPDATE would not reset what was on the previous row. This is due to some as-yet unresolved side effects of the way attribute history works in terms of implicitly assuming None isn’t really a «change» for a previously un-set attribute. See also #3061.
Примечание
This change has been REVERTED in 0.9.6. The full fix will be in version 1.0 of SQLAlchemy.
This change is also backported to: 0.9.5
References: #3060
Related to #3060, an adjustment has been made to the unit of work such that loading for related many-to-one objects is slightly more aggressive, in the case of a graph of self-referential objects that are to be deleted; the load of related objects is to help determine the correct order for deletion if passive_deletes is not set.
This change is also backported to: 0.9.5
Fixed bug in SQLite join rewriting where anonymized column names due to repeats would not correctly be rewritten in subqueries. This would affect SELECT queries with any kind of subquery + join.
This change is also backported to: 0.9.5
References: #3057
Fixes to the newly enhanced boolean coercion in #2804 where the new rules for «where» and «having» wouldn’t take effect for the «whereclause» and «having» kw arguments of the
select()
construct, which is also whatQuery
uses so wasn’t working in the ORM either.This change is also backported to: 0.9.5
References: #3013
Fixed bug where the session attachment error «object is already attached to session X» would fail to prevent the object from also being attached to the new session, in the case that execution continued after the error raise occurred.
References: #3301
The primary
Mapper
of aQuery
is now passed to theSession.get_bind()
method when calling uponQuery.count()
,Query.update()
,Query.delete()
, as well as queries against mapped columns,column_property
objects, and SQL functions and expressions derived from mapped columns. This allows sessions that rely upon either customizedSession.get_bind()
schemes or «bound» metadata to work in all relevant cases.The
PropComparator.of_type()
modifier has been improved in conjunction with loader directives such asjoinedload()
andcontains_eager()
such that if twoPropComparator.of_type()
modifiers of the same base type/path are encountered, they will be joined together into a single «polymorphic» entity, rather than replacing the entity of type A with the one of type B. E.g. a joinedload ofA.b.of_type(BSub1)->BSub1.c
combined with joinedload ofA.b.of_type(BSub2)->BSub2.c
will create a single joinedload ofA.b.of_type((BSub1, BSub2)) -> BSub1.c, BSub2.c
, without the need for thewith_polymorphic
to be explicit in the query.См.также
Стремительная загрузка специфических или полиморфных подтипов - contains an updated example illustrating the new format.
References: #3256
Repaired support of the
copy.deepcopy()
call when used by theCascadeOptions
argument, which occurs ifcopy.deepcopy()
is being used withrelationship()
(not an officially supported use case). Pull request courtesy duesenfranz.Fixed bug where
Session.expunge()
would not fully detach the given object if the object had been subject to a delete operation that was flushed, but not committed. This would also affect related operations likemake_transient()
.References: #3139
A warning is emitted in the case of multiple relationships that ultimately will populate a foreign key column in conflict with another, where the relationships are attempting to copy values from different source columns. This occurs in the case where composite foreign keys with overlapping columns are mapped to relationships that each refer to a different referenced column. A new documentation section illustrates the example as well as how to overcome the issue by specifying «foreign» columns specifically on a per-relationship basis.
См.также
References: #3230
The
Query.update()
method will now convert string key names in the given dictionary of values into mapped attribute names against the mapped class being updated. Previously, string names were taken in directly and passed to the core update statement without any means to resolve against the mapped entity. Support for synonyms and hybrid attributes as the subject attributes ofQuery.update()
are also supported.References: #3228
Improvements to the mechanism used by
Session
to locate «binds» (e.g. engines to use), such engines can be associated with mixin classes, concrete subclasses, as well as a wider variety of table metadata such as joined inheritance tables.References: #3035
Fixed bug in single table inheritance where a chain of joins that included the same single inh entity more than once (normally this should raise an error) could, in some cases depending on what was being joined «from», implicitly alias the second case of the single inh entity, producing a query that «worked». But as this implicit aliasing is not intended in the case of single table inheritance, it didn’t really «work» fully and was very misleading, since it wouldn’t always appear.
References: #3233
The ON clause rendered when using
Query.join()
,Query.outerjoin()
, or the standalonejoin()
/outerjoin()
functions to a single-inheritance subclass will now include the «single table criteria» in the ON clause even if the ON clause is otherwise hand-rolled; it is now added to the criteria using AND, the same way as if joining to a single-table target using relationship or similar.This is sort of in-between feature and bug.
References: #3222
A major rework to the behavior of expression labels, most specifically when used with ColumnProperty constructs with custom SQL expressions and in conjunction with the «order by labels» logic first introduced in 0.9. Fixes include that an
order_by(Entity.some_col_prop)
will now make use of «order by label» rules even if Entity has been subject to aliasing, either via inheritance rendering or via the use of thealiased()
construct; rendering of the same column property multiple times with aliasing (e.g.query(Entity.some_prop, entity_alias.some_prop)
) will label each occurrence of the entity with a distinct label, and additionally «order by label» rules will work for both (e.g.order_by(Entity.some_prop, entity_alias.some_prop)
). Additional issues that could prevent the «order by label» logic from working in 0.9, most notably that the state of a Label could change such that «order by label» would stop working depending on how things were called, has been fixed.Changed the approach by which the «single inheritance criterion» is applied, when using
Query.from_self()
, or its common userQuery.count()
. The criteria to limit rows to those with a certain type is now indicated on the inside subquery, not the outside one, so that even if the «type» column is not available in the columns clause, we can filter on it on the «inner» query.References: #3177
Made a small adjustment to the mechanics of lazy loading, such that it has less chance of interfering with a joinload() in the very rare circumstance that an object points to itself; in this scenario, the object refers to itself while loading its attributes which can cause a mixup between loaders. The use case of «object points to itself» is not fully supported, but the fix also removes some overhead so for now is part of testing.
References: #3145
The «resurrect» ORM event has been removed. This event hook had no purpose since the old «mutable attribute» system was removed in 0.8.
References: #3171
Fixed bug where attribute «set» events or columns with
@validates
would have events triggered within the flush process, when those columns were the targets of a «fetch and populate» operation, such as an autoincremented primary key, a Python side default, or a server-side default «eagerly» fetched via RETURNING.References: #3167
The
IdentityMap
exposed fromSession.identity_map
now returns lists foritems()
andvalues()
in Py3K. Early porting to Py3K here had these returning iterators, when they technically should be «iterable views»..for now, lists are OK.The «evaluator» for query.update()/delete() won’t work with multi-table updates, and needs to be set to synchronize_session=False or synchronize_session=“fetch“; this now raises an exception, with a message to change the synchronize setting. This is upgraded from a warning emitted as of 0.9.7.
References: #3117
Adjustment to attribute mechanics concerning when a value is implicitly initialized to None via first access; this action, which has always resulted in a population of the attribute, no longer does so; the None value is returned but the underlying attribute receives no set event. This is consistent with how collections work and allows attribute mechanics to behave more consistently; in particular, getting an attribute with no value does not squash the event that should proceed if the value is actually set to None.
where bound parameters are rendered inline as strings based on a compile-time option. Work on this feature is courtesy of Dobes Vandermeer.
References: #3061
orm declarative¶
The
declared_attr
construct has newly improved behaviors and features in conjunction with declarative. The decorated function will now have access to the final column copies present on the local mixin when invoked, and will also be invoked exactly once for each mapped class, the returned result being memoized. A new modifierdeclared_attr.cascading
is added as well.References: #3150
Fixed «„NoneType“ object has no attribute „concrete“» error when using
AbstractConcreteBase
in conjunction with a subclass that declares__abstract__
.This change is also backported to: 0.9.8
References: #3185
Fixed bug where using an
__abstract__
mixin in the middle of a declarative inheritance hierarchy would prevent attributes and configuration being correctly propagated from the base class to the inheriting class.A relationship set up with
declared_attr
on aAbstractConcreteBase
base class will now be configured on the abstract base mapping automatically, in addition to being set up on descendant concrete classes as usual.References: #2670
examples¶
Added a new example illustrating materialized paths, using the latest relationship features. Example courtesy Jack Zhou.
This change is also backported to: 0.9.5
A new suite of examples dedicated to providing a detailed study into performance of SQLAlchemy ORM and Core, as well as the DBAPI, from multiple perspectives. The suite runs within a container that provides built in profiling displays both through console output as well as graphically via the RunSnake tool.
См.также
Updated the Версионирование с помощью таблицы истории example such that mapped columns are re-mapped to match column names as well as grouping of columns; in particular, this allows columns that are explicitly grouped in a same-column-named joined inheritance scenario to be mapped in the same way in the history mappings, avoiding warnings added in the 0.9 series regarding this pattern and allowing the same view of attribute keys.
This change is also backported to: 0.9.9
Fixed a bug in the examples/generic_associations/discriminator_on_association.py example, where the subclasses of AddressAssociation were not being mapped as «single table inheritance», leading to problems when trying to use the mappings further.
This change is also backported to: 0.9.9
engine¶
Added new user-space accessors for viewing transaction isolation levels;
Connection.get_isolation_level()
,Connection.default_isolation_level
.This change is also backported to: 0.9.9
Added new event
ConnectionEvents.handle_error()
, a more fully featured and comprehensive replacement forConnectionEvents.dbapi_error()
.This change is also backported to: 0.9.7
References: #3076
A new style of warning can be emitted which will «filter» up to N occurrences of a parameterized string. This allows parameterized warnings that can refer to their arguments to be delivered a fixed number of times until allowing Python warning filters to squelch them, and prevents memory from growing unbounded within Python’s warning registries.
References: #3178
Fixed bug in
Connection
and pool where theConnection.invalidate()
method, or an invalidation due to a database disconnect, would fail if theisolation_level
parameter had been used withConnection.execution_options()
; the «finalizer» that resets the isolation level would be called on the no longer opened connection.This change is also backported to: 0.9.9
References: #3302
A warning is emitted if the
isolation_level
parameter is used withConnection.execution_options()
when aTransaction
is in play; DBAPIs and/or SQLAlchemy dialects such as psycopg2, MySQLdb may implicitly rollback or commit the transaction, or not change the setting til next transaction, so this is never safe.This change is also backported to: 0.9.9
References: #3296
The execution options passed to an
Engine
either viacreate_engine.execution_options
orEngine.update_execution_options()
are not passed to the specialConnection
used to initialize the dialect within the «first connect» event; dialects will usually perform their own queries in this phase, and none of the current available options should be applied here. In particular, the «autocommit» option was causing an attempt to autocommit within this initial connect which would fail with an AttributeError due to the non-standard state of theConnection
.This change is also backported to: 0.9.8
References: #3200
The string keys that are used to determine the columns impacted for an INSERT or UPDATE are now sorted when they contribute towards the «compiled cache» cache key. These keys were previously not deterministically ordered, meaning the same statement could be cached multiple times on equivalent keys, costing both in terms of memory as well as performance.
This change is also backported to: 0.9.8
References: #3165
Fixed bug which would occur if a DBAPI exception occurs when the engine first connects and does its initial checks, and the exception is not a disconnect exception, yet the cursor raises an error when we try to close it. In this case the real exception would be quashed as we tried to log the cursor close exception via the connection pool and failed, as we were trying to access the pool’s logger in a way that is inappropriate in this very specific scenario.
This change is also backported to: 0.9.5
References: #3063
Fixed some «double invalidate» situations were detected where a connection invalidation could occur within an already critical section like a connection.close(); ultimately, these conditions are caused by the change in #2907, in that the «reset on return» feature calls out to the Connection/Transaction in order to handle it, where «disconnect detection» might be caught. However, it’s possible that the more recent change in #2985 made it more likely for this to be seen as the «connection invalidate» operation is much quicker, as the issue is more reproducible on 0.9.4 than 0.9.3.
Checks are now added within any section that an invalidate might occur to halt further disallowed operations on the invalidated connection. This includes two fixes both at the engine level and at the pool level. While the issue was observed with highly concurrent gevent cases, it could in theory occur in any kind of scenario where a disconnect occurs within the connection close operation.
This change is also backported to: 0.9.5
References: #3043
The engine-level error handling and wrapping routines will now take effect in all engine connection use cases, including when user-custom connect routines are used via the
create_engine.creator
parameter, as well as when theConnection
encounters a connection error on revalidation.References: #3266
Removing (or adding) an event listener at the same time that the event is being run itself, either from inside the listener or from a concurrent thread, now raises a RuntimeError, as the collection used is now an instance of
collections.deque()
and does not support changes while being iterated. Previously, a plain Python list was used where removal from inside the event itself would produce silent failures.References: #3163
sql¶
Liberalized the contract for
Index
a bit in that you can specify atext()
expression as the target; the index no longer needs to have a table-bound column present if the index is to be manually added to the table, either via inline declaration or viaTable.append_constraint()
.This change is also backported to: 0.9.5
References: #3028
Added new flag
between.symmetric
, when set to True renders «BETWEEN SYMMETRIC». Also added a new negation operator «notbetween_op», which now allows an expression like~col.between(x, y)
to render as «col NOT BETWEEN x AND y», rather than a parenthesized NOT string.This change is also backported to: 0.9.5
References: #2990
The SQL compiler now generates the mapping of expected columns such that they are matched to the received result set positionally, rather than by name. Originally, this was seen as a way to handle cases where we had columns returned with difficult-to-predict names, though in modern use that issue has been overcome by anonymous labeling. In this version, the approach basically reduces function call count per-result by a few dozen calls, or more for larger sets of result columns. The approach still degrades into a modern version of the old approach if any discrepancy in size exists between the compiled set of columns versus what was received, so there’s no issue for partially or fully textual compilation scenarios where these lists might not line up.
References: #918
Literal values within a
DefaultClause
, which is invoked when using theColumn.server_default
parameter, will now be rendered using the «inline» compiler, so that they are rendered as-is, rather than as bound parameters.References: #3087
The type of expression is reported when an object passed to a SQL expression unit can’t be interpreted as a SQL fragment; pull request courtesy Ryan P. Kelly.
Added a new parameter
Table.tometadata.name
to theTable.tometadata()
method. Similar toTable.tometadata.schema
, this argument causes the newly copiedTable
to take on the new name instead of the existing one. An interesting capability this adds is that of copying aTable
object to the sameMetaData
target with a new name. Pull request courtesy n.d. parker.Exception messages have been spiffed up a bit. The SQL statement and parameters are not displayed if None, reducing confusion for error messages that weren’t related to a statement. The full module and classname for the DBAPI-level exception is displayed, making it clear that this is a wrapped DBAPI exception. The statement and parameters themselves are bounded within a bracketed sections to better isolate them from the error message and from each other.
References: #3172
Insert.from_select()
now includes Python and SQL-expression defaults if otherwise unspecified; the limitation where non- server column defaults aren’t included in an INSERT FROM SELECT is now lifted and these expressions are rendered as constants into the SELECT statement.The
UniqueConstraint
construct is now included when reflecting aTable
object, for databases where this is applicable. In order to achieve this with sufficient accuracy, MySQL and PostgreSQL now contain features that correct for the duplication of indexes and unique constraints when reflecting tables, indexes, and constraints. In the case of MySQL, there is not actually a «unique constraint» concept independent of a «unique index», so for this backendUniqueConstraint
continues to remain non-present for a reflectedTable
. For PostgreSQL, the query used to detect indexes againstpg_index
has been improved to check for the same construct inpg_constraint
, and the implicitly constructed unique index is not included with a reflectedTable
.In both cases, the
Inspector.get_indexes()
and theInspector.get_unique_constraints()
methods return both constructs individually, but include a new tokenduplicates_constraint
in the case of PostgreSQL orduplicates_index
in the case of MySQL to indicate when this condition is detected. Pull request courtesy Johannes Erdfelt.References: #3184
Added new method
Select.with_statement_hint()
and ORM methodQuery.with_statement_hint()
to support statement-level hints that are not specific to a table.References: #3206
The
info
parameter has been added as a constructor argument to all schema constructs includingMetaData
,Index
,ForeignKey
,ForeignKeyConstraint
,UniqueConstraint
,PrimaryKeyConstraint
,CheckConstraint
.References: #2963
The
Table.autoload_with
flag now implies thatTable.autoload
should beTrue
. Pull request courtesy Malik Diarra.References: #3027
The
Select.limit()
andSelect.offset()
methods now accept any SQL expression, in addition to integer values, as arguments. Typically this is used to allow a bound parameter to be passed, which can be substituted with a value later thus allowing Python-side caching of the SQL query. The implementation here is fully backwards compatible with existing third party dialects, however those dialects which implement special LIMIT/OFFSET systems will need modification in order to take advantage of the new capabilities. Limit and offset also support «literal_binds» mode,References: #3034
The
column()
andtable()
constructs are now importable from the «from sqlalchemy» namespace, just like every other Core construct.The implicit conversion of strings to
text()
constructs when passed to most builder methods ofselect()
as well asQuery
now emits a warning with just the plain string sent. The textual conversion still proceeds normally, however. The only method that accepts a string without a warning are the «label reference» methods like order_by(), group_by(); these functions will now at compile time attempt to resolve a single string argument to a column or label expression present in the selectable; if none is located, the expression still renders, but you get the warning again. The rationale here is that the implicit conversion from string to text is more unexpected than not these days, and it is better that the user send more direction to the Core / ORM when passing a raw string as to what direction should be taken. Core/ORM tutorials have been updated to go more in depth as to how text is handled.References: #2992
Исправлена ошибка в
Enum
и других подклассахSchemaType
, когда прямое связывание типа сMetaData
приводило к зависанию, когда наMetaData
испускались события (например, события создания).This change is also backported to: 0.9.7, 0.8.7
References: #3124
Исправлена ошибка в системе пользовательских операторов плюс
TypeEngine.with_variant()
, при которой использованиеTypeDecorator
в сочетании с variant приводило к ошибке MRO, когда использовался оператор сравнения.This change is also backported to: 0.9.7, 0.8.7
References: #3102
Fixed bug in INSERT..FROM SELECT construct where selecting from a UNION would wrap the union in an anonymous (e.g. unlabeled) subquery.
This change is also backported to: 0.9.5, 0.8.7
References: #3044
Fixed bug where
Table.update()
andTable.delete()
would produce an empty WHERE clause when an emptyand_()
oror_()
or other blank expression were applied. This is now consistent with that ofselect()
.This change is also backported to: 0.9.5, 0.8.7
References: #3045
Added the
native_enum
flag to the__repr__()
output ofEnum
, which is mostly important when using it with Alembic autogenerate. Pull request courtesy Dimitris Theodorou.This change is also backported to: 0.9.9
Fixed bug where using a
TypeDecorator
that implemented a type that was also aTypeDecorator
would fail with Python’s «Cannot create a consistent method resolution order (MRO)» error, when any kind of SQL comparison expression were used against an object using this type.This change is also backported to: 0.9.9
References: #3278
Fixed issue where the columns from a SELECT embedded in an INSERT, either through the values clause or as a «from select», would pollute the column types used in the result set produced by the RETURNING clause when columns from both statements shared the same name, leading to potential errors or mis-adaptation when retrieving the returning rows.
This change is also backported to: 0.9.9
References: #3248
Fixed bug where a fair number of SQL elements within the sql package would fail to
__repr__()
successfully, due to a missingdescription
attribute that would then invoke a recursion overflow when an internal AttributeError would then re-invoke__repr__()
.This change is also backported to: 0.9.8
References: #3195
An adjustment to table/index reflection such that if an index reports a column that isn’t found to be present in the table, a warning is emitted and the column is skipped. This can occur for some special system column situations as has been observed with Oracle.
This change is also backported to: 0.9.8
References: #3180
Fixed bug in CTE where
literal_binds
compiler argument would not be always be correctly propagated when one CTE referred to another aliased CTE in a statement.This change is also backported to: 0.9.8
References: #3154
Fixed 0.9.7 regression caused by #3067 in conjunction with a mis-named unit test such that so-called «schema» types like
Boolean
andEnum
could no longer be pickled.This change is also backported to: 0.9.8
Fix bug in naming convention feature where using a check constraint convention that includes
constraint_name
would then force allBoolean
andEnum
types to require names as well, as these implicitly create a constraint, even if the ultimate target backend were one that does not require generation of the constraint such as PostgreSQL. The mechanics of naming conventions for these particular constraints has been reorganized such that the naming determination is done at DDL compile time, rather than at constraint/table construction time.This change is also backported to: 0.9.7
References: #3067
Fixed bug in common table expressions whereby positional bound parameters could be expressed in the wrong final order when CTEs were nested in certain ways.
This change is also backported to: 0.9.7
References: #3090
Fixed bug where multi-valued
Insert
construct would fail to check subsequent values entries beyond the first one given for literal SQL expressions.This change is also backported to: 0.9.7
References: #3069
Added a «str()» step to the dialect_kwargs iteration for Python version < 2.6.5, working around the «no unicode keyword arg» bug as these args are passed along as keyword args within some reflection processes.
This change is also backported to: 0.9.7
References: #3123
The
TypeEngine.with_variant()
method will now accept a type class as an argument which is internally converted to an instance, using the same convention long established by other constructs such asColumn
.This change is also backported to: 0.9.7
References: #3122
The
Column.nullable
flag is implicitly set toFalse
when thatColumn
is referred to in an explicitPrimaryKeyConstraint
for that table. This behavior now matches that of when theColumn
itself has theColumn.primary_key
flag set toTrue
, which is intended to be an exactly equivalent case.This change is also backported to: 0.9.5
References: #3023
Fixed bug where the
Operators.__and__()
,Operators.__or__()
andOperators.__invert__()
operator overload methods could not be overridden within a customComparator
implementation.This change is also backported to: 0.9.5
References: #3012
Fixed bug in new
DialectKWArgs.argument_for()
method where adding an argument for a construct not previously included for any special arguments would fail.This change is also backported to: 0.9.5
References: #3024
Fixed regression introduced in 0.9 where new «ORDER BY <labelname>» feature from #1068 would not apply quoting rules to the label name as rendered in the ORDER BY.
This change is also backported to: 0.9.5
Restored the import for
Function
to thesqlalchemy.sql.expression
import namespace, which was removed at the beginning of 0.9.This change is also backported to: 0.9.5
The multi-values version of
Insert.values()
has been repaired to work more usefully with tables that have Python- side default values and/or functions, as well as server-side defaults. The feature will now work with a dialect that uses «positional» parameters; a Python callable will also be invoked individually for each row just as is the case with an «executemany» style invocation; a server- side default column will no longer implicitly receive the value explicitly specified for the first row, instead refusing to invoke without an explicit value.References: #3288
Fixed bug in
Table.tometadata()
method where theCheckConstraint
associated with aBoolean
orEnum
type object would be doubled in the target table. The copy process now tracks the production of this constraint object as local to a type object.References: #3260
The behavioral contract of the
ForeignKeyConstraint.columns
collection has been made consistent; this attribute is now aColumnCollection
like that of all other constraints and is initialized at the point when the constraint is associated with aTable
.References: #3243
The
Column.key
attribute is now used as the source of anonymous bound parameter names within expressions, to match the existing use of this value as the key when rendered in an INSERT or UPDATE statement. This allowsColumn.key
to be used as a «substitute» string to work around a difficult column name that doesn’t translate well into a bound parameter name. Note that the paramstyle is configurable oncreate_engine()
in any case, and most DBAPIs today support a named and positional style.References: #3245
Fixed the name of the
PoolEvents.reset.dbapi_connection
parameter as passed to this event; in particular this affects usage of the «named» argument style for this event. Pull request courtesy Jason Goldberger.Reversing a change that was made in 0.9, the «singleton» nature of the «constants»
null()
,true()
, andfalse()
has been reverted. These functions returning a «singleton» object had the effect that different instances would be treated as the same regardless of lexical use, which in particular would impact the rendering of the columns clause of a SELECT statement.References: #3170
Fixed bug where a «branched» connection, that is the kind you get when you call
Connection.connect()
, would not share invalidation status with the parent. The architecture of branching has been tweaked a bit so that the branched connection defers to the parent for all invalidation status and operations.References: #3215
Fixed bug where a «branched» connection, that is the kind you get when you call
Connection.connect()
, would not share transaction status with the parent. The architecture of branching has been tweaked a bit so that the branched connection defers to the parent for all transactional status and operations.References: #3190
Using
Insert.from_select()
now impliesinline=True
oninsert()
. This helps to fix a bug where an INSERT…FROM SELECT construct would inadvertently be compiled as «implicit returning» on supporting backends, which would cause breakage in the case of an INSERT that inserts zero rows (as implicit returning expects a row), as well as arbitrary return data in the case of an INSERT that inserts multiple rows (e.g. only the first row of many). A similar change is also applied to an INSERT..VALUES with multiple parameter sets; implicit RETURNING will no longer emit for this statement either. As both of these constructs deal with variable numbers of rows, theResultProxy.inserted_primary_key
accessor does not apply. Previously, there was a documentation note that one may preferinline=True
with INSERT..FROM SELECT as some databases don’t support returning and therefore can’t do «implicit» returning, but there’s no reason an INSERT…FROM SELECT needs implicit returning in any case. Regular explicitInsert.returning()
should be used to return variable numbers of result rows if inserted data is needed.References: #3169
Custom dialects that implement
GenericTypeCompiler
can now be constructed such that the visit methods receive an indication of the owning expression object, if any. Any visit method that accepts keyword arguments (e.g.**kw
) will in most cases receive a keyword argumenttype_expression
, referring to the expression object that the type is contained within. For columns in DDL, the dialect’s compiler class may need to alter itsget_column_specification()
method to support this as well. TheUserDefinedType.get_col_spec()
method will also receivetype_expression
if it provides**kw
in its argument signature.References: #3074
schema¶
The DDL generation system of
MetaData.create_all()
andMetaData.drop_all()
has been enhanced to in most cases automatically handle the case of mutually dependent foreign key constraints; the need for theForeignKeyConstraint.use_alter
flag is greatly reduced. The system also works for constraints which aren’t given a name up front; only in the case of DROP is a name required for at least one of the constraints involved in the cycle.References: #3282
Added a new accessor
Table.foreign_key_constraints
to complement theTable.foreign_keys
collection, as well asForeignKeyConstraint.referred_table
.The
CheckConstraint
construct now supports naming conventions that include the token%(column_0_name)s
; the constraint expression is scanned for columns. Additionally, naming conventions for check constraints that don’t include the%(constraint_name)s
token will now work forSchemaType
- generated constraints, such as those ofBoolean
andEnum
; this stopped working in 0.9.7 due to #3067.
postgresql¶
Added support for the
CONCURRENTLY
keyword with PostgreSQL indexes, established usingpostgresql_concurrently
. Pull request courtesy Iuri de Silvio.См.также
postgresql_index_concurrently
This change is also backported to: 0.9.9
Support is added for «sane multi row count» with the pg8000 driver, which applies mostly to when using versioning with the ORM. The feature is version-detected based on pg8000 1.9.14 or greater in use. Pull request courtesy Tony Locke.
This change is also backported to: 0.9.8
Added kw argument
postgresql_regconfig
to theColumnOperators.match()
operator, allows the «reg config» argument to be specified to theto_tsquery()
function emitted. Pull request courtesy Jonathan Vanasco.This change is also backported to: 0.9.7
References: #3078
Added support for PostgreSQL JSONB via
JSONB
. Pull request courtesy Damian Dimmich.This change is also backported to: 0.9.7
Added support for AUTOCOMMIT isolation level when using the pg8000 DBAPI. Pull request courtesy Tony Locke.
This change is also backported to: 0.9.5
Added a new flag
ARRAY.zero_indexes
to the PostgreSQLARRAY
type. When set toTrue
, a value of one will be added to all array index values before passing to the database, allowing better interoperability between Python style zero-based indexes and PostgreSQL one-based indexes. Pull request courtesy Alexey Terentev.This change is also backported to: 0.9.5
References: #2785
The PG8000 dialect now supports the
create_engine.encoding
parameter, by setting up the client encoding on the connection which is then intercepted by pg8000. Pull request courtesy Tony Locke.Added support for PG8000’s native JSONB feature. Pull request courtesy Tony Locke.
Added support for the psycopg2cffi DBAPI on pypy. Pull request courtesy shauns.
См.также
sqlalchemy.dialects.postgresql.psycopg2cffi
References: #3052
Added support for the FILTER keyword as applied to aggregate functions, supported by PostgreSQL 9.4. Pull request courtesy Ilja Everilä.
См.также
Support has been added for reflection of materialized views and foreign tables, as well as support for materialized views within
Inspector.get_view_names()
, and a new methodPGInspector.get_foreign_table_names()
available on the PostgreSQL version ofInspector
. Pull request courtesy Rodrigo Menezes.References: #2891
Added support for PG table options TABLESPACE, ON COMMIT, WITH(OUT) OIDS, and INHERITS, when rendering DDL via the
Table
construct. Pull request courtesy malikdiarra.См.также
postgresql_table_options
References: #2051
Added new method
PGInspector.get_enums()
, when using the inspector for PostgreSQL will provide a list of ENUM types. Pull request courtesy Ilya Pekelny.Added the
hashable=False
flag to the PGHSTORE
type, which is needed to allow the ORM to skip over trying to «hash» an ORM-mapped HSTORE column when requesting it in a mixed column/entity list. Patch courtesy Gunnlaugur Þór Briem.This change is also backported to: 0.9.5, 0.8.7
References: #3053
Added a new «disconnect» message «connection has been closed unexpectedly». This appears to be related to newer versions of SSL. Pull request courtesy Antti Haapala.
This change is also backported to: 0.9.5, 0.8.7
Repaired support for PostgreSQL UUID types in conjunction with the ARRAY type when using psycopg2. The psycopg2 dialect now employs use of the psycopg2.extras.register_uuid() hook so that UUID values are always passed to/from the DBAPI as UUID() objects. The
UUID.as_uuid
flag is still honored, except with psycopg2 we need to convert returned UUID objects back into strings when this is disabled.This change is also backported to: 0.9.9
References: #2940
Added support for the
postgresql.JSONB
datatype when using psycopg2 2.5.4 or greater, which features native conversion of JSONB data so that SQLAlchemy’s converters must be disabled; additionally, the newly added psycopg2 extensionextras.register_default_jsonb
is used to establish a JSON deserializer passed to the dialect via thejson_deserializer
argument. Also repaired the PostgreSQL integration tests which weren’t actually round-tripping the JSONB type as opposed to the JSON type. Pull request courtesy Mateusz Susik.This change is also backported to: 0.9.9
Repaired the use of the «array_oid» flag when registering the HSTORE type with older psycopg2 versions < 2.4.3, which does not support this flag, as well as use of the native json serializer hook «register_default_json» with user-defined
json_deserializer
on psycopg2 versions < 2.5, which does not include native json.This change is also backported to: 0.9.9
Fixed bug where PostgreSQL dialect would fail to render an expression in an
Index
that did not correspond directly to a table-bound column; typically when atext()
construct was one of the expressions within the index; or could misinterpret the list of expressions if one or more of them were such an expression.This change is also backported to: 0.9.9
References: #3174
A revisit to this issue first patched in 0.9.5, apparently psycopg2’s
.closed
accessor is not as reliable as we assumed, so we have added an explicit check for the exception messages «SSL SYSCALL error: Bad file descriptor» and «SSL SYSCALL error: EOF detected» when detecting an is-disconnect scenario. We will continue to consult psycopg2’s connection.closed as a first check.This change is also backported to: 0.9.8
References: #3021
Fixed bug where PostgreSQL JSON type was not able to persist or otherwise render a SQL NULL column value, rather than a JSON-encoded
'null'
. To support this case, changes are as follows:The value
null()
can now be specified, which will always result in a NULL value resulting in the statement.A new parameter
JSON.none_as_null
is added, which when True indicates that the PythonNone
value should be persisted as SQL NULL, rather than JSON-encoded'null'
.
Retrieval of NULL as None is also repaired for DBAPIs other than psycopg2, namely pg8000.
This change is also backported to: 0.9.8
References: #3159
The exception wrapping system for DBAPI errors can now accommodate non-standard DBAPI exceptions, such as the psycopg2 TransactionRollbackError. These exceptions will now be raised using the closest available subclass in
sqlalchemy.exc
, in the case of TransactionRollbackError,sqlalchemy.exc.OperationalError
.This change is also backported to: 0.9.8
References: #3075
Fixed bug in
array
object where comparison to a plain Python list would fail to use the correct array constructor. Pull request courtesy Andrew.This change is also backported to: 0.9.8
References: #3141
Added a supported
FunctionElement.alias()
method to functions, e.g. thefunc
construct. Previously, behavior for this method was undefined. The current behavior mimics that of pre-0.9.4, which is that the function is turned into a single-column FROM clause with the given alias name, where the column itself is anonymously named.This change is also backported to: 0.9.8
References: #3137
Fixed bug introduced in 0.9.5 by new pg8000 isolation level feature where engine-level isolation level parameter would raise an error on connect.
This change is also backported to: 0.9.7
References: #3134
The psycopg2
.closed
accessor is now consulted when determining if an exception is a «disconnect» error; ideally, this should remove the need for any other inspection of the exception message to detect disconnect, however we will leave those existing messages in place as a fallback. This should be able to handle newer cases like «SSL EOF» conditions. Pull request courtesy Dirk Mueller.This change is also backported to: 0.9.5
References: #3021
The PostgreSQL
ENUM
type will emit a DROP TYPE instruction when a plaintable.drop()
is called, assuming the object is not associated directly with aMetaData
object. In order to accommodate the use case of an enumerated type shared between multiple tables, the type should be associated directly with theMetaData
object; in this case the type will only be created at the metadata level, or if created directly. The rules for create/drop of PostgreSQL enumerated types have been highly reworked in general.References: #3319
The
PGDialect.has_table()
method will now query againstpg_catalog.pg_table_is_visible(c.oid)
, rather than testing for an exact schema match, when the schema name is None; this so that the method will also illustrate that temporary tables are present. Note that this is a behavioral change, as PostgreSQL allows a non-temporary table to silently overwrite an existing temporary table of the same name, so this changes the behavior ofcheckfirst
in that unusual scenario.References: #3264
Added a new type
OID
to the PostgreSQL dialect. While «oid» is generally a private type within PG that is not exposed in modern versions, there are some PG use cases such as large object support where these types might be exposed, as well as within some user-reported schema reflection use cases.This change is also backported to: 0.9.5
References: #3002
mysql¶
The MySQL dialect now renders TIMESTAMP with NULL / NOT NULL in all cases, so that MySQL 5.6.6 with the
explicit_defaults_for_timestamp
flag enabled will will allow TIMESTAMP to continue to work as expected whennullable=False
. Existing applications are unaffected as SQLAlchemy has always emitted NULL for a TIMESTAMP column that isnullable=True
.References: #3155
Updated the «supports_unicode_statements» flag to True for MySQLdb and Pymysql under Python 2. This refers to the SQL statements themselves, not the parameters, and affects issues such as table and column names using non-ASCII characters. These drivers both appear to support Python 2 Unicode objects without issue in modern versions.
References: #3121
The
gaerdbms
dialect is no longer necessary, and emits a deprecation warning. Google now recommends using the MySQLdb dialect directly.This change is also backported to: 0.9.9
References: #3275
MySQL error 2014 «commands out of sync» appears to be raised as a ProgrammingError, not OperationalError, in modern MySQL-Python versions; all MySQL error codes that are tested for «is disconnect» are now checked within OperationalError and ProgrammingError regardless.
This change is also backported to: 0.9.7, 0.8.7
References: #3101
Fixed bug where column names added to
mysql_length
parameter on an index needed to have the same quoting for quoted names in order to be recognized. The fix makes the quotes optional but also provides the old behavior for backwards compatibility with those using the workaround.This change is also backported to: 0.9.5, 0.8.7
References: #3085
Added support for reflecting tables where an index includes KEY_BLOCK_SIZE using an equal sign. Pull request courtesy Sean McGivern.
This change is also backported to: 0.9.5, 0.8.7
Added a version check to the MySQLdb dialect surrounding the check for „utf8_bin“ collation, as this fails on MySQL server < 5.0.
This change is also backported to: 0.9.9
References: #3274
Mysqlconnector as of version 2.0, probably as a side effect of the python 3 merge, now does not expect percent signs (e.g. as used as the modulus operator and others) to be doubled, even when using the «pyformat» bound parameter format (this change is not documented by Mysqlconnector). The dialect now checks for py2k and for mysqlconnector less than version 2.0 when detecting if the modulus operator should be rendered as
%%
or%
.This change is also backported to: 0.9.8
Unicode SQL is now passed for MySQLconnector version 2.0 and above; for Py2k and MySQL < 2.0, strings are encoded.
This change is also backported to: 0.9.8
The MySQL dialect now supports CAST on types that are constructed as
TypeDecorator
objects.A warning is emitted when
cast()
is used with the MySQL dialect on a type where MySQL does not support CAST; MySQL only supports CAST on a subset of datatypes. SQLAlchemy has for a long time just omitted the CAST for unsupported types in the case of MySQL. While we don’t want to change this now, we emit a warning to show that it’s taken place. A warning is also emitted when a CAST is used with an older MySQL version (< 4) that doesn’t support CAST at all, it’s skipped in this case as well.References: #3237
The
SET
type has been overhauled to no longer assume that the empty string, or a set with a single empty string value, is in fact a set with a single empty string; instead, this is by default treated as the empty set. In order to handle persistence of aSET
that actually wants to include the blank value''
as a legitimate value, a new bitwise operational mode is added which is enabled by theSET.retrieve_as_bitwise
flag, which will persist and retrieve values unambiguously using their bitflag positioning. Storage and retrieval of unicode values for driver configurations that aren’t converting unicode natively is also repaired.References: #3283
The
ColumnOperators.match()
operator is now handled such that the return type is not strictly assumed to be boolean; it now returns aBoolean
subclass calledMatchType
. The type will still produce boolean behavior when used in Python expressions, however the dialect can override its behavior at result time. In the case of MySQL, while the MATCH operator is typically used in a boolean context within an expression, if one actually queries for the value of a match expression, a floating point value is returned; this value is not compatible with SQLAlchemy’s C-based boolean processor, so MySQL’s result-set behavior now follows that of theFloat
type. A new operator objectnotmatch_op
is also added to better allow dialects to define the negation of a match operation.References: #3263
MySQL boolean symbols «true», «false» work again. 0.9’s change in #2682 disallowed the MySQL dialect from making use of the «true» and «false» symbols in the context of «IS» / «IS NOT», but MySQL supports this syntax even though it has no boolean type. MySQL remains «non native boolean», but the
true()
andfalse()
symbols again produce the keywords «true» and «false», so that an expression likecolumn.is_(true())
again works on MySQL.References: #3186
The MySQL dialect will now disable
ConnectionEvents.handle_error()
events from firing for those statements which it uses internally to detect if a table exists or not. This is achieved using an execution optionskip_user_error_events
that disables the handle error event for the scope of that execution. In this way, user code that rewrites exceptions doesn’t need to worry about the MySQL dialect or other dialects that occasionally need to catch SQLAlchemy specific exceptions.Changed the default value of «raise_on_warnings» to False for MySQLconnector. This was set at True for some reason. The «buffered» flag unfortunately must stay at True as MySQLconnector does not allow a cursor to be closed unless all results are fully fetched.
References: #2515
sqlite¶
Added support for partial indexes (e.g. with a WHERE clause) on SQLite. Pull request courtesy Kai Groner.
См.также
sqlite_partial_index
This change is also backported to: 0.9.9
Added a new SQLite backend for the SQLCipher backend. This backend provides for encrypted SQLite databases using the pysqlcipher Python driver, which is very similar to the pysqlite driver.
См.также
pysqlcipher
This change is also backported to: 0.9.9
When selecting from a UNION using an attached database file, the pysqlite driver reports column names in cursor.description as „dbname.tablename.colname“, instead of „tablename.colname“ as it normally does for a UNION (note that it’s supposed to just be „colname“ for both, but we work around it). The column translation logic here has been adjusted to retrieve the rightmost token, rather than the second token, so it works in both cases. Workaround courtesy Tony Roberts.
This change is also backported to: 0.9.8
References: #3211
Fixed a SQLite join rewriting issue where a subquery that is embedded as a scalar subquery such as within an IN would receive inappropriate substitutions from the enclosing query, if the same table were present inside the subquery as were in the enclosing query such as in a joined inheritance scenario.
This change is also backported to: 0.9.7
References: #3130
UNIQUE and FOREIGN KEY constraints are now fully reflected on SQLite both with and without names. Previously, foreign key names were ignored and unnamed unique constraints were skipped. Thanks to Jon Nelson for assistance with this.
The SQLite dialect, when using the
DATE
,TIME
, orDATETIME
types, and given astorage_format
that only renders numbers, will render the types in DDL asDATE_CHAR
,TIME_CHAR
, andDATETIME_CHAR
, so that despite the lack of alpha characters in the values, the column will still deliver the «text affinity». Normally this is not needed, as the textual values within the default storage formats already imply text.См.также
sqlite_datetime
References: #3257
SQLite now supports reflection of unique constraints from temp tables; previously, this would fail with a TypeError. Pull request courtesy Johannes Erdfelt.
См.также
SQLite/Oracle have distinct methods for temporary table/view name reporting - changes regarding SQLite temporary table and view reflection.
References: #3203
Added
Inspector.get_temp_table_names()
andInspector.get_temp_view_names()
; currently, only the SQLite and Oracle dialects support these methods. The return of temporary table and view names has been removed from SQLite and Oracle’s version ofInspector.get_table_names()
andInspector.get_view_names()
; other database backends cannot support this information (such as MySQL), and the scope of operation is different in that the tables can be local to a session and typically aren’t supported in remote schemas.References: #3204
mssql¶
Enabled «multivalues insert» for SQL Server 2008. Pull request courtesy Albert Cervin. Also expanded the checks for «IDENTITY INSERT» mode to include when the identity key is present in the VALUEs clause of the statement.
This change is also backported to: 0.9.7
SQL Server 2012 now recommends VARCHAR(max), NVARCHAR(max), VARBINARY(max) for large text/binary types. The MSSQL dialect will now respect this based on version detection, as well as the new
deprecate_large_types
flag.См.также
mssql_large_type_deprecation
References: #3039
The hostname-based connection format for SQL Server when using pyodbc will no longer specify a default «driver name», and a warning is emitted if this is missing. The optimal driver name for SQL Server changes frequently and is per-platform, so hostname based connections need to specify this. DSN-based connections are preferred.
References: #3182
Added statement encoding to the «SET IDENTITY_INSERT» statements which operate when an explicit INSERT is being interjected into an IDENTITY column, to support non-ascii table identifiers on drivers such as pyodbc + unix + py2k that don’t support unicode statements.
This change is also backported to: 0.9.7, 0.8.7
In the SQL Server pyodbc dialect, repaired the implementation for the
description_encoding
dialect parameter, which when not explicitly set was preventing cursor.description from being parsed correctly in the case of result sets that contained names in alternate encodings. This parameter shouldn’t be needed going forward.This change is also backported to: 0.9.7, 0.8.7
References: #3091
Fixed the version string detection in the pymssql dialect to work with Microsoft SQL Azure, which changes the word «SQL Server» to «SQL Azure».
This change is also backported to: 0.9.8
References: #3151
Revised the query used to determine the current default schema name to use the
database_principal_id()
function in conjunction with thesys.database_principals
view so that we can determine the default schema independently of the type of login in progress (e.g., SQL Server, Windows, etc).This change is also backported to: 0.9.5
References: #3025
oracle¶
Added support for cx_oracle connections to a specific service name, as opposed to a tns name, by passing
?service_name=<name>
to the URL. Pull request courtesy Sławomir Ehlert.New Oracle DDL features for tables, indexes: COMPRESS, BITMAP. Patch courtesy Gabor Gombas.
Added support for CTEs under Oracle. This includes some tweaks to the aliasing syntax, as well as a new CTE feature
CTE.suffix_with()
, which is useful for adding in special Oracle-specific directives to the CTE.См.также
References: #3220
Added support for the Oracle table option ON COMMIT.
Fixed long-standing bug in Oracle dialect where bound parameter names that started with numbers would not be quoted, as Oracle doesn’t like numerics in bound parameter names.
This change is also backported to: 0.9.8
References: #2138
Fixed bug in oracle dialect test suite where in one test, „username“ was assumed to be in the database URL, even though this might not be the case.
This change is also backported to: 0.9.7
References: #3128
An alias name will be properly quoted when referred to using the
%(name)s
token inside theSelect.with_hint()
method. Previously, the Oracle backend hadn’t implemented this quoting.
tests¶
Fixed bug where «python setup.py test» wasn’t calling into distutils appropriately, and errors would be emitted at the end of the test suite.
This change is also backported to: 0.9.7
Corrected for some deprecation warnings involving the
imp
module and Python 3.3 or greater, when running tests. Pull request courtesy Matt Chisholm.This change is also backported to: 0.9.5
References: #2830
misc¶
Added a new extension suite
sqlalchemy.ext.baked
. This simple but unusual system allows for a dramatic savings in Python overhead for the construction and processing of ormQuery
objects, from query construction up through rendering of a string SQL statement.См.также
References: #3054
The
sqlalchemy.ext.automap
extension will now setcascade="all, delete-orphan"
automatically on a one-to-many relationship/backref where the foreign key is detected as containing one or more non-nullable columns. This argument is present in the keywords passed togenerate_relationship()
in this case and can still be overridden. Additionally, if theForeignKeyConstraint
specifiesondelete="CASCADE"
for a non-nullable orondelete="SET NULL"
for a nullable set of columns, the argumentpassive_deletes=True
is also added to the relationship. Note that not all backends support reflection of ondelete, but backends that do include PostgreSQL and MySQL.References: #3210
The
__mapper_args__
dictionary is copied from a declarative mixin or abstract class when accessed, so that modifications made to this dictionary by declarative itself won’t conflict with that of other mappings. The dictionary is modified regarding theversion_id_col
andpolymorphic_on
arguments, replacing the column within with the one that is officially mapped to the local class/table.This change is also backported to: 0.9.5, 0.8.7
References: #3062
Исправлена ошибка в мутабельном расширении, когда
MutableDict
не сообщало о событиях изменения для операции со словаремsetdefault()
.This change is also backported to: 0.9.5, 0.8.7
Fixed bug where
MutableDict.setdefault()
didn’t return the existing or new value (this bug was not released in any 0.8 version). Pull request courtesy Thomas Hervé.This change is also backported to: 0.9.5, 0.8.7
Fixed bug where the association proxy list class would not interpret slices correctly under Py3K. Pull request courtesy Gilles Dartiguelongue.
This change is also backported to: 0.9.9
Fixed an unlikely race condition observed in some exotic end-user setups, where the attempt to check for «duplicate class name» in declarative would hit upon a not-totally-cleaned-up weak reference related to some other class being removed; the check here now ensures the weakref still references an object before calling upon it further.
This change is also backported to: 0.9.8
References: #3208
Fixed bug in ordering list where the order of items would be thrown off during a collection replace event, if the reorder_on_append flag were set to True. The fix ensures that the ordering list only impacts the list that is explicitly associated with the object.
This change is also backported to: 0.9.8
References: #3191
Fixed bug where
MutableDict
failed to implement theupdate()
dictionary method, thus not catching changes. Pull request courtesy Matt Chisholm.This change is also backported to: 0.9.8
Fixed bug where a custom subclass of
MutableDict
would not show up in a «coerce» operation, and would instead return a plainMutableDict
. Pull request courtesy Matt Chisholm.This change is also backported to: 0.9.8
Fixed bug in connection pool logging where the «connection checked out» debug logging message would not emit if the logging were set up using
logging.setLevel()
, rather than using theecho_pool
flag. Tests to assert this logging have been added. This is a regression that was introduced in 0.9.0.This change is also backported to: 0.9.8
References: #3168
Fixed bug when the declarative
__abstract__
flag was not being distinguished for when it was actually the valueFalse
. The__abstract__
flag needs to actually evaluate to a True value at the level being tested.This change is also backported to: 0.9.7
References: #3097
In public test suite, changed to use of
String(40)
from less-supportedText
inStringTest.test_literal_backslashes
. Pullreq courtesy Jan.This change is also backported to: 0.9.5
The Drizzle dialect has been removed from the Core; it is now available as sqlalchemy-drizzle, an independent, third party dialect. The dialect is still based almost entirely off of the MySQL dialect present in SQLAlchemy.