SQL 파라미터 바인더

SQL 파라미터 바인더 사용 가이드

애플리케이션 로그에는 WHERE category = :category처럼 자리표시자가 남은 쿼리와 값이 따로 찍히는 경우가 많습니다. 이 도구는 두 번째 칸에 적은 이름=값을 각 :이름 자리에 넣어 DB 도구에서 바로 실행해 볼 수 있는 쿼리를 만듭니다.

자리표시자는 SQL 문법을 따라 찾습니다. 'a:b' 같은 문자열 안, -- 와 /* */ 주석 안, PostgreSQL의 ::text 캐스트는 자리표시자로 보지 않으므로 엉뚱한 곳이 바뀌어 쿼리가 깨지지 않습니다.

숫자는 따옴표 없이, true·false·null은 TRUE·FALSE·NULL로, 나머지는 작은따옴표로 감싸 넣고 값 속 작은따옴표는 두 번 씁니다. 007처럼 문자열로 남겨야 하는 값은 '007'로 적으면 됩니다. 결과 끝의 주석 줄에 넣은 값, 값이 없는 자리, 쓰이지 않은 값이 정리됩니다.

사용 방법

1. 1'SQL' 칸에 :이름 자리표시자가 있는 쿼리를 붙여 넣습니다.
2. 2'값' 칸에 category=dev처럼 이름=값을 한 줄에 하나씩 적습니다. 문자열로 남길 숫자는 따옴표로 감쌉니다.
3. 3'실행'을 누르고 끝의 '-- 바인딩 · 값 없음 · 쓰이지 않은 값' 줄로 빠진 값이 없는지 확인합니다.

SELECT * FROM tools WHERE category = :category AND score >= :score AND note <> 'a:b';
---
category=dev
score=80

SELECT * FROM tools WHERE category = 'dev' AND score >= 80 AND note <> 'a:b';

-- 바인딩: category, score · 값 없음: 없음 · 쓰이지 않은 값: 없음

이럴 때 쓰면 좋아요

• 애플리케이션 로그의 쿼리와 파라미터를 합쳐 DB 콘솔에서 다시 실행할 때
• 느린 쿼리를 실제 값으로 바꿔 EXPLAIN으로 실행 계획을 볼 때
• 버그 리포트에 재현 가능한 완성 쿼리를 첨부할 때
• MyBatis·JPA 등의 이름 있는 파라미터 쿼리를 수동으로 시험할 때

문제가 생겼을 때

활용 팁

• ?나 $1 같은 순번 자리표시자는 바꾸지 않습니다. 이름 있는 :name 형식만 처리합니다.
• 만든 쿼리는 실제 값이 문자열로 들어간 것이므로 운영 코드에 그대로 쓰지 말고 확인용으로만 쓰세요. 코드에서는 바인딩을 유지해야 SQL 인젝션을 막을 수 있습니다.

자주 묻는 질문