화면: SQL 편집기

바인드 파라미터

SQL 에 값 자리를 두고 실행하면 바인드 파라미터 입력 창이 열려 자리마다 값을 묻습니다. 같은 SQL 을 값만 변경해 여러 번 실행할 때 사용합니다. 값이 SQL 에 어떻게 들어가는지(바인딩과 직접 치환)는 SQL 실행과 트랜잭션 에서 설명합니다.

사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트

화면 구성

번호이름설명
1파라미터 칸SQL 의 값 자리입니다. ? 는 몇 번째 자리인지 번호가 붙고, :이름 과 #{이름} 은 이름이 보입니다. 같은 이름이 여러 번 나와도 한 줄만 있습니다.
2컬럼 칸자리와 비교하거나 값을 넣는 컬럼과 DB 타입입니다. WHERE, INSERT 의 컬럼 목록, UPDATE 의 SET 에서 찾습니다. 찾지 못하면 — 로 보입니다.
3타입 칸값의 타입입니다. 찾은 컬럼의 DB 타입에 맞춰 미리 선택해 두고, 찾지 못하면 String 항목입니다. 아래 표에서 설명합니다.
4값 칸넣을 값입니다. 타입이 Date, Timestamp 이면 달력 아이콘으로 날짜를 선택합니다.
5미리보기지금 적은 값을 SQL 에 넣어 본 모양입니다. 실행되는 SQL 이 아닙니다(아래 '미리보기와 실제 실행').
6실행 버튼값을 확정하고 실행합니다. 창 안에서 Enter 를 눌러도 됩니다.

사용할 수 있는 문법

문법예값이 들어가는 방법
?WHERE customer_id = ?바인딩
:이름WHERE status = :status바인딩. 이름은 영문자나 _ 로 시작합니다
? 와 :이름 을 함께 사용WHERE customer_id = ? AND status = :status바인딩. 창에는 나온 순서대로 보입니다
MyBatis #{이름}WHERE order_id = #{orderId}바인딩. #{id, jdbcType=INTEGER} 처럼 작성하면 쉼표 앞의 이름만 사용합니다
MyBatis ${이름}ORDER BY ${column}SQL 글자에 그대로 넣습니다. 타입 칸에 직접 치환 표시가 붙습니다
  • 작은따옴표 문자열, 주석, PostgreSQL 의 $$ 본문 안에 있는 ?, :이름 은 값 자리로 보지 않습니다.
  • PostgreSQL 의 형 변환 ::int 와 JSON 연산자 ?|, ?& 는 값 자리가 아닙니다. 컬럼이나 괄호 바로 뒤에 오고 뒤에 문자열이 이어지는 ?(data ? 'key')도 JSON 의 키 존재 연산자로 보고 값 자리로 읽지 않습니다.
  • Oracle 트리거 본문의 :NEW.컬럼, :OLD.컬럼 은 값 자리가 아닙니다.

타입

타입넣는 값
String문자열
Number숫자
BooleanTRUE 항목이나 FALSE 항목을 선택합니다
DateYYYY-MM-DD
TimestampYYYY-MM-DD HH:mm:ss
NULL값 칸 없이 NULL 을 넣습니다
Expression적은 글자를 SQL 에 그대로 넣습니다. now(), 시퀀스의 다음 값처럼 DB 가 계산할 식에 사용합니다. ?, :이름 에서만 선택할 수 있습니다

