将 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+psycopg、localhost 和 5432 指定为数据库方言、驱动程序、服务器主机和端口。psycopg3 要求连接字符串中包含用户名和密码。PGAdapter 会忽略这些。

    （可选）如果 PGAdapter 配置为监听默认 PostgreSQL 端口 (5432) 以外的端口，请指定其他端口号。

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

如需了解 PostgreSQL 的更多连接选项，请参阅 SQLAlchemy 2 with PostgreSQL 文档。

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

如需详细了解 SQLAlchemy 2 与 PostgreSQL 方言数据库搭配使用的功能和建议，请参阅 GitHub 上的参考文档。

后续步骤

  • 查看将 SQLAlchemy 2 与 PGAdapter 和 Spanner 搭配使用的示例应用。
  • 详细了解 SQLAlchemy。
  • 详细了解 PGAdapter。
  • 提交 GitHub 问题以报告 bug 或提出有关将 PGAdapter 与 SQLAlchemy 搭配使用时 Spanner 方言的问题。