此文档为个人笔记，完整的请查看官方文档。
摘自SQLAlchemy ORM
当前使用的sqlalchemy版本为1.1.15
添加和更新对象
>>> ed_user = User(name='ed', fullname='Ed Jones', password='edspassword')
>>> session.add(ed_user)
此时，我们说实例正在等待 ; 尚未发布SQL并且该对象尚未由数据库中的行表示。该 Session会发出SQL持久化，只要需要使用被称为一个冲洗的过程。如果我们查询数据库，所有待处理的信息将首先被刷新，并且查询立即发出。Ed Jones``Ed Jones
例如，下面我们创建一个Query加载实例的新对象User。我们“过滤”的name属性 ed，并表明我们只想要完整列表中的第一个结果。User返回的实例与我们添加的实例相同：
>>> our_user = session.query(User).filter_by(name='ed').first()
>>> our_user
事实上，Session已经确定返回的行与已经在其内部对象映射中表示的行相同，因此我们实际上取回了与刚才添加的相同的实例：
>>> ed_user is our_user
True
在这里工作的ORM概念被称为身份映射， 并确保在一个特定的行上的所有操作对 Session同一组数据进行操作。一旦一个具有特定主键的对象出现在该对象中 Session，那么所有的SQL查询 Session将总是为该特定主键返回相同的Python对象; 如果尝试在会话中放置第二个已保存的具有相同主键的对象，也会引发错误。
我们可以User一次添加更多的对象，使用 add_all()：
>>> session.add_all([
... User(name='wendy', fullname='Wendy Williams', password='foobar'),
... User(name='mary', fullname='Mary Contrary', password='xxg527'),
... User(name='fred', fullname='Fred Flinstone', password='blah')])
另外，我们已经决定Ed的密码不太安全，所以让我们改变它：
创建一个模式
User通过Declarative系统构造我们的类，我们定义了关于表的信息，称为表元数据。SQLAlchemy用于表示特定表的这些信息的Table对象称为对象，这里的Declarative已经为我们制作了一个对象。我们可以通过检查__table__属性来看到这个对象：
>>> User.__table__
Table('users', MetaData(bind=None),
Column('id', Integer(), table=, primary_key=True, nullable=False),
Column('name', String(), table=),
Column('fullname', String(), table=),
Column('password', String(), table=), schema=None)
当我们宣布我们的类时，Declarative使用Python元类来完成类声明完成后的额外活动; 在这个阶段中，Table根据我们的规范创建一个对象，并通过构造一个Mapper对象将它与类关联起来。这个对象是我们通常不需要直接处理的幕后对象（虽然它可以在我们需要时提供关于我们映射的大量信息）。
该Table对象是已知为较大集合的成员MetaData。当使用Declarative时，这个对象可以使用.metadata 我们的声明基类的属性。
这MetaData 是一个注册表，它包括向数据库发送一组有限的模式生成命令的功能。由于我们的SQLite数据库实际上并没有users表格，因此我们可以使用MetaData CREATE TABLE语句向数据库发布所有尚不存在的表格。下面，我们称之为MetaData.create_all()方法，传入我们Engine 作为数据库连接的来源。我们将看到首先发出特殊命令来检查users表的存在，然后再看看实际的语句：CREATE TABLE
>>> Base.metadata.create_all(engine)
SELECT ...
PRAGMA table_info("users")
()
CREATE TABLE users (
id INTEGER NOT NULL, name VARCHAR,
fullname VARCHAR,
password VARCHAR,
PRIMARY KEY (id)
)
()
COMMIT
连接
懒惰连接：当create_engine()第一次被返回的时候，并不会建立到数据库的连接，数据库的连接只发生在第一次要对数据库进行操作的时候。
会话
使用会话构造器来创建会话类
再使用会话类去实例化会话。
>>> from sqlalchemy import create_engine
>>> engine = create_engine('sqlite:///:memory:', echo=True)
>>> from sqlalchemy.orm import sessionmaker
>>> Session = sessionmaker(bind=engine)
>>> Session = sessionmaker()
>>> Session.configure(bind=engine) # once engine is available
>>> session = Session()
以上Session与我们启用SQLite的相关Engine，但它尚未打开任何连接。当它第一次使用时，它会从由Engine它维护的连接池中检索一个连接 ，并保留它，直到我们提交所有更改和/或关闭会话对象。