# Editor SQL

> El editor SQL de DuckDB de DuckLocal: pestañas de consulta, formato, errores en línea, autocompletado basado en el esquema, planes Explain, perfilado por operador y atajos.

Source: https://ducklocal.app/docs/es/sql-editor

Cada pestaña de consulta tiene su propio búfer de editor. El editor resalta SQL real mediante tree-sitter, indenta con 2 espacios y muestra números de línea.

## Pestañas

| Control | Qué hace |
| --- | --- |
| `+` o **⌘T** | Añade una pestaña de consulta nueva y le da el foco |
| Clic en una pestaña | Cambia a ella |
| **Ctrl+Tab** / **Ctrl+Shift+Tab** | La pestaña siguiente / anterior |
| **⌘1** … **⌘8**, **⌘9** | De la primera a la octava pestaña; ⌘9 es la última pestaña |
| Arrastrar una pestaña | La mueve a lo largo de la tira |
| `×`, **⌘W** o clic con el botón central | Cierra una pestaña. La última pestaña no se puede cerrar: su `×` está oculta y ⌘W no hace nada. Un panel con cambios sin guardar pregunta primero |
| Clic derecho en una pestaña | **Cerrar pestaña**, **Cerrar las demás pestañas**, **Cerrar las pestañas de la derecha**. Los paneles con cambios sin guardar siguen abiertos, y un aviso dice cuántos |
| Doble clic en una pestaña | Edita su título en el sitio. Enter o hacer clic fuera conserva el título nuevo, Escape conserva el antiguo; un título vacío vuelve a `Query N` |

Las pestañas abiertas vuelven en el siguiente arranque, en su orden: las pestañas de consulta con sus títulos y el SQL de sus editores, se haya ejecutado o no, y las pestañas de panel. Los resultados no; vuelve a ejecutar la consulta. Una pestaña de consulta que abres nueva empieza con `SELECT 'Hello, DuckLocal' AS greeting;`.

## La barra de herramientas

Encima del editor, de izquierda a derecha:

