クエリエディタ

クエリパラメータ

クエリパラメータを使用すると、プレースホルダーを含むクエリを作成し、実行時に値を指定できます。例えば:

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をクリックしてください。

パラメータの2つの値が表示されている「変数」のウィンドウ
パラメータの値を入力してください。

パラメータ形式を変更します

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 を参照してください。詳細は クエリ結果の操作 をご覧ください。


  1. Windows および Linux では、Ctrl + , を選択して Preferences を開きます。 ↩︎