// ferramenta gratuita

Formatador SQL Server (T-SQL)

Formate T-SQL para SQL Server e Azure SQL. Nomes entre colchetes, @variáveis, tabelas temporárias #temp e lotes GO são lidos da forma como o SQL Server os lê, e seu script nunca sai do seu dispositivo.

Arraste um arquivo .sql aqui para abri-lo. Ele é lido no seu navegador, não enviado.

SQL formatado
SELECT
    c.CustomerID,
    COUNT(*) AS Orders INTO #recent
FROM
    dbo.Orders o
    JOIN dbo.Customers c ON c.CustomerID = o.CustomerID
WHERE
    o.OrderDate >= DATEADD(day, -30, GETDATE())
GROUP BY
    c.CustomerID;
SELECT
    r.CustomerID,
    r.Orders,
    @@rowcount AS Total
FROM
    #recent r
WHERE
    r.Orders > @min
ORDER BY
    r.Orders DESC;
GO
DROP TABLE IF EXISTS #recent;
GO

Loading the formatter…

Atalhos no editor: Ctrl+Enter formata e Ctrl+Shift+Enter minifica (⌘ em vez de Ctrl no Mac). Suas configurações são lembradas neste navegador e mantidas no endereço da página, então um link compartilha seu estilo – nunca seu SQL.

O que o formatador faz com o SQL do SQL Server

  • Nomes entre colchetes permanecem exatos. [Order Details] e [dbo].[Orders] são nomes entre aspas, ]] com escapes incluídos. Ajuste Aspas para Sempre entre aspas e o formatador adiciona colchetes; Remover aspas desnecessárias as remove apenas de nomes comuns que não são palavras reservadas, então Shared.[User] mantém seus colchetes. Coloque aspas apenas quando necessário também as adiciona onde uma palavra reservada é usada como nome: Shared.User se torna Shared.[User].
  • Variáveis e tabelas temporárias são nomes. @since, @@ROWCOUNT, #recent, ##shared e OUTPUT $action cada um é lido como um único token, então nada é dividido.
  • Os lotes GO ficam em linha própria. A GO linha, com uma contagem de repetição opcional, como GO 5 e em qualquer capitalização, sempre fica sozinho em uma linha. Uma coluna que por acaso se chama go não é confundida com uma.
  • As cláusulas T-SQL são formatadas corretamente. TOP, CROSS APPLY, MERGE … WHEN [NOT] MATCHED, OUTPUT e dicas de tabelas, como WITH (NOLOCK) mantêm seu significado, e N'…' Strings Unicode nunca são alteradas.
  • A detecção automática reconhece T-SQL quando vê nomes entre colchetes, @ parâmetros ou uma GO linha.
  • O Minify mantém o GO. Colapsar um script em uma linha ainda deixa cada GO sozinho em sua linha, porque as ferramentas do SQL Server exigem isso.

Bom saber

  • O T-SQL procedural permanece válido e as instruções dentro de um procedimento são organizadas uma por uma, mas BEGIN … END, IF e WHILE os blocos não são reindentados.
  • SQL contendo sequências de escape ODBC como {fn NOW()} é retornado inalterado, com uma nota dizendo onde o formatador parou.

Exemplos

SQL Server antes e depois

Antes
select c.CustomerID,count(*) as Orders into #recent from dbo.Orders o join dbo.Customers c on c.CustomerID=o.CustomerID where o.OrderDate>=dateadd(day,-30,getdate()) group by c.CustomerID;
select r.CustomerID,r.Orders,@@rowcount as Total from #recent r where r.Orders>@min order by r.Orders desc;
go
drop table if exists #recent;
go
Depois
SELECT
    c.CustomerID,
    COUNT(*) AS Orders INTO #recent
FROM
    dbo.Orders o
    JOIN dbo.Customers c ON c.CustomerID = o.CustomerID
WHERE
    o.OrderDate >= DATEADD(day, -30, GETDATE())
GROUP BY
    c.CustomerID;
SELECT
    r.CustomerID,
    r.Orders,
    @@rowcount AS Total
FROM
    #recent r
WHERE
    r.Orders > @min
ORDER BY
    r.Orders DESC;
GO
DROP TABLE IF EXISTS #recent;
GO

A saída usa o estilo Standard com indentação de 4 espaços, exatamente como o formatador acima produz. Alterne o estilo para Compacto para SQL mais compacto ou Expandido para vírgulas à frente e um item por linha. A documentação do formatador cobre os detalhes.

Perguntas frequentes sobre o formatador do SQL Server

O formatador T-SQL lida com separadores de lote GO?

Sim. Uma linha com GO permanece em sua própria linha, incluindo GO com uma contagem de repetição como GO 5, e o Minify também a mantém lá. Uma coluna chamada go dentro de uma instrução não é tratada como separador.

Isso vai alterar meus nomes [entre colchetes]?

Não. Nomes entre colchetes são mantidos exatamente como escritos, a menos que você escolha uma opção de aspas diferente nas configurações avançadas. Remover aspas desnecessárias só remove as aspas de nomes simples que não são palavras reservadas (portanto, [User] e [Order] mantêm seus colchetes), o que é seguro porque os nomes no SQL Server não diferenciam maiúsculas de minúsculas com a collation padrão.

Ele pode formatar scripts com tabelas temporárias e variáveis?

Sim. Tabelas temporárias #temp e ##global, @variáveis, funções de sistema @@ e $action são lidas como nomes únicos, então o formatador organiza o script em vez de recusá-lo.

Funciona com o Azure SQL?

Sim. O Azure SQL Database e o Azure SQL Managed Instance usam o mesmo dialeto T-SQL, então escolha SQL Server (T-SQL) ou deixe o dialeto em detecção automática.

Meu SQL é enviado para um servidor?

Não. O formatador é compilado em WebAssembly e roda dentro da aba do seu navegador. Seu SQL nunca é enviado, registrado ou armazenado, e depois que a página carrega, ele continua funcionando offline.

A formatação pode quebrar minha consulta?

Ela foi feita para não fazer isso. Depois de formatar, o SQLly confere a saída token por token com o que você enviou. Se algo além de espaços em branco e da capitalização que você pediu teria de mudar, ele devolve seu SQL exatamente como você escreveu e explica o motivo. SQL que não analisa de forma limpa, como uma string não fechada, também fica intocado, com a linha e a coluna do problema.

Posso compartilhar minhas configurações de formatação com minha equipe?

Sim. Todas as configurações, incluindo as avançadas, são mantidas no endereço da página após o sinal #, então copiar o endereço ou pressionar Copiar link de configurações compartilha seu estilo exato. O link contém apenas as configurações, nunca seu SQL.

// a formatação é o menor problema

Gostou do formatador? Conheça o resto do SQLly

Um workbench SQL nativo para macOS, Windows e Linux, com IntelliSense que conhece o seu esquema, proteções para consultas arriscadas e este formatador integrado ao editor.