极简SQLAlchemy Core

SQLAlchemy Core 是 SQLAlchemy 库的一部分，它提供了一个 SQL 表达式的语言和数据库引擎，用于在 Python 中执行 SQL 操作。它不同于 SQLAlchemy ORM，后者提供了一个高级的对象关系映射器。以下是 SQLAlchemy Core 的架构、组件和代码案例：

1. 架构

SQLAlchemy Core 的架构可以分为以下几个核心组件：

• Engine: 用于管理与数据库的连接。
• Connections: 代表与数据库的实时连接。
• Schema: 用于定义数据库架构，如表、列和约束。
• SQL Expression Language: 用于构建 SQL 查询和命令。
• Result Set: 表示查询结果。

2. 组件内容

Engine

Engine 是 SQLAlchemy 与数据库之间的桥梁，负责处理连接池、事务和执行 SQL 语句。

from sqlalchemy import create_engine
engine = create_engine('sqlite:///example.db')

Schema

使用 Table, Column, MetaData 等类来定义数据库架构。

from sqlalchemy import Table, Column, Integer, String, MetaData
metadata = MetaData()
user_table = Table('users', metadata,
                   Column('id', Integer, primary_key=True),
                   Column('name', String))

SQL Expression Language

使用表达式构造器如 select, insert, update, delete 来构建 SQL 语句。

from sqlalchemy.sql import select
select_statement = select([user_table])

Result Set

执行 SQL 表达式后，会返回一个结果集，可以迭代或转换为列表。

result = engine.execute(select_statement)
for row in result:
    print(row)

3. 基本内容与使用案例

1. 连接数据库

首先，需要连接到数据库。SQLAlchemy 通过创建一个 Engine 对象来管理与数据库的连接。

from sqlalchemy import create_engine
# 'sqlite:///example.db' 是连接字符串，用于指定数据库类型和位置
engine = create_engine('sqlite:///example.db')

2. 定义表

使用 Core API，我们需要定义表和列。

from sqlalchemy import Table, Column, Integer, String
# 定义表
user_table = Table('users', Column('id', Integer, primary_key=True), Column('name', String))
# 创建表
user_table.create(engine)

3. 插入数据

插入数据使用 insert 构造器。

from sqlalchemy import insert
# 创建插入语句
insert_statement = insert(user_table).values(name='Alice')
# 执行语句
with engine.connect() as conn:
    result = conn.execute(insert_statement)

4. 查询数据

查询数据使用 select 构造器。

from sqlalchemy import select
# 创建查询语句
select_statement = select([user_table])
# 执行查询
with engine.connect() as conn:
    result = conn.execute(select_statement)
    for row in result:
        print(row)

5. 更新和删除数据

更新和删除操作分别使用 update 和 delete 构造器。

from sqlalchemy import update, delete
# 创建更新语句
update_statement = update(user_table).where(user_table.c.name == 'Alice').values(name='Alice Smith')
# 创建删除语句
delete_statement = delete(user_table).where(user_table.c.name == 'Alice')
# 执行更新和删除
with engine.connect() as conn:
    conn.execute(update_statement)
    conn.execute(delete_statement)

6. 事务

在 SQLAlchemy 中，事务是通过 Connection 对象管理的。

with engine.connect() as conn:
    with conn.begin():
        conn.execute(insert_statement)
        conn.execute(update_statement)

这些代码案例展示了 SQLAlchemy Core 的基本用法，包括连接数据库、定义表、插入和查询数据、更新和删除数据以及事务处理。在实际应用中，你可能还需要处理更复杂的情况，如联合查询、子查询、连接操作等，但基本概念是相似的。