// PostgreSQL 錯誤參考

PostgreSQL 58P01:找不到檔案

伺服器嘗試開啟的檔案在資料庫伺服器上不存在,通常是 COPY FROM 指向只存在於你自己機器上的路徑,或缺少擴充功能程式庫。

SQLSTATE
58P01
名稱
undefined_file
類別
系統錯誤(PostgreSQL 本身之外的錯誤)
錯誤訊息
could not open file "/tmp/orders.csv" for reading: No such file or directory

它的意義

58P01 (undefined_file)代表 PostgreSQL 從作業系統收到「沒有這個檔案」。重要的細節在哪一端:伺服器端 COPY ... FROM '/path', pg_read_file() 和 CREATE EXTENSION 要在資料庫伺服器的檔案系統上找,而不是在執行查詢的用戶端上。

另一個常見情況是缺少共用程式庫, could not access file "$libdir/postgis-3": No such file or directory,或是在升級後、或伺服器沒安裝該擴充套件時。

常見原因

  • COPY FROM 搭配你筆電上的路徑,而伺服器跑在另一台機器或容器裡。
  • 一個相對路徑,伺服器會以其資料目錄作為基礎來解析。
  • 延伸模組的套件未安裝在伺服器上,或是在 pg_upgrade.
  • shared_preload_libraries 列出未安裝的程式庫。

如何修正

  1. 使用 psql 的 \copy,它會在用戶端讀取檔案,然後串流給伺服器。

    \copy orders FROM 'orders.csv' WITH (FORMAT csv, HEADER true)
  2. 或者從用戶端串流,方法是使用你驅動程式的 COPY FROM STDIN 支援。

  3. 為伺服器的主要版本安裝對應的擴充功能套件(例如 postgresql-16-postgis-3),然後建立或更新擴充功能。

    CREATE EXTENSION postgis;
    ALTER EXTENSION postgis UPDATE;

相關錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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