Flask-SQLAlchemy

Flask-SQLAlchemy에서 모델을 정의하는 것은 SQLAlchemy의 선언적 베이스를 사용하여 파이썬 클래스를 데이터베이스 테이블에 매핑하는 과정이다. 각 모델 클래스는 일반적으로 db.Model 클래스를 상속받아 생성되며, 클래스의 속성은 db.Column 인스턴스로 정의되어 데이터베이스 테이블의 컬럼이 된다. 컬럼 타입은 db.Integer, db.String, db.Text, db.DateTime 등을 사용하여 지정할 수 있으며, primary_key, unique, nullable 등의 인자를 통해 제약 조건을 설정한다.

예를 들어, 사용자 정보를 저장하는 User 모델과 블로그 글을 저장하는 Post 모델을 정의할 수 있다. User 모델은 사용자 아이디, 이름, 이메일을 필드로 가질 수 있으며, Post 모델은 글 아이디, 제목, 내용, 작성일시, 그리고 작성자를 나타내는 외래 키를 가질 수 있다. 이때 외래 키는 db.ForeignKey를 사용하여 설정하며, 이는 이후 관계 설정의 기초가 된다.

모델을 정의한 후에는 Flask 애플리케이션의 설정에 데이터베이스 URI를 지정하고, db.create_all() 메서드를 호출하면 정의된 모든 모델 클래스를 기반으로 데이터베이스에 실제 테이블이 생성된다. 이 방법은 개발 초기 단계나 소규모 프로젝트에 적합하며, 더 체계적인 데이터베이스 마이그레이션을 위해서는 Flask-Migrate 같은 확장을 함께 사용하는 것이 일반적이다.

Flask-SQLAlchemy를 사용하면 애플리케이션 내에서 데이터베이스를 쉽게 생성하고 관리할 수 있다. 데이터베이스 인스턴스는 SQLAlchemy 클래스로 생성되며, Flask 애플리케이션 객체와 연결된다. 이 과정에서 데이터베이스 연결 URI를 설정하며, 개발 단계에서는 SQLite와 같은 경량 데이터베이스를, 프로덕션 환경에서는 PostgreSQL이나 MySQL과 같은 더 강력한 시스템을 사용하는 것이 일반적이다. 데이터베이스 객체가 생성되면, 정의된 모든 모델을 기반으로 실제 데이터베이스 테이블을 만들기 위해 create_all() 메서드를 호출할 수 있다.

데이터베이스 스키마의 변경 사항을 관리하는 과정인 마이그레이션은 Flask-SQLAlchemy 단독으로는 완전히 처리되지 않는다. 대신, Flask-Migrate와 같은 확장 라이브러리가 일반적으로 이 역할을 담당한다. Flask-Migrate는 내부적으로 Alembic이라는 마이그레이션 도구를 사용하여, 모델 클래스의 변경사항(예: 새 컬럼 추가, 테이블 관계 수정)을 감지하고 이를 데이터베이스에 적용하기 위한 마이그레이션 스크립트를 자동 생성한다.

마이그레이션 워크플로우는 일반적으로 명령줄 인터페이스를 통해 이루어진다. flask db init 명령으로 마이그레이션 저장소를 초기화한 후, 모델을 변경할 때마다 flask db migrate 명령으로 변경사항을 감지해 스크립트를 생성한다. 최종적으로 flask db upgrade 명령을 실행하면 생성된 스크립트가 순차적으로 적용되어 데이터베이스 스키마가 최신 상태로 업데이트된다. 이 방식을 통해 버전 관리 시스템에서 코드를 관리하듯 데이터베이스 스키마의 변경 이력을 체계적으로 추적하고 관리할 수 있다.

Flask-SQLAlchemy를 사용한 CRUD(Create, Read, Update, Delete) 연산은 SQLAlchemy ORM의 강력한 기능을 Flask 애플리케이션 컨텍스트 내에서 직관적으로 수행할 수 있게 한다. 모든 연산은 db.session 객체를 통해 이루어지며, 이 세션은 데이터베이스 트랜잭션을 관리한다. 새로운 레코드를 생성(Create)하려면 먼저 정의된 모델 클래스의 인스턴스를 생성한 후, db.session.add() 메서드로 세션에 추가하고 db.session.commit()을 호출하여 데이터베이스에 영구적으로 저장한다. 여러 객체를 한 번에 추가하려면 add_all() 메서드를 사용할 수 있다.

데이터 조회(Read)는 쿼리 객체를 통해 이루어진다. Model.query 인터페이스를 사용하여 모든 레코드를 가져오거나(all()), 특정 조건으로 필터링(filter_by(), filter())하며, 단일 레코드를 조회(get(), first())할 수 있다. Flask-SQLAlchemy는 SQL 문법을 직접 작성하지 않고도 파이썬 코드로 복잡한 조회를 가능하게 한다. 업데이트(Update)는 조회된 모델 객체의 속성을 직접 변경한 후, db.session.commit()을 호출하는 것으로 간단히 처리된다.

