파라미터 바인딩

SQL에 포함된 파라미터를 자동으로 감지하고, 실행 전 값을 입력하는 방법을 안내합니다.

파라미터 자동 추출

SQL 안에 :파라미터명 형식의 바인드 변수가 포함되어 있으면 실행 시 자동으로 감지됩니다.

예시:

SELECT * FROM users WHERE id = :userId AND status = :status;

위 SQL을 실행하면 :userId:status가 파라미터로 추출되어 값 입력 모달이 나타납니다.

문자열 리터럴('...') 안이나 주석(-- ..., /* ... */) 안의 :은 파라미터로 인식되지 않습니다.

파라미터 입력 모달

파라미터가 감지되면 실행 전에 값을 입력하는 모달이 표시됩니다.

파라미터 입력 모달
항목설명
파라미터 이름SQL에서 추출된 :파라미터명이 표시됩니다.
타입 선택String, Number, NULL 중 선택합니다.
값 입력선택한 타입에 맞는 값을 입력합니다. NULL을 선택하면 값 입력이 비활성화됩니다.

타입에 따른 SQL 변환:

  • String: 값이 작은따옴표로 감싸집니다 → 'hello'
  • Number: 값이 그대로 삽입됩니다 → 42
  • NULL: NULL 키워드가 삽입됩니다

Execute 버튼을 클릭하면 파라미터가 치환된 SQL이 실행됩니다.

이전 값 저장 및 재사용

파라미터 입력 모달은 이전에 입력한 값과 타입을 기억합니다. 같은 파라미터명으로 다시 실행하면 이전 값이 자동으로 채워져 있어 반복 실행이 편리합니다.

TIP

같은 쿼리를 값만 바꿔가며 반복 테스트할 때 유용합니다. 이전 값이 자동으로 채워지므로 변경할 파라미터만 수정하면 됩니다.