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

SQLAlchemy是一个 Python SQL 工具包，也是对象关系映射器。

适用于 SQLAlchemy 的 Spanner 方言让 SQLAlchemy 用户可以使用 Spanner 数据库。该方言基于 Spanner API 构建，该 API 按照 PEP-249 设计，并与 1.1.13 到 1.3.23 和 2.0 之间的 SQLAlchemy 版本兼容。

PostgreSQL 页面说明：如需将 Spanner 的 PostgreSQL 页面与 SQLAlchemy 搭配使用，请参阅将 Spanner 与 SQLAlchemy 2 ORM（PostgreSQL 方言）集成。

为 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

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

为 SQLAlchemy 使用 Spanner 方言

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

后续步骤

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