정보

[Mac] DBeaver에서 SQL 포맷을 변경하는 방법 – 복잡한 한줄 쿼리도 깔끔하게 정리하자!

mindlab091909 2025. 5. 9. 15:49
반응형

 

SQL 쿼리를 다룰 때 가장 중요한 것 중 하나는 바로 가독성입니다. 특히 스프링 프레임워크 기반의 로그에서 복사한 SQL은 대부분 한 줄로 출력되어 매우 읽기 불편합니다. 쿼리가 짧다면 문제가 없지만, 조인(join), 서브쿼리(subquery), 조건절(where)이 복잡하게 얽혀 있는 경우에는 한눈에 파악하기 어려워 디버깅 시간이 길어질 수 있습니다.

이럴 때 유용하게 쓸 수 있는 기능이 바로 DBeaver에서 제공하는 SQL 포맷 기능입니다. 이 포스트에서는 Mac 환경을 기준으로 DBeaver에서 SQL 쿼리 포맷을 적용하는 방법을 단계별로 상세히 설명하고, 포맷 전후의 차이와 함께 활용 팁도 함께 소개해 드리겠습니다.

1. 왜 SQL 포맷이 중요한가?

SQL 포맷을 적용하면 다음과 같은 효과를 기대할 수 있습니다.

  • ✅ 가독성 향상: 여러 줄로 보기 좋게 정리되어 쿼리 구조가 한눈에 들어옵니다.
  • ✅ 디버깅 효율 증가: 조건이나 조인 대상이 명확하게 보이므로 오류를 빠르게 찾을 수 있습니다.
  • ✅ 팀 협업에 유리: 잘 정리된 SQL은 협업 시 공유하거나 리뷰할 때 큰 도움이 됩니다.
  • ✅ SQL 성능 튜닝에도 유용: 포맷된 쿼리는 성능 병목 구간을 파악하기 쉽습니다.

2. DBeaver SQL 포맷 메뉴 위치 (Mac 기준)

DBeaver는 기본적으로 SQL 포맷 기능을 내장하고 있으며, 메뉴에서 바로 사용할 수 있습니다. 포맷을 적용하는 방법은 매우 간단합니다.

🛠️ 메뉴에서 포맷 적용하기

  1. DBeaver를 실행합니다.
  2. SQL Editor에서 포맷하고 싶은 SQL을 작성하거나 붙여넣습니다.
  3. 상단 메뉴에서 편집(Edit) → Format SQL을 클릭합니다.


(이미지는 예시이며 실제 인터페이스와 다를 수 있습니다.)

SQL이 자동으로 들여쓰기되고, 줄바꿈이 적용되어 훨씬 보기 좋아진 것을 확인할 수 있습니다.

3. 단축키로 빠르게 SQL 포맷하기 (Mac)

반복해서 포맷 기능을 사용하다 보면 매번 메뉴를 찾기 번거롭습니다. 이럴 땐 단축키를 활용하면 작업 속도를 높일 수 있습니다.

💻 단축키: Control + Shift + F

이 키 조합을 사용하면 SQL Editor 창에서 선택한 쿼리에 바로 포맷이 적용됩니다. 선택 영역이 없다면 전체 쿼리에 포맷이 적용됩니다.

⌨️ 단축키 팁: Windows 사용자의 경우 Ctrl + Shift + F 키를 사용하면 됩니다.

4. 포맷 적용 전/후 예시

📋 포맷 전 (스프링 로그에서 복사한 형태)

select * from member m inner join orders o on m.id = o.member_id where o.order_status = 'DELIVERED' and o.created_at > '2024-01-01';

✨ 포맷 후 (DBeaver Format SQL 적용 결과)

SELECT *
FROM member m
INNER JOIN orders o ON m.id = o.member_id
WHERE o.order_status = 'DELIVERED'
  AND o.created_at > '2024-01-01';

한 줄로 표현된 SQL 쿼리가 들여쓰기와 줄바꿈을 통해 논리 구조가 명확히 드러나면서 훨씬 가독성이 좋아졌습니다. 조건절이 줄바꿈되어 시각적으로도 명확해지고, 디버깅할 때도 빠르게 위치를 파악할 수 있습니다.

5. 포맷 설정 변경도 가능할까?

기본 포맷은 괜찮지만, 프로젝트 스타일에 맞게 조금 다르게 구성하고 싶은 경우도 있습니다. DBeaver에서는 어느 정도 포맷 방식을 사용자 설정으로 조정할 수 있습니다.

설정 경로:

  1. DBeaver > Preferences로 이동
  2. 좌측에서 Editors > SQL Editor > SQL Formatting 선택
  3. 들여쓰기, 대문자/소문자, 줄바꿈 설정 등을 변경 가능

예를 들어 다음과 같은 설정을 조정할 수 있습니다.

  • Keywords Case: SELECT → select (소문자 변환)
  • Indent Size: 기본값 4칸 → 2칸으로 변경
  • Line Breaks: WHERE 조건절마다 줄바꿈 적용 여부

이처럼 프로젝트 컨벤션에 따라 유연하게 포맷 정책을 설정할 수 있다는 점도 DBeaver의 장점 중 하나입니다.

6. 실전 활용 팁 3가지

① 쿼리 복사 전에 포맷 먼저!

스프링 로그에서 복사한 쿼리를 DBeaver에 붙여넣었다면, 실행 전에 먼저 포맷을 해보세요. 읽기도 쉬워지고, 오류도 쉽게 찾을 수 있습니다.

② 복잡한 쿼리는 선택 영역만 포맷!

한 화면에 여러 개의 쿼리가 있을 경우, 전체 포맷보다는 해당 쿼리 블록만 선택해서 포맷하면 불필요한 변형을 막을 수 있습니다.

③ 자주 쓰는 포맷 방식은 설정 저장!

팀에서 공통된 SQL 포맷 스타일이 있다면, Preferences 설정을 저장하고 팀원들과 공유해 동일한 포맷을 유지해보세요.

7. 마무리하며 – 읽기 쉬운 SQL이 생산성을 높인다

SQL은 단순히 "데이터를 가져오는 언어"가 아니라, 복잡한 조건을 정확히 기술하고 협업 중에도 명확히 공유되어야 할 중요한 커뮤니케이션 도구입니다. 특히 DBeaver처럼 강력한 기능을 제공하는 도구에서는 단축키와 포맷 기능을 잘 활용하는 것이 생산성의 핵심 포인트가 됩니다.

Mac 환경에서 DBeaver를 사용하시는 분들은 이번 포스트를 참고해 SQL 포맷 기능을 적극적으로 활용해보시기 바랍니다. 긴 쿼리도, 복잡한 조인도 한눈에 보기 쉬워지고, 실수도 줄어드는 경험을 하실 수 있을 것입니다.

🔁 요약 정리

항목 내용

포맷 기능 위치 편집(Edit) → Format SQL
Mac 단축키 Control + Shift + F
포맷 효과 줄바꿈, 들여쓰기, 대문자 키워드 적용
설정 변경 경로 Preferences > SQL Editor > SQL Formatting
추천 활용 스프링 로그 복사 쿼리 정리, 복잡한 조인 디버깅

SQL을 깔끔하게 정리하고 싶은가요?
지금 바로 Control + Shift + F를 눌러보세요!
읽기 쉬운 SQL, 더 나은 개발의 시작입니다.

 

반응형