// SQL Server 错误参考

SQL Server 错误 102:附近有语法错误

T-SQL 解析器遇到了意外的内容。引用的文本是解析停止的位置;真正的错误通常就在它之前。

错误编号
102
严重性
15
类别
语法与编译
错误信息
Incorrect syntax near '%.*ls'.

它的意思

SQL Server 在运行任何语句之前会解析整个批处理。错误 102 意味着解析器在该位置发现了一个不应出现的标记,并引用了它(Incorrect syntax near ',')。错误里点名的记号就是解析器放弃的位置,通常就在真正的错误之后:少了个逗号、有个括号没闭合,或者是用了其他数据库的语法。由于解析失败,批处理里什么都没有执行。

常见原因

  • 来自其他数据库的语法: LIMIT 10 (MySQL、PostgreSQL),反引号括起来的名称, || 在旧版本中用于字符串拼接, CREATE TABLE IF NOT EXISTS.
  • 列列表中缺少或多余的逗号,或末尾逗号在 FROM 或者 ).
  • 括号或引号不配对。
  • 必须放在批处理最前面的语句,例如 CREATE VIEW 或者 CREATE PROCEDURE,而没有 GO 在它之前。
  • 在 WITH (一个 CTE) 或 THROW,随后会被当作前一条语句的一部分读取。
  • 在较旧的服务器或兼容级别上使用较新的语法,例如 STRING_AGG 或者 CREATE OR ALTER.

如何修复它

  1. 查看引号标记前的文本和消息中的行号;错误通常就在这里。

  2. 将其他方言的语法替换为 T-SQL。例如,使用 TOP 或者 OFFSET ... FETCH 代替 LIMIT,并使用方括号或双引号代替反引号。

    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. 先用分号结束上一条语句,再写 CTE 或 THROW.

    DECLARE @n int = 5;
    WITH recent AS (SELECT TOP (@n) * FROM dbo.Orders ORDER BY OrderDate DESC)
    SELECT * FROM recent;
  4. 放入 GO 在必须启动批处理的语句之前。

    CREATE TABLE dbo.T (id int);
    GO
    CREATE VIEW dbo.V AS SELECT id FROM dbo.T;
  5. 如果新的语法被拒绝,请检查数据库的兼容性级别。

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

安全地复现它

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

相关错误

更多语法和编译错误

代码和消息文本来自 Microsoft 数据库引擎事件和错误参考。浏览完整的 SQL Server 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQL Server

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQL Server 以及你使用的其他数据库。