1. Engine、Connection 与 Session

官方文档:

  • https://docs.sqlalchemy.org/en/14/tutorial/engine.html
  • https://docs.sqlalchemy.org/en/14/tutorial/dbapi_transactions.html






引擎(Engine)

创建任何 SQLAlchemy 应用程序,都需要先创建一个引擎(Engine)对象。该对象作为连接到特定数据库的中心源,为这些数据库连接提供一个工厂和一个称为连接池的保存空间。

引擎通常是一个全局对象,只为特定的数据库服务器创建一次,并使用一个 URL 字符串进行配置,描述它应该如何连接到数据库主机或后端。

在本教程中,我们将使用一个 SQLite 数据库。这是一种简单的测试方法,不需要预先设置一个实际存在的数据库。引擎是通过使用 create_engine() 方法创建的,指定 create_engine.future 参数为 True,这样我们就可以完全使用 2.0 风格的语法。

from sqlalchemy import create_engine
engine = create_engine('sqlite+pysqlite:///memory.db', echo=True, future=True)

create_engine() 方法的主要参数是一个字符串 URL,它定义了以下信息:

  1. 定义了要链接的数据库类型,本例是 sqlite

  2. 定义了使用什么 DBAPI,Python DBAPI 是一个第三方驱动,SQLAlchemy 用它来与一个特定的数据库进行交互,本例中使用的是 pysqlite

3.数据库存放的位置,本例中使用相对路径,将在根目录中创建 memory.db 数据库文件。

我们还指定了一个参数 create_engine.echoTrue,它会使标准 SQL 语句在终端中输出。






建立连接(Connection)

从面向用户的角度来看,引擎对象的唯一目的是提供一个与数据库的连接单元,称为 Connection。

我们的教程还没进入到 ORM 部分,所以下面例子中我们依然使用原生 SQL 语句(textual SQL)来操作数据库,text 方法可以让链接对象接受原生 SQL 语句。

下面是一个创建数据库链接,创建数据表(Table),并插入数据的例子。

from sqlalchemy import create_engine, text

engine = create_engine('sqlite+pysqlite:///memory.db', echo=True, future=True)


with engine.connect() as conn:
     conn.execute(text("CREATE TABLE some_table (x int, y int)"))
     conn.execute(
         text("INSERT INTO some_table (x, y) VALUES (:x, :y)"),
         [{"x": 1, "y": 1}, {"x": 2, "y": 4}]
     )
     conn.commit()

执行上述代码后,会在根目录创建 memory.db 数据库文件;CREATE TABLE 语句会新建 some_table 表;INSERT 语句定义了如何插入数据;Connection.commit() 方法提交上述对数据库的操作语句。

除了使用 commit 方法来提交改变之外,还可以使用 Engine.begin() 方法。

with engine.begin() as conn:
    conn.execute(text("CREATE TABLE some_table (x int, y int)"))
    conn.execute(text(
        "INSERT INTO some_table (x, y) VALUES (:x, :y)"), 
        [{"x": 1, "y": 1}, {"x": 2, "y": 4}]
    )

再看一个用 select 语句执行查找的例子:

with engine.connect() as conn:
    result = conn.execute(text("SELECT x, y FROM some_table"))
    for row in result:
        print(f"x: {row.x}  y: {row.y}")

输出:
x: 1  y: 1
x: 2  y: 4
使用参数

使用冒号来标记参数,本例中是 :y;将筛选出 y 小于 2 的行。

with engine.connect() as conn:
    result = conn.execute(
        text("SELECT x, y FROM some_table WHERE y < :y"),
        {"y": 2}
    )
    for row in result:
       print(f"x: {row.x}  y: {row.y}")
使用多个参数
with engine.connect() as conn:
    conn.execute(
        text("INSERT INTO some_table (x, y) VALUES (:x, :y)"),
        [{"x": 11, "y": 12}, {"x": 13, "y": 14}]
    )
    conn.commit()
把参数和语句绑定
stmt = text("SELECT x, y FROM some_table WHERE y > :y ORDER BY x, y").bindparams(y=2)
with engine.connect() as conn:
    result = conn.execute(stmt)
    for row in result:
       print(f"x: {row.x}  y: {row.y}")






使用 Session

上面举得使用 Connection 的例子在 ORM 中也能适用,但我们习惯上更多使用 Session。当使用 ORM 时,基本的数据库交互对象被称为 Session。在 SQLAlchemy 中,该对象的使用方式与 Connection 非常相似,事实上,在使用 Session 时,它在内部指的是 Connection

from sqlalchemy import create_engine, text
from sqlalchemy.orm import Session

stmt = text("SELECT x, y FROM some_table WHERE y > :y ORDER BY x, y").bindparams(y=2)
with Session(engine) as session:
    result = session.execute(stmt)
    for row in result:
       print(f"x: {row.x}  y: {row.y}")

你可能感兴趣的:(1. Engine、Connection 与 Session)