Parámetros de consulta
Los parámetros de consulta te permiten redactar una consulta con marcadores de posición y sustituir sus valores al ejecutarla, por ejemplo:
SELECT * FROM orders
WHERE status = :status AND total > :min_total;
Cuando ejecutas esta consulta, TablePlus solicita los valores de :status y :min_total, reemplaza los marcadores de posición y envía la consulta final al servidor.
Habilitar parámetros de consulta
Los parámetros de consulta están desactivados por defecto. Para activarlos, haz clic en el botón SQL Editor settings (icono de engranaje) en la parte inferior izquierda del editor y seleccione Query params options > Enable query params.
También se pueden activar con Enable query params en Settings > Editor. 1
Complete los valores
Cuando ejecutas una consulta que contiene parámetros, la ventana Variables se abre con una fila por cada parámetro. Introduce los valores y haz clic en Apply (⌘ + Return).
Los valores se insertan en la consulta exactamente como los escribes, por lo tanto, añade comillas para las cadenas de texto, por ejemplo, 'shipped'.
TablePlus recuerda los valores que has introducido y los completa la próxima vez. Para eliminar las variables guardadas que ya no utilices, selecciónalas y haz clic en Cleanup.

Modifique el formato del parámetro
Selecciona Query params options > Change query params format para elegir la sintaxis de marcador. La ventana muestra un ejemplo del formato seleccionado.
| Formato | Ejemplo |
|---|---|
| Colón | SELECT * FROM orders WHERE id = :id |
| Porcentaje | SELECT * FROM orders WHERE id = %id% |
| Signo de interrogación | SELECT * FROM orders WHERE id = ? |
| El dólar se prepara. | SELECT * FROM orders WHERE id = ${id} |
| Dólar | SELECT * FROM orders WHERE id = $id |
| Corchetes dobles | SELECT * FROM orders WHERE id = {{id}} |
De forma predeterminada, TablePlus ignora los marcadores de posición dentro de cadenas entre comillas. Para encontrarlos también, activa la opción Allow searching for variables in quoted strings.

Buscando los comentarios que generan un gráfico a partir de una consulta, como
-- tableplus barchart x: a, y: b? Ver Trabajar con los resultados de consultas.
-
En Windows y Linux, abre la configuración con
Ctrl + ,. ↩︎