將 Spanner 與 SQLAlchemy ORM (GoogleSQL 方言) 整合

SQLAlchemy 是 Python SQL 工具包和物件關聯對應工具。

適用於 SQLAlchemy 的 Spanner 方言可讓 SQLAlchemy 使用者使用 Spanner 資料庫。這個方言是以 Spanner API 為基礎建構，設計時遵循 PEP-249，並與 1.1.13 到 1.3.23 和 2.0 之間的 SQLAlchemy 版本相容。

PostgreSQL 介面注意事項： 如要搭配 SQLAlchemy 使用 Spanner 適用的 PostgreSQL 介面，請參閱「整合 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

如要驗證 SQLAlchemy 的 Spanner 方言，請在 GOOGLE_APPLICATION_CREDENTIALS 環境變數中提供服務帳戶 JSON 憑證檔案位置。否則，方言也可以使用在 gcloud CLI 應用程式中設定的預設憑證。

使用 SQLAlchemy 的 Spanner 方言

如要進一步瞭解可用的功能、方言的限制、方言使用建議和程式碼範例，請參閱 GitHub 上的參考說明文件。

後續步驟

• 如要瞭解如何使用 SQLAlchemy 的 Spanner 方言，請參閱程式碼範例。
• 前往 GitHub 查看 SQLAlchemy 的 Spanner 方言存放區。
• 如要回報錯誤或詢問有關 SQLAlchemy 的 Spanner 方言，請提出 GitHub 問題。
• 進一步瞭解 SQLAlchemy。
• 進一步瞭解 PyPI。
• 請參閱「開始使用驗證功能」，瞭解授權和驗證憑證。