将 Spanner 与 SQLAlchemy 2 ORM(PostgreSQL 方言)集成

SQLAlchemy 2 是一个 Python SQL 工具包,又是一个对象关系映射器 (ORM)。

您可以将 SQLAlchemy 2 ORM 与标准 PostgreSQL psycopg3 驱动程序和 PGAdapter 结合使用。

使用 Spanner PostgreSQL 方言数据库设置 SQLAlchemy 2

  1. 确保 PGAdapter 与使用 SQLAlchemy 2 与 Spanner 建立连接的应用在同一机器上运行。

    如需了解详情,请参阅启动 PGAdapter

  2. 将 SQLAlchemy 2 和 psycopg3 添加到 requirements.txt 文件中。

    psycopg~=3.1.8
    sqlalchemy~=2.0.1
    
  3. 在 SQLAlchemy 2 连接字符串中指定 postgresql+psycopglocalhost5432 作为数据库方言、驱动程序、服务器主机和端口。psycopg3 要求在连接字符串中包含用户名和密码。PGAdapter 会忽略这些项。

    (可选)如果 PGAdapter 配置为在默认 PostgreSQL 端口 (5432) 以外的端口上进行监听,请指定其他端口号。

    conn_string = "postgresql+psycopg://user:password@localhost:5432/my-database"
    engine = create_engine(conn_string)
    

如需了解 PostgreSQL 的更多连接选项,请参阅有关 PostgreSQL 的 SQLAlchemy 2 文档

将 SQLAlchemy 2 与 PostgreSQL 方言数据库搭配使用

如需详细了解具有 PostgreSQL 方言数据库的 SQLAlchemy 2 的功能和建议,请参阅 GitHub 上的参考文档

后续步骤