Ir al contenido

Editor SQL ​

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 ​

ControlQué hace
+ o ⌘TAñade una pestaña de consulta nueva y le da el foco
Clic en una pestañaCambia a ella
Ctrl+Tab / Ctrl+Shift+TabLa pestaña siguiente / anterior
⌘1 … ⌘8, ⌘9De la primera a la octava pestaña; ⌘9 es la última pestaña
Arrastrar una pestañaLa mueve a lo largo de la tira
×, ⌘W o clic con el botón centralCierra 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ñaCerrar 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ñaEdita 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ónQué hace
EjecutarEjecuta el SQL del editor; consulta Ejecutar SQL
DetenerAparece cuando una ejecución lleva un rato en marcha; la interrumpe
FormatoReformatea el SQL; consulta Formato
ExplainMuestra el plan que usaría DuckDB, sin ejecutar la sentencia
PerfilEjecuta la consulta y muestra lo que costó cada operador

Explain y Perfil se describen en Explain y Perfil.

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 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:

ComandoMuestra
.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
.databasesLas bases de datos adjuntas
.helpEsta 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 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 ​

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. 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.

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:

AtajoAcción
⌘↵Ejecutar la consulta
⌘.Detener la consulta en ejecución
⌘TNueva pestaña de consulta
⌘WCerrar la pestaña
Ctrl+Tab / Ctrl+Shift+TabPestaña siguiente / anterior (también Ctrl en un Mac)
⌘1 … ⌘9Ir a la pestaña de esa posición; ⌘9 es la última
⌘OAbrir datos
⌘SGuardar el código fuente de un panel, en su vista de código fuente
⌘BOcultar o mostrar la barra lateral
⌘+ / ⌘− / ⌘0Ampliar / reducir / tamaño predeterminado de la interfaz; consulta Tamaño de la interfaz
⌘QSalir

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

AtajoAcción
⌘F / ⇧⌘FBuscar / reemplazar en el editor
⌘Z / ⇧⌘ZDeshacer / rehacer
⌘ASeleccionar todo
⌘C / ⌘X / ⌘VCopiar / 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

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

MenúComandos
DuckLocalLínea de comandos e IA, Buscar actualizaciones…, Buscar actualizaciones al iniciar, Mostrar la guía, Abrir carpeta de registros, Salir de DuckLocal
ArchivoNueva consulta, Abrir datos, Guardar, Cerrar pestaña, Pestaña siguiente, Pestaña anterior
EdiciónDeshacer, Rehacer, Cortar, Copiar, Pegar, Seleccionar todo
ConsultaEjecutar, Detener
VerMostrar 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. Las filas de la barra lateral de esquema también tienen un menú contextual; consulta Esquema e historial. No hay paleta de comandos.

Publicado bajo la licencia Apache-2.0.