삭제(Delete) 연산은 db.session.delete() 메서드에 대상 객체를 전달하고 commit()을 실행하면 된다. 모든 CRUD 연산에서 commit()을 호출하기 전까지의 변경 사항은 세션에 임시로 저장되며, 오류가 발생했을 때 db.session.rollback()을 사용하여 트랜잭션을 취소할 수 있다. 이 체계적인 세션 관리 방식은 데이터 무결성을 유지하고 애플리케이션의 데이터베이스 작업을 안정적으로 만드는 데 기여한다.

Flask-SQLAlchemy는 SQLAlchemy의 강력한 ORM 기능을 활용하여 데이터베이스 테이블 간의 관계를 쉽게 정의할 수 있도록 지원한다. 이를 통해 개발자는 복잡한 SQL 조인 문을 직접 작성하지 않고도, 파이썬 클래스와 객체 지향적인 방식으로 일대다, 일대일, 다대다 관계를 모델링할 수 있다.

관계 설정은 db.relationship() 함수를 사용하여 모델 클래스에 정의한다. 가장 일반적인 일대다 관계는 예를 들어, 한 명의 사용자가 여러 개의 게시글을 작성할 수 있는 경우에 사용된다. 작성자 모델에는 posts = db.relationship('Post', backref='author')와 같이 정의하고, 게시글 모델에는 작성자의 기본 키를 참조하는 외래 키를 author_id = db.Column(db.Integer, db.ForeignKey('user.id'))로 설정한다. backref 매개변수를 사용하면 게시글 객체에서 author 속성으로 작성자 객체에 역으로 접근할 수 있어 양방향 관계를 간편하게 구성할 수 있다.

다대다 관계는 중간 연결 테이블을 필요로 한다. Flask-SQLAlchemy에서는 db.Table을 사용하여 연결 테이블을 먼저 정의한 후, 양쪽 모델의 relationship() 정의에서 secondary 인자로 해당 테이블을 지정한다. 이는 태그와 게시글의 관계나 학생과 수업의 관계와 같은 시나리오에서 유용하게 적용된다.

관계를 정의할 때 lazy 매개변수를 통해 데이터 로딩 시점을 제어할 수 있다. 기본값인 'select'는 관계된 객체가 접근될 때 별도의 쿼리로 로드하는 반면, 'joined'는 주 쿼리에 조인을 통해 즉시 로드하도록 한다. 애플리케이션의 성능 요구사항에 따라 적절한 로딩 전략을 선택하는 것이 중요하다. 또한 cascade 옵션을 설정하여 부모 객체가 삭제될 때 자식 객체를 어떻게 처리할지 제어할 수 있어 데이터 무결성을 유지하는 데 도움이 된다.

Flask-SQLAlchemy는 SQLAlchemy의 강력한 쿼리 인터페이스를 Flask 애플리케이션에 편리하게 제공한다. 이를 통해 개발자는 복잡한 SQL 문을 직접 작성하지 않고도 파이썬 객체와 메서드를 사용하여 데이터베이스와 상호작용할 수 있다. 쿼리의 시작점은 모델 클래스의 query 속성이며, 이를 통해 다양한 조건을 체이닝 방식으로 추가하여 최종 쿼리를 구성한다.

기본적인 쿼리 연산에는 all(), first(), get(), filter(), filter_by(), order_by(), limit() 등이 있다. 예를 들어, User.query.filter_by(username='admin').first()는 사용자명이 'admin'인 첫 번째 사용자 객체를 반환한다. filter() 메서드는 더욱 유연한 조건을 지정할 수 있어, User.query.filter(User.email.like('%@example.com')).all()과 같은 쿼리를 작성할 수 있다.

고급 쿼리 기능으로는 조인, 집계 함수, 서브쿼리 등을 지원한다. 관계가 정의된 모델 간에는 join() 메서드를 명시적으로 사용하거나, 관계 속성을 통해 암시적으로 조인 쿼리를 수행할 수 있다. 또한 paginate() 메서드는 웹 애플리케이션에서 흔히 필요한 페이지네이션 기능을 간단히 구현하도록 돕는다. 이 메서드는 지정된 페이지 번호와 한 페이지당 항목 수를 기준으로 해당 페이지의 데이터와 메타정보를 함께 반환한다.

쿼리 인터페이스는 세션 관리도 자동으로 처리한다. 쿼리를 실행하여 얻은 결과 객체는 일반 파이썬 객체처럼 조작할 수 있으며, 변경 사항은 데이터베이스 트랜잭션 내에서 추적되어 커밋 시점에 일괄 반영된다. 이는 개발자가 직접 연결 풀이나 세션 생명 주기를 관리할 필요 없이 비즈니스 로직에 집중할 수 있게 한다.