Spanner を SQLAlchemy 2 ORM（PostgreSQL 言語）と統合する

SQLAlchemy は、Python SQL ツールキットと Object Relational Mapper（ORM）で構成されます。

SQLAlchemy 2 ORM は、標準の PostgreSQL psycopg3 ドライバおよび PGAdapter と組み合わせて使用できます。

Spanner の PostgreSQL 言語データベースを使用して SQLAlchemy 2 を設定する

  1. SQLAlchemy 2 と Spanner を使用して接続するアプリケーションと同じマシンで PGAdapter が実行されていることを確認します。

    詳細については、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 言語データベースを使用する

PostgreSQL 言語を使用した SQLAlchemy 2 の機能と推奨事項の詳細については、GitHub のリファレンス ドキュメントをご覧ください。

次のステップ