SQLAlchemy

.. |PyPI| image:: https://img.shields.io/pypi/v/sqlalchemy :target: https://pypi.org/project/sqlalchemy :alt: PyPI

.. |Python| image:: https://img.shields.io/pypi/pyversions/sqlalchemy :target: https://pypi.org/project/sqlalchemy :alt: PyPI - Python版本

.. |下载量| image:: https://static.pepy.tech/badge/sqlalchemy/month :target: https://pepy.tech/project/sqlalchemy :alt: PyPI - 下载量

Python SQL工具包和对象关系映射器

简介

SQLAlchemy是Python SQL工具包和对象关系映射器，为应用程序开发者提供了SQL的全部功能和灵活性。SQLAlchemy提供了一套完整的知名企业级持久化模式，旨在实现高效和高性能的数据库访问，并将其转化为简单易用的Python领域语言。

SQLAlchemy的主要特性包括：

一个工业级的ORM，基于身份映射、工作单元和数据映射器模式构建。这些模式允许使用声明式配置系统实现对象的透明持久化。可以自然地构建和操作领域模型，并自动与当前事务同步变更。
面向关系的查询系统，明确地暴露了SQL的全部功能，包括连接、子查询、关联等几乎所有功能，并以对象模型的形式呈现。使用ORM编写查询时，采用与编写SQL相同的关系组合技术。虽然你可以随时使用原生SQL，但几乎从不需要这样做。
一个全面而灵活的相关集合和对象的预加载系统。集合在会话中被缓存，可以在单独访问时加载，使用连接一次性加载，或者通过对整个结果集的查询来加载每个集合。
核心SQL构建系统和DBAPI交互层。SQLAlchemy Core独立于ORM，是一个完整的数据库抽象层，包括可扩展的基于Python的SQL表达式语言、模式元数据、连接池、类型转换和自定义类型。
所有主键和外键约束都被假定为复合和自然的。当然，代理整数主键仍然是常态，但SQLAlchemy从不假设或硬编码这种模型。
数据库内省和生成。数据库模式可以一步"反射"到表示数据库元数据的Python结构中；这些相同的结构随后可以直接生成CREATE语句 - 所有这些都在Core中完成，独立于ORM。

SQLAlchemy的理念：

随着规模和性能变得越来越重要，SQL数据库的行为越来越不像对象集合；随着抽象变得越来越重要，对象集合的行为越来越不像表和行。SQLAlchemy旨在适应这两个原则。
ORM不需要隐藏"R"。关系数据库提供了丰富的基于集合的功能，应该被充分暴露。SQLAlchemy的ORM提供了一套开放式的模式，允许开发者在领域模型和关系模式之间构建自定义的中介层，使所谓的"对象关系阻抗"问题成为过去。
在所有情况下，开发者都可以决定对象模型和关系模式的设计、结构和命名约定。SQLAlchemy只提供了自动执行这些决策的方法。
使用SQLAlchemy时，不存在"ORM生成了糟糕的查询"这种情况 - 你完全控制查询的结构，包括如何组织连接、如何使用子查询和关联、请求哪些列。SQLAlchemy所做的一切最终都是开发者主动决策的结果。
如果问题不需要ORM，就不要使用ORM。SQLAlchemy由Core和独立的ORM组件组成。Core提供了完整的SQL表达式语言，允许以Python方式构建SQL结构，直接渲染为目标数据库的SQL字符串，返回的结果集本质上是增强的DBAPI游标。
事务应该是常态。使用SQLAlchemy的ORM，在调用commit()之前，不会有任何内容被永久存储。SQLAlchemy鼓励应用程序创建一种一致的方式来划分一系列操作的开始和结束。
永远不要在SQL语句中渲染字面值。绑定参数被尽可能多地使用，允许查询优化器有效地缓存查询计划，并使SQL注入攻击成为不可能。