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.
Cada configuração de layout do formatador, agrupada como Editor › Formatação no app SQLly. O estilo acima é o ponto de partida; qualquer alteração feita aqui fica marcada.
Arraste um arquivo .sql aqui para abri-lo. Ele é lido no seu navegador, não enviado.
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ãoShared.[User]mantém seus colchetes. Coloque aspas apenas quando necessário também as adiciona onde uma palavra reservada é usada como nome:Shared.Userse tornaShared.[User]. - Variáveis e tabelas temporárias são nomes.
@since,@@ROWCOUNT,#recent,##sharedeOUTPUT $actioncada um é lido como um único token, então nada é dividido. - Os lotes GO ficam em linha própria. A
GOlinha, com uma contagem de repetição opcional, comoGO 5e em qualquer capitalização, sempre fica sozinho em uma linha. Uma coluna que por acaso se chamagonão é confundida com uma. - As cláusulas T-SQL são formatadas corretamente.
TOP,CROSS APPLY,MERGE … WHEN [NOT] MATCHED,OUTPUTe dicas de tabelas, comoWITH (NOLOCK)mantêm seu significado, eN'…'Strings Unicode nunca são alteradas. - A detecção automática reconhece T-SQL quando vê nomes entre colchetes,
@parâmetros ou umaGOlinha. - O Minify mantém o GO. Colapsar um script em uma linha ainda deixa cada
GOsozinho 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,IFeWHILEos 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
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
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.
Outros dialetos
- Qualquer dialeto (detecção automática)
- Formatador PostgreSQL
- Formatador MySQL
- Formatador SQLite
- Formatador Oracle SQL
- Formatador SQL do Snowflake
- Formatador de SQL do BigQuery
- Formatador SQL do Redshift
Trabalhando com SQL Server todos os dias? Veja o que o aplicativo desktop do SQLly faz pelo SQL Server, ou explore todos os recursos.
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.