Rails 애플리케이션 개발 시 대부분의 쿼리는 Active Record를 통해 처리되지만, 특정 복잡한 시나리오에서는 순수 SQL 쿼리 작성이 불가피할 수 있습니다. 이러한 상황에서 ORM(Object-Relational Mapping)의 핵심 이점 중 하나인 데이터베이스 불가지론(database agnosticism)을 유지하는 것이 중요합니다. 특히, BOOLEAN 타입 컬럼을 순수 SQL로 다룰 때 데이터베이스별 내부 구현 방식의 차이로 인해 예기치 않은 호환성 문제가 발생할 수 있습니다.
데이터베이스 간의 BOOLEAN 컬럼 처리 방식은 현저한 차이를 보입니다. 예를 들어, Post.where("published = 1").to_sql와 같은 쿼리는 MySQL에서는 정상적으로 작동하지만, PostgreSQL에서는 PG::UndefinedFunction: ERROR: operator does not exist: boolean = integer와 같은 오류를 발생시킵니다. 이는 MySQL이 BOOLEAN 타입을 내부적으로 TINYINT(1)로, SQLite는 INTEGER로 매핑하여 TRUE를 1, FALSE를 0으로 간주하기 때문입니다. 이러한 데이터베이스들은 정수형 비교를 허용하여 published = 1과 같은 쿼리가 유효합니다. 반면, PostgreSQL은 독립적인 BOOLEAN 타입을 지원하며, 따라서 BOOLEAN 컬럼은 반드시 TRUE 또는 FALSE 리터럴과 비교되어야 합니다.
이러한 호환성 문제를 해결하기 위한 최적의 방안은 TRUE와 FALSE 리터럴을 사용하는 것입니다. 다행히 TRUE와 FALSE는 MySQL과 SQLite에서도 각각 1과 0의 별칭으로 인식되므로, Post.where("published = TRUE").to_sql와 같이 작성하면 PostgreSQL, MySQL, SQLite 세 가지 주요 데이터베이스에서 모두 호환 가능한 쿼리를 작성할 수 있습니다. 또한, 1 또는 0 대신 TRUE 또는 FALSE를 사용함으로써 쿼리의 가독성을 크게 향상시킬 수 있습니다. 이는 해당 컬럼이 BOOLEAN 타입임을 명확히 전달하여, 추후 쿼리를 분석하는 개발자가 컬럼의 의도를 즉시 파악하는 데 도움을 줍니다. 특히 컬럼 이름만으로는 그 의도가 모호할 수 있는 경우에 이러한 명시적인 BOOLEAN 리터럴 사용은 코드 유지보수성을 높이는 데 기여합니다.
결론적으로, Rails 애플리케이션에서 BOOLEAN 컬럼과 관련된 순수 SQL 쿼리를 작성할 때는 데이터베이스 호환성과 코드 가독성을 동시에 확보하기 위해 `TRUE` 또는 `FALSE`와 같은 BOOLEAN 리터럴을 일관되게 사용하는 것이 필수적입니다. 이러한 접근 방식은 PostgreSQL, MySQL, SQLite 등 다양한 데이터베이스 환경에서 쿼리의 안정적인 작동을 보장하며, 미래 개발자들에게 컬럼의 타입과 의도를 명확하게 전달하여 효율적인 협업과 유지보수를 가능하게 합니다. 이는 견고하고 유연한 Rails 애플리케이션을 구축하는 데 중요한 실천 사항입니다.