将 Spanner 与 SQLAlchemy ORM（GoogleSQL 方言）集成

SQLAlchemy 就是一个 Python SQL 工具包兼对象 关系型映射器。

SQLAlchemy 的 Spanner 方言允许 SQLAlchemy 用户使用 Spanner 数据库。方言基于 Spanner API 构建，该 API 根据 PEP-249 设计，并与 SQLAlchemy 版本 1.1.13 到 1.3.23 和 2.0 兼容。

PostgreSQL 界面备注： 如需将 Spanner 的 PostgreSQL 页面与 SQLAlchemy 搭配使用，请参阅将 Spanner 与 SQLAlchemy 2 ORM (PostgreSQL-dialect) 集成。

为 SQLAlchemy 设置 Spanner 方言

如需在应用中为 SQLAlchemy 设置 Spanner 方言，请安装 sqlalchemy-spanner package。

pip3 install sqlalchemy-spanner

或者，您也可以通过源代码安装。

git clone https://github.com/googleapis/python-spanner-sqlalchemy.git
cd python-spanner-sqlalchemy
python setup.py install

作为 SQLAlchemy 的 Spanner 方言的身份验证方法，请在 GOOGLE_APPLICATION_CREDENTIALS 环境变量中提供服务账号 JSON 凭据文件位置。否则，方言还可以使用在 gcloud CLI 应用中设置的默认凭据。

使用适用于 SQLAlchemy 的 Spanner 方言

如需详细了解可用功能、该方言的限制、有关如何使用该方言的建议以及代码示例，请参阅 GitHub 上的参考文档。

后续步骤

• 请参阅代码示例，了解如何使用 SQLAlchemy 的 Spanner 方言。
• 查看 SQLAlchemy 的 Spanner 方言代码库 GitHub。
• 提交 GitHub 问题以报告 bug 或提出有关适用于 SQLAlchemy 的 Spanner 方言的问题。
• 详细了解 SQLAlchemy。
• 详细了解 PyPI。
• 在身份验证入门中了解授权和身份验证凭据。