🎨 SQL 쿼리, 예술처럼 정렬하기: '하노이 탑 스타일' 완벽 가이드

서론: 복잡한 SQL 쿼리, 더 이상 두렵지 않아요!

길고 복잡하게 얽힌 SQL 쿼리 때문에 골머리를 앓아본 경험이 있으신가요? 수십 줄에 달하는 코드는 원하는 로직을 파악하기 어렵게 만들고, 사소한 오류 하나를 찾는 데에도 많은 시간을 쏟게 합니다. 이는 혼자만의 문제가 아닙니다. 동료와의 협업, 코드 리뷰, 그리고 미래의 나를 위한 유지보수 과정에서 큰 걸림돌이 되곤 하죠.

하지만 걱정하지 마세요! 이러한 문제를 해결하기 위한 독특하면서도 강력한 코드 정렬 방식, 바로 '하노이 탑 스타일'이 있습니다. 이 가이드를 통해 마치 예술 작품처럼 코드를 정렬하여 가독성을 획기적으로 높이는 방법을 배워보세요. 복잡했던 SQL 쿼리가 한눈에 들어오는 놀라운 경험을 하게 될 겁니다!

1. '하노이 탑 스타일'이란 무엇인가요?

'하노이 탑 스타일'은 이름처럼 독특한 접근 방식을 가진 SQL 정렬 기법입니다. 핵심은 코드의 구성 요소를 역할에 따라 명확히 구분하는 것입니다.

'하노이 탑 스타일'은 SQL문의 키워드(SELECT, FROM, WHERE 등)를 '동사'로, 그리고 그에 따르는 컬럼, 테이블, 조건 등을 '목적어'로 간주합니다. 이 둘을 시각적으로 분리하고 수직으로 정렬하여, 마치 하노이 탑처럼 계층적이고 깔끔한 구조를 만드는 방식입니다.

이 스타일의 가장 중요한 원칙은 바로 '동사-목적어 분리 원칙'입니다. 이 간단한 원칙 하나가 어떻게 코드의 구조를 명확하게 만들고, 우리의 눈을 편안하게 해주는지 다음 섹션에서 자세히 살펴보겠습니다.

 

728x90

2. 핵심 원리: 어떻게 동작하나요?

'하노이 탑 스타일'은 다음과 같은 5가지 핵심 원칙을 기반으로 동작합니다. 이 원칙들을 이해하면 어떤 쿼리든 일관된 스타일로 정렬할 수 있습니다.

1. 동사와 목적어 분리 SQL 키워드(SELECT, FROM, JOIN 등)를 '동사'로, 그리고 이 키워드가 다루는 대상(컬럼, 테이블, 조건 등)을 '목적어'로 간주하여 서로 다른 영역에 배치합니다.
2. 수직 정렬 모든 동사(키워드)는 왼쪽에 배치하고, 가장 긴 동사를 기준으로 가상의 수직선을 그어 모든 목적어가 그 선에 맞춰 시작되도록 정렬합니다. 이 수직선 덕분에 코드의 전체 구조가 한눈에 들어옵니다.
3. 최소 들여쓰기 불필요한 공백과 들여쓰기를 최소화하고, 키워드와 목적어를 단 하나의 스페이스(space)로 연결하여 간결하고 컴팩트한 구조를 유지합니다.
4. 줄 바꿈으로 계층 표현 SELECT, FROM, WHERE, GROUP BY 등 주요 절(Clause)은 각각 새로운 줄에서 시작하여 논리적인 단위를 명확하게 구분합니다. 이를 통해 쿼리의 실행 흐름을 쉽게 따라갈 수 있습니다.
5. 하노이 탑 모양 쿼리의 상위 구조인 SELECT, FROM 절은 넓게 시작하고, JOIN, WHERE 등의 하위 조건으로 내려갈수록 점차 좁아지는 계층적인 모양을 형성합니다. 이는 마치 '하노이 탑'을 연상시킵니다.

이 원칙들이 실제 코드에 적용되었을 때 어떤 강력한 장점을 발휘하는지, 지금부터 알아보겠습니다.

3. 왜 이 방식이 좋은가요? 가독성을 극대화하는 4가지 장점

'하노이 탑 스타일'을 도입하면 단순히 코드가 예뻐지는 것을 넘어, 개발 생산성을 높이는 실질적인 이점들을 얻을 수 있습니다.