| Botón | Qué hace |
| --- | --- |
| **Ejecutar** | Ejecuta el SQL del editor; consulta [Ejecutar SQL](#running-sql) |
| **Detener** | Aparece cuando una ejecución lleva un rato en marcha; la interrumpe |
| **Formato** | Reformatea el SQL; consulta [Formato](#format) |
| **Explain** | Muestra el plan que usaría DuckDB, sin ejecutar la sentencia |
| **Perfil** | Ejecuta la consulta y muestra lo que costó cada operador |

**Explain** y **Perfil** se describen en [Explain y Perfil](#explain-and-profile).

## Ejecutar SQL

Pulsa **⌘↵** (Cmd+Enter) con el editor enfocado, o usa el botón **Ejecutar**.

Mientras una consulta se está ejecutando, pulsar ejecutar otra vez no hace nada (ni Explain ni Perfil), y junto a Ejecutar aparece un botón **Detener** cuando la consulta lleva un rato en marcha. Detener, o **⌘.**, interrumpe la consulta; termina con el error `Interrupted` de DuckDB, registrado en el historial como cualquier fallo. No hay tiempo de espera: sin Detener, una consulta se ejecuta todo lo que DuckDB necesite, y el resto del trabajo con la base de datos se pone en cola detrás de ella.

Los resultados llegan en flujo desde DuckDB, así que un escaneo se detiene cuando la tabla alcanza su [límite de filas](results-and-charts.md#row-limits) en lugar de leer el resto del archivo. Una consulta que necesita ver todas las filas antes de la primera (`ORDER BY`, `GROUP BY`, una agregación, una función de ventana) se calcula igualmente por completo.

Cada pestaña tiene sus propios resultados. Un resultado que llega después de haber cambiado de pestaña aterriza en la pestaña que lo ejecutó.

Cómo se trata una sentencia depende de su palabra clave inicial. `SELECT`, `WITH`, `SHOW`, `DESCRIBE`, `EXPLAIN`, `PRAGMA`, `SUMMARIZE`, `VALUES`, `FROM`, `TABLE`, `PIVOT` y `CALL` producen un conjunto de resultados. Todo lo demás (sentencias DDL (definición de datos) y DML (modificación de datos)) informa de `Done: N rows affected, took …` en lugar de mostrar una tabla. Los comentarios `--` iniciales se omiten al decidirlo; los comentarios de bloque no.

### Scripts

El editor puede contener varias sentencias. **Ejecutar** las ejecuta todas, en orden, tal como el shell de DuckDB lee un archivo, y **se detiene en el primer fallo**: ejecutar un `SELECT` después de un `ATTACH` fallido solo añadiría un segundo error engañoso. Una tira encima de los resultados lista las sentencias, cada una marcada con su número de filas, *hecha*, *fallida* o *no ejecutada*; haz clic en una para ver su resultado. Un error subraya la sentencia que falló, no todo el script.

Algunos comandos de punto del shell también funcionan, cada uno en su propia línea:

| Comando | Muestra |
| --- | --- |
| `.tables ?PATTERN?` | Tablas y vistas, opcionalmente filtradas por un patrón `ILIKE` como `stat%` |
| `.schema ?PATTERN?` | Las sentencias `CREATE` de tablas y vistas, opcionalmente filtradas |
| `.databases` | Las bases de datos adjuntas |
| `.help` | Esta lista |

Cualquier otro comando de punto (`.mode`, `.read`, …) es un error que nombra los que funcionan.

## Errores

Una sentencia fallida muestra una alerta titulada *Consulta fallida* con el mensaje de DuckDB tal cual. El mensaje viene del motor y siempre está en inglés, sea cual sea el idioma de la interfaz. No se escribe nada en la tabla, y el intento se registra igualmente en el [historial](schema-and-history.md) con una marca de fallo.

Cuando el mensaje apunta a una posición (los errores de analizador y de enlace lo hacen, con una línea `LINE n:` y un signo de intercalación), el editor subraya ese punto con una línea ondulada roja: el token que marca el signo de intercalación, o el tramo que cubre una serie de ellos. La marca sigue tus ediciones y se borra en la siguiente ejecución. Los errores en tiempo de ejecución no llevan posición y no reciben marca.

## Formato

**Formato** pasa el búfer por `sqlformat` con una indentación de 2 espacios y las palabras clave en mayúsculas, y luego reemplaza todo el búfer. No hace nada con un búfer vacío.

## Explain y Perfil {#explain-and-profile}

Ambos botones trabajan sobre todo el texto del editor, y ambos toman **exactamente una sentencia**. Con dos o más (o con un comando de punto) se niegan con *Explain y Perfil toman una sola sentencia: pon la que quieres mirar en una pestaña propia.* Un `;` final y los comentarios finales están bien.

Mientras uno de Ejecutar, Explain o Perfil está ocupado, los otros dos no hacen nada. Ni Explain ni Perfil se registran en el [historial](schema-and-history.md#query-history). Su salida reemplaza la tabla en la pestaña **Resultados**, cambiando a ella si había otra pestaña abierta; un fallo muestra la alerta *Consulta fallida*, igual que una ejecución fallida.

### Explain

**Explain** ejecuta `EXPLAIN <your statement>` y muestra el plan de DuckDB como texto monoespaciado simple, con el tiempo que tardó. Solo planifica: la sentencia no se ejecuta, así que explicar un `INSERT`, `UPDATE` o `DELETE` es seguro.

### Perfil

**Perfil** ejecuta la sentencia bajo `EXPLAIN (ANALYZE, FORMAT JSON)` y muestra el plan que se ejecutó como un árbol: el tiempo propio de cada operador y su parte del total, las filas que produjo frente a la estimación del optimizador (marcado cuando se desvía más de 10×), y qué filtró, con qué hizo la unión o qué proyectó. El operador que más costó aparece nombrado arriba y dibujado en rojo. Cómo leerlo: [Salida de Explain y Perfil](results-and-charts.md#explain-and-profile).

**El perfilado ejecuta de verdad la sentencia**: así se cronometran sus operadores. Por eso solo acepta una única consulta de solo lectura:

- **Aceptadas:** `SELECT`, `WITH … SELECT`, `FROM …`, `VALUES`, `TABLE`, `SHOW`,
  `DESCRIBE`, `SUMMARIZE`.
- **Rechazadas:** cualquier cosa que escriba (`INSERT`, `UPDATE`, `DELETE`,
  `CREATE`, …), `CALL`, `PRAGMA`, `COPY`, `EXPLAIN` en sí, una escritura escondida detrás de un `WITH` (`WITH s AS (…) INSERT …`) y un `PIVOT` sin una lista `IN (…)` explícita.

Una sentencia rechazada recibe *Solo se pueden perfilar sentencias que leen (SELECT, WITH, FROM…): el perfilado ejecuta la sentencia.* El propio analizador de DuckDB decide esto antes de que se ejecute nada, no la primera palabra clave.

Un perfil tarda lo que tarda la consulta, más el coste de medirla. **Detener** (o **⌘.**) lo interrumpe como una ejecución.

## Autocompletado

El menú de autocompletado conoce el catálogo. Los candidatos se ordenan:

1. Tablas y columnas del esquema (hasta 35 entradas)
2. Nombres de funciones de DuckDB
3. Palabras clave SQL

Se ofrecen como máximo 50 elementos. La coincidencia es por **prefijo**, sin distinguir mayúsculas y minúsculas, sobre el identificador inmediatamente a la izquierda del cursor, así que `sel` se completa a `SELECT` pero `elect` no completa nada. Una función inserta su nombre y un paréntesis de apertura; los identificadores que contienen espacios o caracteres especiales se insertan entre comillas dobles.

Las listas de palabras clave y funciones son un subconjunto seleccionado: no aparecerá cada función de DuckDB.

## Atajos de teclado

En Windows y Linux, lee **Ctrl** donde pone **⌘** en todo el documento.

Los atajos propios de DuckLocal, todos listados en la barra de menús:

| Atajo | Acción |
| --- | --- |
| ⌘↵ | Ejecutar la consulta |
| ⌘. | Detener la consulta en ejecución |
| ⌘T | Nueva pestaña de consulta |
| ⌘W | Cerrar la pestaña |
| Ctrl+Tab / Ctrl+Shift+Tab | Pestaña siguiente / anterior (también Ctrl en un Mac) |
| ⌘1 … ⌘9 | Ir a la pestaña de esa posición; ⌘9 es la última |
| ⌘O | Abrir datos |
| ⌘S | Guardar el código fuente de un panel, en su vista de código fuente |
| ⌘B | Ocultar o mostrar la barra lateral |
| ⌘+ / ⌘− / ⌘0 | Ampliar / reducir / tamaño predeterminado de la interfaz; consulta [Tamaño de la interfaz](settings-and-data.md#interface-size) |
| ⌘Q | Salir |

Los propios del editor, que funcionan como en cualquier campo de texto:

| Atajo | Acción |
| --- | --- |
| ⌘F / ⇧⌘F | Buscar / reemplazar en el editor |
| ⌘Z / ⇧⌘Z | Deshacer / rehacer |
| ⌘A | Seleccionar todo |
| ⌘C / ⌘X / ⌘V | Copiar / cortar / pegar |
| ⌥⌘↑ / ⌥⌘↓ | Añadir un cursor arriba / abajo |
| ⌘← / ⌘→ / ⌥← / ⌥→ | Mover por línea / palabra |
| ⌘↑ / ⌘↓ | Mover al principio / final del documento |
| ⌘⌫ / ⌥⌫ | Borrar hasta el principio de la línea / la palabra anterior |

## Menús

La barra de menús contiene todos los comandos de ventana con su atajo:

| Menú | Comandos |
| --- | --- |
| DuckLocal | Línea de comandos e IA, Buscar actualizaciones…, Buscar actualizaciones al iniciar, Mostrar la guía, Abrir carpeta de registros, Salir de DuckLocal |
| Archivo | Nueva consulta, Abrir datos, Guardar, Cerrar pestaña, Pestaña siguiente, Pestaña anterior |
| Edición | Deshacer, Rehacer, Cortar, Copiar, Pegar, Seleccionar todo |
| Consulta | Ejecutar, Detener |
| Ver | Mostrar u ocultar la barra lateral, Interfaz más grande, Interfaz más pequeña, Tamaño predeterminado, Mapa base en línea (OpenStreetMap) |

Windows y Linux no tienen barra de menús; allí, **Mostrar la guía** y **Abrir carpeta de registros** están en el menú contextual de la versión, al final derecho de la barra de estado.

**Mapa base en línea (OpenStreetMap)** es un elemento de verificación; consulta [Gráficos](results-and-charts.md#charts). Las filas de la barra lateral de esquema también tienen un menú contextual; consulta [Esquema e historial](schema-and-history.md#right-click-menu). No hay paleta de comandos.
