// Referencia de errores de SQL Server

Error 102 de SQL Server: sintaxis incorrecta cerca de

El analizador de T-SQL encontró algo que no esperaba. El texto entre comillas es donde se detuvo el análisis; el error real suele estar justo antes.

Número de error
102
Gravedad
15
Categoría
Sintaxis y compilación
Mensaje de error
Incorrect syntax near '%.*ls'.

Qué significa

SQL Server analiza todo el lote antes de ejecutar cualquiera de sus partes. El error 102 significa que el analizador encontró un token que no puede aparecer en ese punto y lo cita (Incorrect syntax near ','). El token indicado es donde el parser se rindió, y suele estar justo después del error real: una coma que falta, un paréntesis sin cerrar o sintaxis de otra base de datos. Como el análisis falló, no se ejecutó nada del lote.

Causas comunes

  • Sintaxis de otra base de datos: LIMIT 10 (MySQL, PostgreSQL), nombres entre comillas invertidas, || para concatenar cadenas en versiones anteriores, CREATE TABLE IF NOT EXISTS.
  • Una coma de más o de menos en una lista de columnas, o una coma final antes de FROM o ).
  • Paréntesis o comillas sin cerrar.
  • Una instrucción que debe ser la primera en su lote, como CREATE VIEW o CREATE PROCEDURE, sin un GO antes de ella.
  • Falta un punto y coma antes de WITH (un CTE) o THROW, que luego se leen como parte de la instrucción anterior.
  • Sintaxis más nueva en un servidor o nivel de compatibilidad más antiguo, como STRING_AGG o CREATE OR ALTER.

Cómo solucionarlo

  1. Mira el texto justo antes del token citado y el número de línea en el mensaje; ahí es donde normalmente está el error.

  2. Reemplaza la sintaxis de otros dialectos con T-SQL. Por ejemplo, usa TOP o OFFSET ... FETCH en lugar de LIMIT, y corchetes o comillas dobles en lugar de acentos graves.

    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. Termina la instrucción anterior con un punto y coma antes de un CTE o THROW.

    DECLARE @n int = 5;
    WITH recent AS (SELECT TOP (@n) * FROM dbo.Orders ORDER BY OrderDate DESC)
    SELECT * FROM recent;
  4. Coloca GO antes de las instrucciones que deben iniciar un lote.

    CREATE TABLE dbo.T (id int);
    GO
    CREATE VIEW dbo.V AS SELECT id FROM dbo.T;
  5. Verifica el nivel de compatibilidad de la base de datos si se rechaza la sintaxis más reciente.

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

Reprodúcelo de forma segura

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

Errores relacionados

Más errores de sintaxis y compilación

El código y el texto del mensaje son de Referencia de eventos y errores del motor de base de datos de Microsoft. Explora la lista completa de Lista de errores de SQL Server o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con SQL Server en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para SQL Server y las demás bases de datos que uses.