COLIBRI SQL — Manual de usuario

Versión 1.4 · Un producto de LiVnet - RELV - 2026

COLIBRI SQL es un cliente ligero de SQL Server, al estilo de SSMS, para Linux (también en equipos ARM como la Surface RT) y Windows. Permite conectarse a uno o varios servidores, escribir y ejecutar consultas, explorar los objetos de cada base, trabajar con scripts versionados en git y usar herramientas como comparar, clonar, respaldar o programar tareas.

1. Primeros pasos

Instalación

Idioma

El programa está en español, inglés y portugués. Se elige en ☰ → Idioma (o «Automático», el del sistema) y queda guardado; se aplica al volver a abrir el programa. En Windows el instalador también pregunta el idioma.

Licencia y prueba gratuita

La ventana

2. Conectarse a un servidor

Al abrir el programa (o con el botón Conectar, o Ctrl+Shift+N) aparece la pestaña Conectar: a la izquierda tus perfiles guardados (el último usado arriba) y a la derecha el formulario. Doble clic o Enter en un perfil conecta. Mientras conecta puedes seguir usando el programa, y el botón Conectar se cambia por Cancelar conexión (si te equivocaste de servidor o de datos, no hay que esperar): corrige y vuelve a conectar. Si mientras conecta eliges otro perfil (doble clic) o presionas Enter, se cancela el intento y se conecta con los datos nuevos.

Datos del perfil

El cuadro de estado va mostrando cada paso (túnel, servidor, usuario) y los errores con una pista de la causa. Todo queda en el Registro de conexiones (botón de la barra superior).

Conexiones abiertas

En el explorador, clic derecho en un servidor: Editar conexión…, Monitor del servidor…, Trabajos del SQL Server Agent…, Restaurar una base…, Color de la conexión y Desconectar. Al desconectar, las pestañas de ese servidor no se cierran: quedan sin conexión, con su texto.

3. Pestañas de consulta

Muchas pestañas

Tres ayudas, que se activan en ☰ → Pestañas:

Cerrar: con la ×, con el botón del medio del mouse o con clic derecho en una solapa: cerrar, cerrar las demás, las de la izquierda, las de la derecha, todas, las de esta conexión o las que no tienen cambios. Si varias tienen cambios sin guardar, pregunta una sola vez. Si la pestaña está guardada en un archivo, el mismo menú tiene Mostrar en el panel Proyecto (si el archivo es de la carpeta abierta en «Proyecto»: abre el panel, sus carpetas y lo deja seleccionado) y Abrir en el explorador de archivos (queda seleccionado en Windows y en Linux con Thunar, Nautilus, Nemo o Dolphin; PCManFM solo abre la carpeta).

4. El editor y la ejecución

La barra de la consulta

Todos los botones son íconos; al pasar el mouse se ve su nombre y atajo, y el botón ? (o F1) explica cada uno.

BotónAtajoQué hace
EjecutarF5 · Ctrl+EEjecuta todo el script, o la selección
Sentencia del cursorF8 · Ctrl+EnterEjecuta solo la sentencia donde está el cursor
CancelarEscDetiene la ejecución
PlanCtrl+LPlan de ejecución estimado, sin ejecutar
DepurarAlt+F5 · F10Ejecuta paso a paso, con puntos de interrupción (F9)
LimpiarBorra el editor (se deshace con Ctrl+Z)
EstructuraCtrl+Shift+OLotes, sentencias y CTE del script
AsistenteCtrl+IPanel del asistente de IA
BaseBase activa de la pestaña (USE)
CandadoAbierto = Auto; cerrado = Manual (Commit / Rollback)

Transacciones

Ayudas al escribir

5. Resultados

Cada SELECT da un resultado en su pestaña (o uno debajo de otro, con el botón Resultados apilados). Los mensajes (PRINT) y errores van en Mensajes, en el orden en que llegan, como en SSMS: cada error dice número, nivel, estado y, si viene de un procedimiento, cuál y su línea; si es del propio script, la línea del editor. Al final, la hora de finalización (también si hubo errores). Si hubo un error, se abre Mensajes, pero las filas que alcanzaron a llegar quedan en su pestaña. Ojo: si el script hizo ROLLBACK después, esas filas ya no están en la base.

6. Explorador de objetos

7. Asistente de IA

Botón Asistente (Ctrl+I). Escribe, explica y corrige consultas conociendo la estructura de tu base y la conexión de la pestaña. Sus respuestas con SQL tienen el botón Insertar ▾: en el cursor, al final del editor, o limpiar el editor e insertar; antes del SQL se agrega un comentario breve con el modelo y la fecha. Todo se deshace con Ctrl+Z.

Privacidad: con modelos en la nube, el asistente no lee datos de las tablas salvo que lo actives en sus ajustes; con un modelo local siempre puede.

8. Proyecto (scripts con git)

Pestaña Proyecto del panel lateral: abre una carpeta de scripts (si es un repositorio git, muestra la rama y su estado).

9. Herramientas

10. Ajustes y archivos

11. Atajos de teclado

AtajoAcción
F5 · Ctrl+EEjecutar todo o la selección
F8 · Ctrl+EnterEjecutar la sentencia del cursor
Ctrl+LPlan de ejecución
EscCancelar la ejecución
Ctrl+N · Ctrl+Shift+NNueva consulta · Conectar
Ctrl+O · Ctrl+S · Ctrl+Shift+SAbrir · Guardar · Guardar como
Ctrl+WCerrar la pestaña
Ctrl+Re Pág · Ctrl+Av PágPestaña anterior · siguiente
Ctrl+Shift+ALista de todas las pestañas
Ctrl+BMostrar u ocultar el panel lateral
Ctrl+RMostrar u ocultar los resultados
Ctrl+IAsistente de IA
Ctrl+Espacio · TabAutocompletar · expandir * o fragmento
Ctrl+/Comentar o descomentar líneas
Ctrl+KFormatear SQL
Shift+Alt+flechasEdición en columna (también Shift+Alt+arrastrar)
Ctrl+Z · Ctrl+YDeshacer · rehacer (también Ctrl+Shift+Z)
Ctrl+F · F3Buscar · siguiente
Ctrl+G · Ctrl+PIr a línea · Ir a objeto
F12 · Alt+F7 · Ctrl+QDefinición · Dónde se usa · Documentación rápida
Ctrl+HHistorial de consultas
Ctrl+Shift+F · Ctrl+Shift+EBuscar en la base · Comparar en varias bases
Ctrl+Shift+OEstructura del script
F9 · F10 · Shift+F5Punto de interrupción · paso · detener la depuración
F1Qué hace cada botón de la barra

12. Si algo no funciona