Duobase — SQL Server & PostgreSQL
Conecte a SQL Server e PostgreSQL sem sair do VS Code. Escreva SQL com autocomplete que conhece o seu banco, veja o resultado em um grid, navegue pelos relacionamentos, edite os dados com segurança e peça consultas ao Claude Code, que abre o resultado direto no grid.
Primeiros passos
- Conecte. Clique no ícone Duobase na barra lateral e em Nova conexão. Preencha os dados, clique em Testar conexão e depois em Salvar.
- Consulte. Na conexão ou no banco, clique em Nova consulta. Escreva o SQL e pressione Ctrl+Enter (⌘+Enter no Mac) ou F5. Sem seleção, roda o editor inteiro; com seleção, só o trecho selecionado. Para rodar só a instrução onde está o cursor, use Alt+Enter (⌥+Enter), ou clique em ▶ Executar, que aparece acima de cada instrução.
- Navegue. No grid, os valores de chave estrangeira aparecem como link: clique para abrir o registro relacionado. Pelo botão Relacionamentos (ou pelo clique direito), veja os registros de outras tabelas que apontam para a linha. A trilha no topo do grid leva de volta.
- Edite. Dê duplo clique (ou Enter) numa célula para editar. As alterações ficam destacadas até você escolher:
- Gerar script: abre o
INSERT/UPDATE/DELETE em um editor, para revisar ou guardar;
- Executar alterações: mostra o script e, depois da sua confirmação, grava tudo em uma única transação.
- Exporte. O botão Exportar salva o resultado em CSV ou Excel (.xlsx).
Recursos desta versão
Conexões
- PostgreSQL e SQL Server, com SSL/TLS opcional.
- Autenticação no SQL Server:
- login do SQL Server;
- Windows NTLM: domínio, usuário e senha;
- Windows integrado: conta logada, sem senha. Exige o ODBC Driver for SQL Server;
- Microsoft Entra ID pela conta do VS Code;
- Entra ID com usuário e senha.
- Marcador de produção: a conexão ganha um ícone vermelho com um ponto amarelo de alerta, e todo comando que altera dados ou estrutura pede confirmação.
- Senhas guardadas no cofre de segredos do VS Code, nunca em arquivos de configuração.
Explorador
Mostra a árvore conexões → bancos → esquemas → tabelas e views → colunas, com ícones coloridos para cada tipo de item e chaves primárias (chave dourada) e estrangeiras (elo ciano) identificadas. Em cada tabela, você pode abrir os dados, gerar um SELECT ou começar uma nova consulta.
Editor SQL
Autocomplete que entende o contexto da instrução:
- tabelas depois de
FROM, UPDATE e INTO;
- colunas e funções depois de
SELECT, WHERE, ON, SET e ORDER BY;
- colunas pelo apelido da tabela (
p.).
JOIN pronto: depois de JOIN, sugere a junção completa deduzida das chaves estrangeiras, como pedido p ON p.cliente_id = c.id.
INSERT: sugere as colunas na ordem da tabela e monta o VALUES (…) com um campo por coluna. Mostra a qual coluna cada posição corresponde e sugere valores pelo tipo.
WHERE: depois da coluna, sugere só os operadores que fazem sentido para o tipo dela (LIKE em texto, BETWEEN em números e datas, IS NULL em colunas que aceitam nulo).
UPDATE … SET: sugere só as colunas alteráveis e já abre os valores sugeridos pelo tipo.
Snippets de cada banco, também em arquivos sem conexão (aí aparecem os dos dois bancos, identificados):
- consultas:
sel, selc, seld, selg, selj, sellj, page, dup, cte, cols;
- expressões, sugeridas também no meio da instrução:
case, exists, rownum, sumover;
- dados:
ins, insel, upd, del, upsert (MERGE / ON CONFLICT), tran, updout (SQL Server), updret (PostgreSQL);
- estrutura:
ct, addcol, fk, ci, view;
- SQL Server:
decl, ifex, temp, proc, stats; PostgreSQL: do, func, explain.
Snippets próprios na configuração duobase.snippets; um prefixo igual ao de um nativo o substitui:
"duobase.snippets": [
{ "prefix": "ativos", "description": "Clientes ativos", "database": "postgres",
"body": ["SELECT *", "FROM cliente", "WHERE ativo AND ${1:condição}"] }
]
▶ Executar acima de cada instrução: em editores ligados a uma conexão, cada instrução (separada por ;, linha em branco ou GO) ganha um botão que executa só ela no grid, com a mesma confirmação de produção do Alt+Enter. ;, linhas em branco e GO dentro de strings, comentários, identificadores entre aspas/colchetes e blocos $$ não separam instruções, e trechos só com comentário não ganham botão. Desligue em duobase.codeLens.enabled.
Barra de status com a conexão do editor; clique nela para trocar.
Formatador SQL em Formatar Documento (Shift+Alt+F / ⇧⌥F) e Formatar Seleção: uma cláusula por linha, colunas uma por linha com a vírgula no início, JOINs recuados sob o FROM, AND/OR em linhas próprias, subconsultas e CTEs em blocos e CASE longo quebrado por WHEN:
SELECT
c.id
, c.nome
, SUM(p.total) AS total
FROM cliente AS c
INNER JOIN pedido AS p
ON p.cliente_id = c.id
WHERE c.ativo = 1
AND p.total > 100
GROUP BY
c.id
, c.nome
ORDER BY total DESC;
- segue o banco da conexão do editor (
[colchetes], TOP e GO no SQL Server; "aspas", LIMIT, :: e $$ no PostgreSQL); sem conexão, deduz pelo texto;
- strings, comentários, identificadores entre aspas/colchetes e blocos
$$ nunca são alterados. O resultado é conferido com o original e, se algo mudasse, nada é alterado;
- instruções que não são consultas (
DECLARE, IF, CREATE PROCEDURE…) mantêm suas quebras de linha e ganham recuo por BEGIN/END;
- o recuo segue o do editor; a caixa das palavras-chave vem de
duobase.format.keywordCase.
Grid de resultados
- Rolagem fluida mesmo com muitas linhas.
- Ordenação e redimensionamento de colunas.
- Cópia de célula, de linha (TSV) ou em JSON.
- Uma aba por conjunto de resultados.
- Paginação: 1000 linhas por página por padrão, com botões de primeira, anterior, próxima e última página. Atalhos: Alt+Home, Alt+PageUp, Alt+PageDown e Alt+End. O campo Linhas por página, no rodapé, muda o tamanho só naquele grid.
- Cancelar: interrompe no servidor uma consulta demorada.
Edição segura
- O
WHERE dos comandos gerados usa sempre a chave primária. Tabelas sem chave primária ficam somente leitura.
- Os valores são validados e escapados de acordo com o tipo, e
NULL é diferente de texto vazio.
- Ao gravar, cada comando precisa afetar exatamente uma linha. Se algum falhar, nada é gravado.
- Delete define NULL na célula. + Linha insere e − Excluir remove linhas. Duplicar copia a linha selecionada sem a chave primária e sem as colunas geradas pelo banco.
- Edição em lote: selecione várias linhas com Shift+clique (intervalo), Ctrl+clique (⌘+clique no Mac) para marcar ou desmarcar linhas soltas, ou Shift+↑/↓ no teclado. Vá até a coluna com ←/→ (a seleção de linhas continua), pressione Enter ou comece a digitar e confirme com Enter: o valor vai para essa coluna em todas as linhas selecionadas. Também dá para colar (Ctrl+V / ⌘+V, ou Colar no menu do botão direito): um valor vai para todas as linhas selecionadas, e uma coluna copiada do Excel vai uma linha por linha selecionada. Delete (ou Definir NULL no menu do botão direito) coloca NULL em todas. As linhas ficam destacadas como alterações pendentes, com a mesma validação de tipo, e só vão para o banco por Gerar script ou Executar alterações. Linhas marcadas para exclusão ficam de fora, e Esc desfaz a seleção.
O resultado é editável quando vem de um SELECT sobre uma única tabela, sem JOIN, UNION, GROUP BY ou subconsulta, e inclui a chave primária. Os dados abertos pelo explorador ou pela navegação entre relacionamentos sempre atendem a isso.
Sugestões de SQL por IA
- Escreva um comentário, como
-- clientes com mais de 3 pedidos em 2025, e pressione Ctrl+Alt+I (⌘+⌥+I). O Duobase gera o SQL usando as tabelas reais do banco.
- Enquanto você digita, a IA sugere a continuação em texto cinza; aceite com Tab.
A IA usa o modelo de linguagem já disponível no VS Code (por exemplo, o do GitHub Copilot), sem chave para configurar. Ela recebe só nomes e tipos de tabelas e colunas, nunca os dados.
Peça no Claude Code algo como "mostra os clientes que não compram há 90 dias" e veja o resultado no grid do Duobase. O Claude Code usa as conexões que você já cadastrou: consulta a estrutura do banco, escreve o SQL, abre num editor do Duobase e executa.
Conectar (uma vez só)
No VS Code, abra a paleta de comandos (Ctrl+Shift+P ou ⌘+Shift+P) e rode Duobase: Conectar ao Claude Code.
Escolha Copiar comando ou Colar no terminal e execute o comando claude mcp add … no terminal. Ele contém um token de acesso; não o compartilhe.
Confira se o duobase aparece como conectado:
claude mcp list
Abra uma nova sessão do Claude Code.
O que o Claude Code pode fazer
| Ferramenta |
O que faz |
list_connections |
Lista as conexões do Duobase, sem senhas. |
describe_schema |
Lista tabelas e colunas, com os tipos. |
describe_table |
Detalha uma tabela: colunas, chave primária e relacionamentos. |
open_query_in_grid |
Abre o SQL num editor do Duobase, executa e mostra o resultado no grid. |
Privacidade e segurança
- Os dados não vão para o Claude. Depois de executar, ele recebe só os nomes das colunas e a quantidade de linhas. Os valores aparecem apenas no grid.
- Alterações precisam da sua confirmação. Antes de rodar qualquer comando que altera dados ou estrutura (INSERT, UPDATE, DELETE, DDL…), o VS Code mostra o SQL e pede sua confirmação.
- As senhas continuam no VS Code. O Claude Code conhece só o nome da conexão.
- A conexão é local e protegida. Ela fica disponível só no seu computador (
127.0.0.1) e exige o token gerado pelo Duobase.
Dicas
Se você não disser a conexão, o Claude Code usa a do editor SQL ativo.
O SQL do Claude abre sempre no mesmo editor. Você pode ajustá-lo e rodar de novo com Ctrl+Enter.
Com várias janelas do VS Code abertas, só uma atende o Claude Code; se ela for fechada, a próxima janela que você usar assume.
Para desligar, desmarque a configuração duobase.claudeCode.enabled e rode:
claude mcp remove duobase --scope user
Atalhos
Os atalhos valem em arquivos SQL, exceto Nova consulta, que vale em qualquer lugar. Para trocar uma tecla, abra Preferências: Atalhos de Teclado e busque por Duobase.
| Ação |
Windows/Linux |
Mac |
| Executar consulta (seleção ou editor inteiro) |
Ctrl+Enter ou F5 |
⌘+Enter ou F5 |
| Executar a instrução sob o cursor |
Alt+Enter |
⌥+Enter |
| Cancelar a execução em andamento |
o mesmo atalho de executar |
o mesmo atalho de executar |
| Sugerir SQL com IA |
Ctrl+Alt+I |
⌘+⌥+I |
| Nova consulta |
Ctrl+Alt+N |
⌘+⌥+N |
| Escolher a conexão do editor |
Ctrl+Alt+K |
⌘+⌥+K |
O F5 e o menu Run > Start Debugging também executam a consulta quando o editor SQL está ativo, sem pedir para salvar o arquivo. As instruções são separadas por ;, linha em branco ou GO.
Configurações
| Configuração |
Padrão |
Descrição |
duobase.pageSize |
1000 |
Linhas por página no grid. Também pode ser alterado em cada grid, no rodapé. |
duobase.maxQueryRows |
100000 |
Máximo de linhas guardadas de uma consulta. O grid avisa quando o resultado é cortado. |
duobase.format.enabled |
true |
Usa o formatador do Duobase em arquivos SQL. Desative para usar outro formatador. |
duobase.format.keywordCase |
upper |
Caixa das palavras-chave ao formatar: upper, lower ou preserve. |
duobase.codeLens.enabled |
true |
Mostra ▶ Executar acima de cada instrução SQL em editores ligados a uma conexão. |
duobase.ai.inlineSuggestions |
true |
Sugestões de IA enquanto você digita. |
duobase.claudeCode.enabled |
false |
Mantém a conexão com o Claude Code. É ligada pelo comando Duobase: Conectar ao Claude Code. |
duobase.claudeCode.port |
47811 |
Porta local usada pelo Claude Code. Se mudar, conecte de novo pelo comando. |
Requisitos
- VS Code 1.95 ou mais recente.
- Opcional: uma extensão com modelo de linguagem, como o GitHub Copilot, para as sugestões por IA.
- Opcional: o Claude Code instalado, para pedir consultas a ele.
- Opcional: o ODBC Driver for SQL Server, só para a autenticação integrada do Windows.
Limitações conhecidas
- Uma consulta muito grande é carregada até o limite
duobase.maxQueryRows antes de ser paginada. Para volumes maiores, filtre ou use TOP/LIMIT.
- A ordenação por coluna no grid vale para a página exibida. Para ordenar o resultado todo, use
ORDER BY.
- Colunas
IDENTITY (SQL Server) e GENERATED ALWAYS (PostgreSQL) ficam somente leitura no grid; o banco gera os valores.
datetimeoffset do SQL Server é exibido convertido para UTC.
- Entra ID com usuário e senha não funciona com contas que exigem MFA; prefira a conta do VS Code.
- O formatador não quebra linhas longas por largura (listas de colunas do
INSERT e argumentos de funções ficam numa linha) e não formata o corpo de funções do PostgreSQL entre $$.
| |