クエリパラメータ
クエリパラメータを使用すると、プレースホルダーを含むクエリを作成し、実行時に値を指定できます。例えば:
SELECT * FROM orders
WHERE status = :status AND total > :min_total;
このクエリを実行すると、TablePlus は :status と :min_total の値を要求し、プレースホルダーを置き換えて最終的なクエリをサーバーに送信します。
クエリパラメータを有効にする
デフォルトでは、クエリパラメータは無効になっています。有効にするには、エディタの左下にある「SQL Editor settings」(歯車アイコン)をクリックし、「Query params options」>「Enable query params」を選択してください。
Enable query params を Settings > Editor でオンにすることもできます。1
値を入力してください
パラメータを含むクエリを実行すると、Variablesウィンドウが開き、各パラメータに対応する 1 行が表示されます。値を入力し、Apply (⌘ + Return) をクリックしてください。
入力された値は、そのままクエリに挿入されます。文字列の場合は、例 'shipped' のようにダブルクォートで囲んでください。
TablePlus は入力した値を記憶し、次回に自動入力します。使用しなくなった変数を削除するには、それらを選択してCleanupをクリックしてください。

パラメータ形式を変更します
Query params options > Change query params format を選択してプレースホルダーの形式を選択します。このウィンドウには、選択された形式の例が表示されます。
| 形式 | 例 |
|---|---|
| コロン | 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を参照してください。詳細は クエリ結果の操作 をご覧ください。
-
Windows および Linux では、
Ctrl + ,を選択して Preferences を開きます。 ↩︎