쿼리 편집기

쿼리 매개변수

Query parameters 를 사용하면 플레이스홀더를 포함한 쿼리를 작성한 후 실행할 때 해당 값들을 채울 수 있습니다. 예를 들어:

SELECT * FROM orders
WHERE status = :status AND total > :min_total;

이 쿼리를 실행하면 TablePlus 는 :status 과 :min_total 의 값을 요청하고, 자리 표시자를 대체한 최종 쿼리를 서버로 보냅니다.

쿼리 매개변수 활성화

기본적으로 쿼리 매개변수는 비활성화되어 있습니다. 활성화하려면 편집기 왼쪽 하단의 SQL Editor settings 버튼 (기어 아이콘) 을 클릭한 후 Query params options > Enable query params 를 선택하세요.

또한 Settings > Editor 에서 Enable query params 를 켤 수 있습니다. 1

값을 입력하세요

파라미터가 포함된 쿼리를 실행하면 Variables 창이 열리고 각 파라미터마다 한 줄씩 표시됩니다. 값을 입력한 후 Apply (⌘ + Return)를 클릭하세요.

입력하신 값들이 쿼리에 정확히 그대로 입력되므로, 문자열의 경우 따옴표를 사용하여 입력해야 합니다. 예를 들어, 'shipped'.

TablePlus 는 입력한 값을 기억하여 다음 사용 시 자동으로 채웁니다. 더 이상 사용하지 않는 변수를 삭제하려면 해당 변수를 선택하고 Cleanup를 클릭하세요.

두 개의 파라미터에 대한 값으로 표시된 변수 창
매개변수 값을 입력하세요.

파라미터 형식을 변경하세요

Query params options > Change query params format을 선택하여 placeholder 구문을 선택합니다. 이 창에는 선택된 형식의 예시가 표시됩니다.

형식 예시
콜론 SELECT * FROM orders WHERE id = :id
퍼센트 SELECT * FROM orders WHERE id = %id%
물음표 SELECT * FROM orders WHERE id = ?
대괄호 SELECT * FROM orders WHERE id = ${id}
달러 SELECT * FROM orders WHERE id = $id
중괄호 두 개 SELECT * FROM orders WHERE id = {{id}}

기본적으로 TablePlus 는 따옴표 안의 변수를 무시합니다. 따옴표 안의 변수도 검색하려면 Allow searching for variables in quoted strings 옵션을 켜야 합니다.

쿼리 파라미터 옵션 창
쿼리 파라미터 옵션

-- tableplus barchart x: a, y: b 차트를 그리는 주석을 찾고 계십니까? Working With Query Results 을 참조하세요.


  1. Windows 와 Linux 에서 Ctrl + , 을 선택하여 선호도 설정을 엽니다. ↩︎