쿼리 매개변수
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 을 참조하세요.
-
Windows 와 Linux 에서
Ctrl + ,을 선택하여 선호도 설정을 엽니다. ↩︎