【软件升级】openEuler 22.03 LTS版本python-sqlalchemy软件升级至1.3.24

| 差异分析报告 | | | |
| :----------- | ----------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 版本变更原因 | | 变更后版本 | 1.3.24 |
| 差异分类 | 差异项 | 差异说明 | 影响评估与适配方案 |
| 特性变化 | 新增特性/删除特性/变更特性实现 | <code>orm 1.添加了新功能Query.only_return_tuples()，使Query对象无条件地返回带键的元组对象，即使查询针对的是单个实体。（此更改向后移植到1.2.5）。 2.Session.bulk_save_objects.preserve_order向 Session.bulk_save_objects()方法添加了新标志,该方法默认为True。当设置为False时，给定的映射将被分组到每个对象类型的插入和更新中，以便有更多的机会将常见操作批处理在一起。 3. 该Query.get()方法现在可以接受属性键和值的字典作为指示要加载的主键值的方式；对复合主键特别有用。 4.现在可以将 SQL 表达式分配给 ORM 刷新的主键属性，其方式与将SQL 插入/更新表达式嵌入Flush 中所述的普通属性相同， 其中将计算表达式，然后使用 RETURNING 返回到 ORM，或者在 pysqlite 的情况下，使用 cursor.lastrowid 属性工作。需要支持 RETURNING（例如 Postgresql、Oracle、SQL Server）或 pysqlite 的数据库。 5.添加了新的加载器选项方法Load.options()，该方法允许分层构建加载器选项，以便可以将许多子选项应用于特定路径而无需defaultload() 多次调用. engine: 1.向QueuePool添加了新的“lifo”模式,通常通过将标志设置create_engine.pool_use_lifo为 True来启用,允许试用期间从服务器端清除多余的连接。 2.添加QueuePool.timeout()了返回QueuePool对象配置超时的公共访问器. 3.修改了StatementError字符串化时的格式。每个错误详细信息都分解为多个换行符，而不是在一行中隔开。此外，SQL 表示现在将 SQL 语句字符串化而不是使用repr()，以便按原样呈现换行符. 4.添加了新参数create_engine.hide_parameters，当设置为 True 时，将导致不再记录 SQL 参数，也不再以StatementError对象的字符串表示形式呈现. 5.特定于方言的构造，如Insert.on_conflict_do_update()，现在可以在不需要指定显式方言对象的情况下进行字符串化,当调用str()、print()等时，这些结构现在有内部方向来调用它们相应的方言，而不是“默认”方言，后者不知道如何stringify这些。该方法还适用于通用模式级别的创建/删除，如AddConstraint，它将其stringify方言调整为它内部的元素所指示的，如excludeconconstraint对象。 6.添加了新的执行选项Connection.execution_options.logging_token。此选项将添加一个额外的每条消息标记，以记录由Connection执行语句时生成的消息 。 sql: 1.重构SQLCompiler，以公开一个SQLCompiler.group_by_clause()方法，类似于SQLCompiler.order_by_clause()和SQLCompiler.limit_clause()方法，这些方法可以被方言覆盖以自定义 GROUP BY 呈现的方式。(此更改也向后移植到：1.2.13) 2.将序列添加到 StrSQLCompiler,将 :class: 添加.Sequence到“字符串 SQL”系统中，该系统将 在没有方言的情况下对包含“序列下一个 值”表达式的语句进行字符串转化时呈现有意义的字符串表达式 ( "<next sequence value: my_sequence>") ，而不是引发编译错误 3.添加了新的命名约定标记column_0N_name、column_0_N_name等，这将呈现序列中特定约束引用的所有列的名称/键/标签。为了适应这种命名约定的长度，SQL 编译器的自动截断功能现在也适用于约束名称，这会为约束创建一个缩短的、确定性生成的名称，该名称将应用于目标后端而无需遍历该后端的字符限制. 4.在bindparam的扩展中添加对空列表的支持,向“扩展 IN”绑定参数功能添加了新逻辑，如果给定列表为空，则会生成特定于不同后端的特殊“空集”表达式，从而允许 IN 表达式完全动态，包括空 IN 表达式. 5.Python 内置dir()函数现在支持 SQLAlchemy“属性”对象，例如核心列集合（例如.c） mapper.attrs、 等的对象。也允许 iPython 自动完成工作。 6.添加了FunctionElement.as_comparison()允许 SQL 函数充当可以在 ORM 中工作的二进制比较操作的新功能 7.修改了AnsiFunction类 CURRENT_TIMESTAMP，以接受像常规 ad-hoc 函数一样的位置参数. 8.删除不推荐使用的参数text.bindparams和text.typemap,删除不推荐使用的参数Table.useexisting,删除过时的方法Compiled.compile，ClauseElement.__and__并 ClauseElement.__or__和属性Over.func。删除不推荐使用的FromClause.count方法。请使用命名空间中count可用的 函数 func,从Compiler对象中删除了绑定引擎的概念，并从 中删除了.execute()和.scalar()方法 Compiler. 9.删除了sqlalchemy.sql.visitors.iterate_depthfirst和 sqlalchemy.sql.visitors.traverse_depthfirst 功能。SQLAlchemy 的任何部分都未使用这些函数。该 iterate()和traverse() 功能通常用于这些功能。还从包括“column_collections”、“schema_visitor”在内的其余函数中删除了未使用的选项. 在 1.3 中弃用的“threadlocal”执行策略已在 1.4 中删除，以及“引擎策略”的概念和Engine.contextual_ connect方法。 10.SELECT 对象和派生的 FROM 子句允许重复的列和列标签, 添加了一个旨在减少创建语句的 Python 开销的新功能，允许在指示传递给语句对象（例如 select()、Query()、update() 等的参数时使用 lambdas. schema: 1.增加了新的参数Table.resolve_fks和 MetaData.reflect.resolve_fks,其设置为false时将禁止中遇到的相关表的自动反射 ForeignKey对象，既可以减少SQL开销省略表以及不能反映了特定于数据库的原因避免表。 即使两个表的反射分别发生Table，同一MetaData集合中的两个对象仍然可以相互引用. PostgreSQL: 1.添加 postgresl.REGCLASS 类型以将表名转换为 OID. (此更改也向后移植到:1.2.7), 2.添加了对 PostgreSQL 分区表反射的基本支持，例如，将 relkind='p' 添加到返回表信息的反射查询中. 3.添加了对 psycopg2 方言的无参数连接 URL 的支持，这意味着可以将 URL 传递给create_engine()as "postgresql+psycopg2. mysql: 1.添加了对MySQL中 CREATE FULLTEXT INDEX 的“WITH PARSER”语法的支持，使用mysql_with_parser关键字参数。还支持反射，它也适应 MySQL, 用于报告此选项的特殊注释格式。此外，“FULLTEXT”和“SPATIAL”索引前缀现在反映回mysql_prefix索引选项. 2.添加了对要排序的 MySQL 上的 ON DUPLICATE KEY UPDATE 语句中的参数的支持，因为 MySQL UPDATE 子句中的参数顺序很重要，其方式与Parameter-Ordered Updates中描述的方式类似. sqlite: 1.通过新的SQLite实现json，增加了对SQLite的json功能的支持. 2.实现了在 DDL 级别理解的 SQLite子句，例如对于主键、唯一和 CHECK 约束以及在 a上指定以满足内联主键和 NOT NULL. mssql 1.通过mssql_where 参数添加了对 SQL Server 过滤索引的支持. 2.添加了新参数create_engine.hide_parameters，当设置为 True 时，将导致不再记录 SQL 参数，也不再以StatementError对象的字符串表示形式呈现 oracle: 1.添加了一个当前仅由 cx_Oracle 方言使用的新事件， DialectEvents.setiputsizes(). 该事件将BindParameter对象字典传递给 特定于 DBAPI 的类型对象，这些对象将在转换为参数名称后传递给 cx_Oracle cursor.setinputsizes()方法。这允许查看 setinputsizes 过程以及更改传递给此方法的数据类型的行为的能力. misc: 1.添加了新属性Query.lazy_loaded_from，该属性填充了一个InstanceState使用 thisQuery以延迟加载关系的属性。这样做的基本原理是它作为水平分片功能使用的提示，这样状态的身份令牌可以用作默认身份令牌以用于 id_chooser() 中的查询.(此更改也向后移植到：1.2.9). 2.添加 BakedQuery.to_query() 方法, 添加了新功能 :meth: .BakedQuery.to_query，它允许以一种干净的方式使用:class:.BakedQuery作为另一个:class:内的子查询，.BakedQuery而无需显式引用:class: .Session. 3.增加了批量的支持Query.update()和Query.delete() 对ShardedQuery水平分片扩展中的类。这也为批量更新/删除方法添加了一个额外的扩展挂钩Query._execute_crud(). mypy: 1.更新了 Mypy 插件以仅使用语义分析器的公共插件接口.。br>general: asyncio: 2.向所有已弃用的 API 添加弃用警告，确保了所有对象、参数、和已被标记为已弃用或遗留的行为现在发出 ``DeprecationWarning`` 调用时发出警告，现在作为 Python 3 解释器默认显示弃用警告，以及现代测试套件基于 tox 和 pytest 等工具倾向于显示弃用警告，此更改应该可以更轻松地注意哪些 API 功能已过时。 [链接查看](https://github.com/sqlalchemy/sqlalchemy/commit/4c2c2c40fde17c85013e00a6f3303a99e2b32c12)</code> | |
| | | | |
| 配置文件 | 新增/变更/删除配置项 | 无 | |
| | | | |
| ABI差异 | 新增/变更/删除API | 1.1.将 `pool.py` 重构为一个包 | 对外不涉及 |
| | | 2.在lib\sqlalchemy\util\langhelpers.py中 增加以下函数定义：(1)clsname_as_plain_name; (2)inject_docstring_text; add_parameter_text inject_param_text; repr_tuple_names; (3)public_factory增加了参数class_location=None; | (1)改进加载器选项区域中的错误消息 (2)删除所有剩余的text()强制值，并确保标识符是安全的 (3)支持 public_factory 反对函数的情况 |
| | | 3.在lib\sqlalchemy\util_collections.py 增加函数：has_dupes | 给定一个序列和搜索对象，如果有更多则返回 True,大于一，如果为零或其中之一，则为 False |
| | | 4.在lib\sqlalchemy\sql\util.py 增加函数： （1）find_left_clause_that_matches_given; find_left_clause_to_join_from; (2) tables_from_leftmost (3)surface_selectables_only | (1)允许join()从多个form /实体中选择最佳的对象 (2)不依赖 whereclause 扫描表格 (3)计算 PostgreSQL“WITH FOR UPDATE OF”时扩展连接 |
| | | 5.在lib\sqlalchemy\sql\schema.py中 类参数变更： (1)Column增加参数DialectKWArgs； (2)Sequence增加参数IdentityOptions； 增加类： (3)Computed； 删除类IdentityOptions中的对象 | (1)为特定方言实施 kwarg 验证和类型系统 (2)将可执行文件添加到 DefaultGenerator (3)支持生成的列 |
| | | 6.在lib\sqlalchemy\sql\compiler.py 增加函数：(1)current_executable；(2)visit_function_as_comparison_op_binary | (1)修复了结构编译器问题 (2)支持函数“作为二进制比较” |
| | | 7.在lib\sqlalchemy\sql\base.py： 增加函数：get_execution_options | 为所有 execution_options 添加 getter |
| | | 8.在lib\sqlalchemy\orm\query.py： 增加函数： is_single_entity; get_execution_options; | 为Query添加公共访问器is_single_entity,为所有 execution_options 添加 getter |
| | | 9.lib\sqlalchemy\orm\events.py： 增加函数： before_mapper_configured； | 添加 before_mapper_configured 事件 此事件旨在允许在执行期间跳过特定的映射器 |
| | | 10.在lib\sqlalchemy\orm\interfaces.py: 函数setup参数entity变为query_entity; | 实现与 AliasedClass 的关系；弃用非主映射器; |
| | | 11.在lib\sqlalchemy\orm\loading.py： get_from_identity函数增加参数mapper; | 在 get_from_identity 上匹配类层次结构的测试实例 |
| | | 12.在lib\sqlalchemy\engine\base.py中：增加函数： get_execution_options; | 为所有 execution_options 添加 getter |
| | | 13.在lib\sqlalchemy\engine\default.py中:增加函数 get_default_isolation_level;identifier_preparer | 为模式转换添加 identifier_preparer 每个执行上下文 |
| | 新增/变更/删除结构体 | 无 | |
| | | | |
| 命令行/功能 | 新增/变更/删除命令 | 无 | |
| | 新增/变更/删除命令选项 | 无 | |
| | 新增/变更/删除日志输出 | 无 | |
| | | | |
| SPEC文件 | 新增/变更/删除 编译依赖、安装依赖、依赖的软件版本变更 | 无 | |
| | 拆分软件包方式变更 | 无 | |
| | | | |

src-openEuler/python-sqlalchemy

内容风险标识

评论 (4)

src-openEuler/python-sqlalchemy .gitee-modal { width: 500px !important; }

内容风险标识