将 Spanner 与 SQLAlchemy 2 ORM 集成（PostgreSQL 方言）

SQLAlchemy 2 即可用作 Python SQL 工具包，又可用作对象关系映射器 (ORM)。

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

设置 SQLAlchemy 2 以便与 Spanner PostgreSQL 方言数据库搭配使用

  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 与 PostgreSQL 搭配使用的相关文档。

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

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

后续步骤

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