// PostgreSQL 錯誤參考
PostgreSQL 42601:在或鄰近處出現語法錯誤
PostgreSQL 無法解析該語句。它所指出的標記,以及其下方的插入符號,標示了解析失敗的位置;真正的錯誤通常就在它之前。
- SQLSTATE
42601- 名稱
syntax_error
它的意義
解析器讀到訊息所指的那個標記為止,並發現接下來不可能出現的內容。 syntax error at end of input 表示陳述式停在本來還預期有更多內容的地方,例如少了一個右括號。
這個位置是 PostgreSQL 察覺到問題的地方,實際的錯誤往往是前一個標記:例如多餘的結尾逗號出現在 FROM、欄位之間缺少逗號,或使用保留字作為名稱。
常見原因
- 尾隨逗號出現在
FROM,)或WHERE之前的尾隨逗號,或者項目之間缺少逗號。 - 保留字未加引號就當成欄位或資料表名稱用,例如
user,order或group. - 來自其他資料庫的語法:
TOP,[brackets]、反引號,LIMIT x, y,IFNULL. - 括號或引號未閉合,會在輸入結尾顯示為錯誤。
- 客戶端佔位符(
?,:name,%s)會在驅動程式不做替換的情況下傳送到伺服器;PostgreSQL 本身則使用$1,$2.
如何修正
-
查看訊息指出的標記與其前一個標記;移除多餘的逗號,或補上缺少的逗號。
SELECT id, name FROM users;
-
為用作識別碼的保留字加上引號,或將其重新命名。
SELECT "user", "order" FROM audit_log;
-
將其他方言的語法改寫成 PostgreSQL 的形式。
-- SQL Server: SELECT TOP 10 * FROM [orders] SELECT * FROM orders LIMIT 10; -- MySQL: LIMIT 20, 10 SELECT * FROM orders LIMIT 10 OFFSET 20;
-
對於 PL/pgSQL 主體,請使用 dollar quoting,這樣主體內的引號就不會提前結束字串。
CREATE FUNCTION greet(name text) RETURNS text LANGUAGE plpgsql AS $$ BEGIN RETURN 'Hello, ' || name; END; $$;
安全地重現問題
SELECT id, FROM (VALUES (1)) v(id); -- ERROR: syntax error at or near "FROM"
相關錯誤
42703欄位不存在42P01關聯不存在42883函式不存在102SQL Server:附近的語法不正確1064MySQL:你的 SQL 語法有錯誤ORA-00933Oracle:SQL 命令未正確結束
更多語法錯誤或存取規則違規錯誤
42501權限遭拒42846無法強制轉換42803欄位必須出現在 GROUP BY 子句中42830無效的外鍵42804資料類型不符42P18無法判斷參數的資料類型42P02沒有參數42704未定義的物件
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。