// PostgreSQL 錯誤參考

PostgreSQL 42883:函式不存在

沒有函式或運算子與該名稱及這些引數型別相符。通常是缺少型別轉換、缺少擴充功能,或函式位於另一個結構描述中。

SQLSTATE
42883
名稱
undefined_function
類別
語法錯誤或存取規則違反
錯誤訊息
function lower(integer) does not exist
LINE 1: SELECT lower(42);
               ^
HINT:  No function matches the given name and argument types. You might need to add explicit type casts.

它的意義

PostgreSQL 會依函式名稱與引數的類型挑選函式。42883 表示沒有任何函式在 search_path 會接受你傳入的型別,即使有隱含轉換也行。同一套程式碼也涵蓋運算子,例如 operator does not exist: integer = text.

自 PostgreSQL 8.3 起,大多數型別不再隱含轉換為文字,因此為舊版或其他資料庫撰寫的程式碼常常會遇到這個問題。

常見原因

  • 參數型別不符:將整數傳遞給文字函式,或比較 integer = text.
  • 呼叫未在此資料庫安裝的擴充套件中的函式(uuid_generate_v4(), crypt(), similarity()).
  • 該函式所在的結構描述不在 search_path.
  • 呼叫另一個資料庫中的函式,例如 MySQL 的 IFNULL 或 DATE_FORMAT.
  • 來自驅動程式的未知類型參數:一個繫結 $1 其型別 PostgreSQL 無法推斷。

如何修正

  1. 將引數轉換成函式預期的類型。

    SELECT lower(42::text);
    SELECT * FROM orders WHERE id = '42'::int;
  2. 在此資料庫中安裝提供該函式的擴充功能。

    CREATE EXTENSION IF NOT EXISTS pgcrypto;
    SELECT gen_random_uuid();  -- built in since PostgreSQL 13
  3. 找出該函式及其參數的型別,然後以結構描述限定的名稱呼叫。

    SELECT n.nspname, p.proname, pg_get_function_identity_arguments(p.oid)
    FROM pg_proc p JOIN pg_namespace n ON n.oid = p.pronamespace
    WHERE p.proname = 'my_func';
  4. 將其他資料庫的函式取代為 PostgreSQL 的函式: IFNULL 變成 COALESCE, DATE_FORMAT 變成 to_char, NOW() 可直接使用。

安全地重現問題

SELECT lower(42);  -- ERROR: function lower(integer) does not exist

相關錯誤

更多語法錯誤或存取規則違規錯誤

程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。