// Referência de erro do SQL Server

Erro do SQL Server 102: Sintaxe incorreta perto de

O parser T-SQL encontrou algo inesperado. O texto entre aspas é onde a análise parou; o erro de verdade costuma estar logo antes.

Número do erro
102
Gravidade
15
Categoria
Sintaxe e compilação
Mensagem de erro
Incorrect syntax near '%.*ls'.

O que significa

O SQL Server analisa todo o lote antes de executar qualquer parte dele. O Erro 102 significa que o analisador encontrou um token que não pode aparecer nesse ponto e o cita (Incorrect syntax near ','). O token nomeado é o ponto em que o parser desistiu, que normalmente fica logo depois do erro real: uma vírgula faltando, um parêntese não fechado ou sintaxe de outro banco de dados. Como a análise falhou, nada no lote foi executado.

Causas comuns

  • Sintaxe de outro banco de dados: LIMIT 10 (MySQL, PostgreSQL), nomes entre crases, || para concatenação de strings em versões mais antigas, CREATE TABLE IF NOT EXISTS.
  • Uma vírgula ausente ou sobrando em uma lista de colunas, ou uma vírgula final antes de FROM ou ).
  • Parênteses ou aspas desequilibrados.
  • Uma instrução que precisa ser a primeira do lote, como CREATE VIEW ou CREATE PROCEDURE, sem um GO antes dela.
  • Um ponto e vírgula ausente antes de WITH (uma CTE) ou THROW, que então são lidos como parte da instrução anterior.
  • Sintaxe mais recente em um servidor ou nível de compatibilidade mais antigo, como STRING_AGG ou CREATE OR ALTER.

Como corrigir

  1. Veja o texto logo antes do token entre aspas e o número da linha na mensagem; é aí que o erro geralmente está.

  2. Substitua a sintaxe de outros dialetos pelo T-SQL. Por exemplo, use TOP ou OFFSET ... FETCH em vez de LIMIT, e colchetes ou aspas duplas em vez de crases.

    SELECT TOP (10) * FROM dbo.Orders ORDER BY OrderDate DESC;
    SELECT * FROM dbo.Orders ORDER BY OrderDate DESC OFFSET 0 ROWS FETCH NEXT 10 ROWS ONLY;
  3. Termine a instrução anterior com ponto e vírgula antes de uma CTE ou THROW.

    DECLARE @n int = 5;
    WITH recent AS (SELECT TOP (@n) * FROM dbo.Orders ORDER BY OrderDate DESC)
    SELECT * FROM recent;
  4. Coloque GO antes das instruções que devem iniciar um lote.

    CREATE TABLE dbo.T (id int);
    GO
    CREATE VIEW dbo.V AS SELECT id FROM dbo.T;
  5. Verifique o nível de compatibilidade do banco de dados se a sintaxe mais recente for rejeitada.

    SELECT name, compatibility_level FROM sys.databases WHERE name = DB_NAME();

Reproduza com segurança

SELECT * FROM sys.objects LIMIT 10;  -- Msg 102: Incorrect syntax near 'LIMIT'.

Erros relacionados

Mais erros de sintaxe e de compilação

O código e o texto da mensagem são de Referência de eventos e erros do Microsoft Database Engine. Veja toda a Lista de erros do SQL Server ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com SQL Server no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o SQL Server e os outros bancos de dados que você usa.