값을 넣고 실행하기

  1. SQL 탭에 값 자리가 있는 SQL 을 적습니다. 예: SELECT * FROM orders WHERE customer_id = :customerId AND status = :status
  2. Execute 버튼이나 Run Script 버튼을 클릭합니다. 바인드 파라미터 입력 창이 열립니다.
  3. 줄마다 타입 칸과 값 칸을 채웁니다.
  4. 미리보기 영역에서 값이 들어갈 자리를 확인하고 실행 버튼을 클릭합니다.
  • 값 자리가 없는 SQL 은 창 없이 바로 실행합니다.
  • 커넥션 프로파일의 보호 모드는 값을 넣은 SQL 로 판단합니다. Execute 버튼으로 실행할 때는 위험 SQL 확인 도 값을 넣은 SQL 로 합니다.
  • 결과 탭에는 값을 넣은 미리보기 모양의 SQL 이 보입니다.
  • 입력한 값은 같은 SQL 탭 안에서 기억해, 다음에 창이 열리면 미리 기입해 둡니다. 이름 자리는 이름으로 기억해 다른 문장에도 채웁니다. ? 자리는 몇 번째 자리인지밖에 없으므로 같은 SQL 을 다시 실행할 때만 채웁니다. 탭을 닫으면 사라집니다.

미리보기와 실제 실행

창의 미리보기는 값을 SQL 글자에 끼워 보여 줄 뿐입니다. 실제 실행은 SQL 과 값을 따로 보내는 PreparedStatement 바인딩입니다 (미리보기일 뿐이며 실제 실행은 PreparedStatement 바인딩으로 처리됩니다.).

미리보기실제 실행
?, :이름, #{} 자리값을 SQL 리터럴로 넣어 보입니다. 문자열과 날짜는 작은따옴표로 감쌉니다모든 자리를 ? 로 변경하고 값을 순서대로 바인딩합니다. 같은 :이름 이 두 번 나오면 같은 값을 두 번 바인딩합니다
${} 자리, Expression 타입적은 글자를 그대로 넣어 보입니다적은 글자를 그대로 SQL 에 넣고 실행합니다
긴 값, 여러 줄 값첫 줄의 앞 60자까지만 보이고 뒤는 … 입니다값 전체를 사용합니다
  • 바인딩한 값은 SQL 글자가 되지 않으므로, 값 안에 작은따옴표가 있어도 SQL 이 깨지지 않습니다.
  • ${} 자리나 Expression 타입이 하나라도 있으면 창에 $ 치환·Expression 타입 파라미터는 PreparedStatement 바인드가 아니라 SQL 에 값이 그대로 삽입됩니다. 안내가 보입니다. 값이 비어 있으면 실행 버튼을 클릭할 수 없습니다.

Run Script 에서 값 묻기

Run Script 버튼으로 여러 문장을 실행하면 모든 문장의 값 자리를 창 하나에서 한 번에 묻습니다. 미리보기에는 문장들이 이어져 보입니다.

  • ? 의 번호는 스크립트 전체에서 이어집니다. 첫 문장에 ? 가 두 개, 둘째 문장에 하나 있으면 둘째 문장의 ? 는 3번입니다.
  • 같은 :이름 이 여러 문장에 나오면 한 번만 묻고 모든 문장에 같은 값을 사용합니다.
  • 문장 가운데 하나라도 MyBatis 문법을 사용하면 Expression 타입은 선택할 수 없습니다.

주의할 점

  • MyBatis 문법(#{}, ${})을 사용한 문장에서도 ? 는 값 자리로 함께 묻습니다. :이름 은 값 자리로 보지 않고 SQL 에 그대로 남기니 한 문장에 섞어 사용하지 마세요.
  • 연산자로 표기한 ? 가 위 규칙에 맞지 않아 값 자리로 읽혔으면 타입을 Expression 항목으로 선택하고 원래 글자 ? 를 그대로 적으세요. SQL 이 변경되지 않습니다.
  • ${} 자리와 Expression 타입의 값은 바인딩을 거치지 않고 SQL 이 됩니다. 다른 사람에게 받은 값을 넣기 전에 미리보기로 SQL 을 확인하세요.
  • 결과 탭에 보이는 SQL 은 미리보기 모양이라 긴 값이 … 로 줄어 있을 수 있습니다. SQL 을 복사해 다시 실행하면 값이 다를 수 있습니다.

관련 화면