COLIBRI SQL — Manual do usuário

Versão 1.4 · Um produto da LiVnet - RELV - 2026

O COLIBRI SQL é um cliente leve de SQL Server, no estilo do SSMS, para Linux (inclusive equipamentos ARM como o Surface RT) e Windows. Conecta-se a um ou vários servidores, escreve e executa consultas, explora os objetos de cada banco, trabalha com scripts versionados no git e oferece ferramentas para comparar, clonar, fazer backup ou agendar tarefas.

1. Primeiros passos

Instalação

Idioma

O programa está em espanhol, inglês e português. Escolha em ☰ → Idioma (ou «Automático», o do sistema); fica salvo e é aplicado ao abrir o programa de novo. No Windows o instalador também pergunta o idioma.

Licença e teste gratuito

A janela

2. Conectar a um servidor

Ao abrir o programa (ou com o botão Conectar, ou Ctrl+Shift+N) aparece a aba Conectar: à esquerda os seus perfis salvos (o último usado em cima) e à direita o formulário. Clique duplo ou Enter num perfil conecta. Enquanto conecta, você pode continuar usando o programa, e o botão Conectar vira Cancelar conexão (se errou o servidor ou os dados, não precisa esperar): corrija e conecte de novo. Se enquanto conecta você escolher outro perfil (clique duplo) ou pressionar Enter, a tentativa é cancelada e conecta com os dados novos.

Dados do perfil

A caixa de estado mostra cada passo (túnel, servidor, usuário) e os erros com uma dica da causa. Tudo fica no Registro de conexões (botão da barra superior).

Conexões abertas

No explorador, clique direito num servidor: Editar conexão…, Monitor do servidor…, Trabalhos do SQL Server Agent…, Restaurar um banco…, Cor da conexão e Desconectar. Ao desconectar, as abas desse servidor não são fechadas: ficam sem conexão, com o seu texto.

3. Abas de consulta

Muitas abas

Três ajudas, ativadas em ☰ → Abas:

Fechar: com o ×, com o botão do meio do mouse ou com clique direito numa aba: fechar, fechar as outras, as da esquerda, as da direita, todas, as desta conexão ou as que não têm alterações. Se várias têm alterações não salvas, pergunta uma só vez. Se a aba está salva num arquivo, o mesmo menu tem Mostrar no painel Projeto (se o arquivo é da pasta aberta em «Projeto»: abre o painel e as suas pastas e o deixa selecionado) e Abrir no explorador de arquivos (o arquivo fica selecionado no Windows e no Linux com Thunar, Nautilus, Nemo ou Dolphin; o PCManFM só abre a pasta).

4. O editor e a execução

A barra da consulta

Todos os botões são ícones; ao passar o mouse aparecem o nome e o atalho, e o botão ? (ou F1) explica cada um.

BotãoAtalhoO que faz
ExecutarF5 · Ctrl+EExecuta todo o script, ou a seleção
Instrução do cursorF8 · Ctrl+EnterExecuta só a instrução onde está o cursor
CancelarEscPara a execução
PlanoCtrl+LPlano de execução estimado, sem executar
DepurarAlt+F5 · F10Executa passo a passo, com pontos de interrupção (F9)
LimparApaga o editor (desfaz-se com Ctrl+Z)
EstruturaCtrl+Shift+OLotes, instruções e CTEs do script
AssistenteCtrl+IPainel do assistente de IA
BancoBanco ativo da aba (USE)
CadeadoAberto = Auto; fechado = Manual (Commit / Rollback)

Transações

Ajudas ao escrever

5. Resultados

Cada SELECT gera um resultado na sua aba (ou um embaixo do outro, com o botão Resultados empilhados). Mensagens (PRINT) e erros vão para Mensagens, na ordem em que chegam, como no SSMS: cada erro mostra número, nível, estado e, se vem de um procedimento, qual e a sua linha; se é do próprio script, a linha do editor. No final, a hora de término (também se houve erros). Se houve um erro, abre Mensagens, mas as linhas que chegaram ficam na sua aba. Atenção: se o script fez ROLLBACK depois, essas linhas já não estão no banco.

6. Explorador de objetos

7. Assistente de IA

Botão Assistente (Ctrl+I). Escreve, explica e corrige consultas conhecendo a estrutura do seu banco e a conexão da aba. As respostas com SQL têm o botão Inserir ▾: no cursor, no final do editor, ou limpar o editor e inserir; antes do SQL é adicionado um comentário breve com o modelo e a data. Tudo se desfaz com Ctrl+Z.

Privacidade: com modelos na nuvem, o assistente não lê dados das tabelas a menos que você ative isso nos seus ajustes; com um modelo local sempre pode.

8. Projeto (scripts com git)

Aba Projeto do painel lateral: abre uma pasta de scripts (se for um repositório git, mostra o ramo e o seu estado).

9. Ferramentas

10. Ajustes e arquivos

11. Atalhos de teclado

AtalhoAção
F5 · Ctrl+EExecutar tudo ou a seleção
F8 · Ctrl+EnterExecutar a instrução do cursor
Ctrl+LPlano de execução
EscCancelar a execução
Ctrl+N · Ctrl+Shift+NNova consulta · Conectar
Ctrl+O · Ctrl+S · Ctrl+Shift+SAbrir · Salvar · Salvar como
Ctrl+WFechar a aba
Ctrl+Page Up · Ctrl+Page DownAba anterior · seguinte
Ctrl+Shift+ALista de todas as abas
Ctrl+BMostrar ou ocultar o painel lateral
Ctrl+RMostrar ou ocultar os resultados
Ctrl+IAssistente de IA
Ctrl+Espaço · TabAutocompletar · expandir * ou fragmento
Ctrl+/Comentar ou descomentar linhas
Ctrl+KFormatar SQL
Shift+Alt+setasEdição em coluna (também Shift+Alt+arrastar)
Ctrl+Z · Ctrl+YDesfazer · refazer (também Ctrl+Shift+Z)
Ctrl+F · F3Buscar · seguinte
Ctrl+G · Ctrl+PIr para linha · Ir para objeto
F12 · Alt+F7 · Ctrl+QDefinição · Onde é usado · Documentação rápida
Ctrl+HHistórico de consultas
Ctrl+Shift+F · Ctrl+Shift+EBuscar no banco · Comparar em vários bancos
Ctrl+Shift+OEstrutura do script
F9 · F10 · Shift+F5Ponto de interrupção · passo · parar a depuração
F1O que faz cada botão da barra

12. Se algo não funcionar