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 | 숫자 |
| Boolean | TRUE 항목이나 FALSE 항목을 선택합니다 |
| Date | YYYY-MM-DD |
| Timestamp | YYYY-MM-DD HH:mm:ss |
| NULL | 값 칸 없이 NULL 을 넣습니다 |
| Expression | 적은 글자를 SQL 에 그대로 넣습니다. now(), 시퀀스의 다음 값처럼 DB 가 계산할 식에 사용합니다. ?, :이름 에서만 선택할 수 있습니다 |
값을 넣고 실행하기
- SQL 탭에 값 자리가 있는 SQL 을 적습니다. 예:
SELECT * FROM orders WHERE customer_id = :customerId AND status = :status - Execute 버튼이나 Run Script 버튼을 클릭합니다. 바인드 파라미터 입력 창이 열립니다.
- 줄마다 타입 칸과 값 칸을 채웁니다.
- 미리보기 영역에서 값이 들어갈 자리를 확인하고 실행 버튼을 클릭합니다.
- 값 자리가 없는 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 을 복사해 다시 실행하면 값이 다를 수 있습니다.
관련 화면
- SQL 편집기: SQL 을 적고 실행하는 화면입니다.
- SQL 실행과 트랜잭션: 무엇이 실행되는지, 바인딩과 직접 치환의 차이입니다.
- 위험 SQL 확인: 값을 넣은 SQL 에 걸리는 확인 창입니다.
- SQL 이력과 저장된 SQL: 실행한 SQL 이 남는 곳입니다.