Editor de consultas

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.

La ventana de variables con valores para dos parámetros.
Introduzca los valores de los parámetros.

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.

Opciones de los parámetros de consulta
Opciones de parámetros de consulta

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.


  1. En Windows y Linux, abre la configuración con Ctrl + ,. ↩︎