[python] SQLAlchemy와 Pyramid 웹 프레임워크 연동 방법

04 Dec 2023

python

안녕하세요! 이번에는 SQLAlchemy와 Pyramid 웹 프레임워크를 어떻게 연동하는지 알아보겠습니다. SQLAlchemy는 파이썬에서 가장 널리 사용되는 ORM(Object Relational Mapping) 라이브러리 중 하나로, 데이터베이스와의 상호작용을 쉽게 처리할 수 있도록 도와줍니다. Pyramid은 유연하고 확장성이 뛰어난 웹 프레임워크로, 다양한 웹 애플리케이션을 개발할 수 있습니다.

1. SQLAlchemy 설치

먼저, SQLAlchemy를 설치해야 합니다. 터미널에서 다음 명령을 실행하여 SQLAlchemy를 설치합니다.

pip install sqlalchemy

2. Pyramid 프로젝트 생성

Pyramid 프로젝트를 생성하기 위해 다음 명령을 실행합니다.

pcreate -s alchemy myproject

위 명령은 “myproject”라는 이름의 Pyramid 프로젝트를 생성합니다. 이때 -s alchemy 옵션을 사용하여 SQLAlchemy 관련 설정을 추가합니다.

3. 데이터베이스 설정

Pyramid 프로젝트 디렉토리로 이동한 후, development.ini 파일을 엽니다. 데이터베이스 설정을 하기 위해 다음 내용을 수정합니다.

[app:main]
use = egg:myproject

sqlalchemy.url = sqlite:///myproject.db

위 설정은 SQLite 데이터베이스를 사용하도록 설정한 것입니다. 다른 데이터베이스를 사용하려면 해당 데이터베이스의 URL을 입력하면 됩니다.

4. SQLAlchemy 모델 정의

Pyramid 프로젝트의 models.py 파일을 열고, SQLAlchemy 모델을 정의합니다. 예를 들어, 다음과 같이 사용자 모델을 정의할 수 있습니다.

from sqlalchemy import Column, Integer, String
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class User(Base):
    __tablename__ = 'users'

    id = Column(Integer, primary_key=True)
    username = Column(String)
    email = Column(String)

위 코드에서는 declarative_base() 함수를 사용하여 SQLAlchemy의 기본 클래스인 Base를 생성합니다. 모든 모델은 이 Base 클래스를 상속받아 정의되어야 합니다. User 모델은 users 테이블과 매핑되고, id, username, email은 해당 테이블의 컬럼으로 정의되었습니다.

5. 데이터베이스 마이그레이션

데이터베이스에 모델을 적용하기 위해 마이그레이션을 수행합니다. 터미널에서 다음 명령을 실행합니다.

pserve development.ini

위 명령을 실행하면 Pyramid 애플리케이션이 실행되고, SQLAlchemy가 자동으로 데이터베이스 마이그레이션을 수행합니다. 이 과정에서 모델에 정의된 테이블이 데이터베이스에 생성됩니다.

6. SQLAlchemy 사용

이제 SQLAlchemy를 사용하여 데이터베이스에 접근하고 조작할 수 있습니다. Pyramid 프로젝트의 라우트 함수 등에서 다음과 같이 SQLAlchemy 세션을 사용할 수 있습니다.

from pyramid.view import view_config
from .models import DBSession, User

@view_config(route_name='home', renderer='home.jinja2')
def home(request):
    # SQLAlchemy를 사용하여 데이터베이스에 쿼리를 실행합니다.
    users = DBSession.query(User).all()
    return {'users': users}

위 코드에서 DBSession은 SQLAlchemy의 세션을 나타내며, User는 이전에 정의한 모델입니다. DBSession.query(User).all() 처럼 SQLAlchemy의 쿼리를 사용하여 데이터베이스에 접근할 수 있습니다.

이와 같이 SQLAlchemy와 Pyramid를 연동하여 데이터베이스와 웹 애플리케이션을 효과적으로 개발할 수 있습니다. SQLAlchemy의 강력한 기능과 Pyramid의 유연성을 함께 사용하면 다양한 웹 프로젝트를 개발하는데 도움이 될 것입니다.

더 자세한 내용은 다음 문서들을 참고해주세요.