• 가독성 극대화 쿼리의 흐름과 구조가 시각적으로 명확하게 분리되어 한눈에 들어옵니다. 눈이 자연스럽게 코드의 흐름을 따라가기 때문에 복잡한 로직에서도 혼란이 줄어들고, 동료가 작성한 쿼리도 쉽게 이해할 수 있습니다.
• 컴팩트한 구조 불필요한 공백이 사라져 코드가 훨씬 간결해집니다. 덕분에 긴 쿼리도 스크롤을 최소화하며 한 화면에서 전체 구조를 파악하기 용이해집니다.
• 디버깅 용이성 모든 요소가 수직으로 정렬되어 있기 때문에, 잘못된 조인 조건이나 누락된 컬럼 등이 정렬이 어긋나 보여 쉽게 눈에 띕니다. 문법적인 오류를 시각적으로 빠르게 찾아낼 수 있는 것이죠.
• 협업 효율성 팀원 모두가 동일한 포맷을 사용하면 코드의 일관성이 유지됩니다. 이는 코드 리뷰와 소통 시간을 단축시키고, 프로젝트 전체의 코드 품질을 높이는 데 기여합니다.

이제 말로만 듣던 '하노이 탑 스타일'의 강력함을 실제 코드를 통해 직접 확인해볼 시간입니다.

728x90

4. 백문이 불여일견: 예시로 보는 '하노이 탑 스타일'

'하노이 탑 스타일'에도 여러 변형이 있지만, 이 가이드에서는 불필요한 공백을 최소화하여 가독성과 간결함을 극대화하는 '단일 공백 수직 정렬(single-space vertical alignment)' 방식에 집중하겠습니다.

 

기존 SQL (일반 정렬)

SELECT
    e.employee_id,
    e.first_name,
    d.department_name
FROM
    employees e
JOIN
    departments d ON e.department_id = d.department_id
WHERE
    e.hire_date > '2010-01-01'
    AND d.location_id = 1700
ORDER BY
    e.employee_id;

✨ 하노이 탑 스타일

  SELECT e.employee_id
       , e.first_name
       , d.department_name
    FROM employees e
    JOIN departments d
      ON e.department_id = d.department_id
   WHERE e.hire_date > '2010-01-01'
     AND d.location_id = 1700
ORDER BY e.employee_id;

차이가 느껴지시나요? LEFT JOIN, GROUP BY, HAVING 등이 포함된 더 복잡한 쿼리에서도 이 스타일의 일관성과 가독성은 그대로 유지됩니다.

이 스타일이 제대로 보이기 위해서는 반드시 고정폭 폰트(fixed-width font)를 사용해야 합니다. D2Coding, Consolas, Fira Code와 같은 폰트는 모든 글자의 폭이 동일하여 완벽한 수직 정렬을 보장합니다.

이처럼 강력한 스타일을 실제 업무에 적용할 때, 몇 가지 유의할 점들을 마지막으로 짚어보겠습니다.

5. 적용 시 주의할 점

'하노이 탑 스타일'을 효과적으로 사용하기 위해 다음 4가지 사항을 기억해주세요.

• 일관성 유지 가장 중요한 원칙입니다. 팀 내 합의를 통해 모든 쿼리에 일관되게 스타일을 적용해야 합니다. 여러 스타일이 섞여 있으면 오히려 가독성을 해칠 수 있습니다.
• 도구 활용 긴 쿼리를 매번 수동으로 정렬하는 것은 비효율적입니다. SQL Developer, DBeaver, DataGrip과 같은 데이터베이스 도구의 코드 포맷팅 기능을 커스터마이징하여 이 스타일을 자동으로 적용하도록 설정하는 것을 강력히 추천합니다. 예를 들어, DataGrip에서는 'Code Style > SQL' 설정에서 키워드와 값 사이의 공백을 조절하고, 절(clause) 단위로 줄 바꿈을 강제하는 규칙을 설정할 수 있습니다.
• 쿼리 길이 관리 스타일이 아무리 좋아도 쿼리 자체가 수백 줄에 달한다면 가독성에 한계가 있습니다. 너무 긴 쿼리는 CTE(공통 테이블 표현식, WITH 절)를 사용해 논리적으로 분리하여 구조를 더 명확하게 만드는 것이 좋습니다.
• 과도한 최적화 피하기 코드를 지나치게 압축하면 오히려 가독성을 해칠 수 있습니다. '하노이 탑 스타일'의 핵심은 '명확함'입니다. 복잡한 로직이 포함된 부분에는 주석(--)을 활용하여 의도를 설명하는 것을 잊지 마세요.

결론: 코드도 디자인이다!

'하노이 탑 스타일'은 단순히 코드를 예쁘게 꾸미는 기법이 아닙니다. 이는 복잡한 정보를 명확한 구조로 재설계하여 가독성과 유지보수성을 극대화하는 실용적인 기술입니다. 잘 디자인된 코드는 버그를 줄이고, 협업을 원활하게 하며, 개발자에게 안정감과 자신감을 줍니다.

오늘 배운 원칙들을 꾸준히 연습하여 여러분만의 깔끔한 코드 스타일을 정립해보세요. 명확하고 아름다운 코드를 작성하는 개발자로 성장하며, 팀의 코드 품질과 협업 문화를 한 단계 끌어올리는 데 기여하시기를 응원합니다!