// 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 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQL Server 和你使用的其他資料庫。