将 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-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 上的参考文档。

后续步骤

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