// 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。