// Referencia de errores de PostgreSQL

PostgreSQL 58P01: archivo inexistente

Un archivo que el servidor intentó abrir no existe en el servidor de bases de datos; normalmente se trata de COPY FROM con una ruta que solo existe en tu equipo o de una biblioteca de extensión que falta.

SQLSTATE
58P01
Nombre
undefined_file
Categoría
Error del sistema (errores externos a PostgreSQL en sí)
Mensaje de error
could not open file "/tmp/orders.csv" for reading: No such file or directory

Qué significa

58P01 (undefined_file) significa que PostgreSQL recibió «no such file» del sistema operativo. Lo importante es dónde: en el servidor COPY ... FROM '/path', pg_read_file() y CREATE EXTENSION busca en el sistema de archivos del servidor de bases de datos, no en el cliente que ejecuta la consulta.

El otro caso frecuente es que falte una biblioteca compartida, could not access file "$libdir/postgis-3": No such file or directory, después de una actualización o en un servidor donde no esté instalado el paquete de la extensión.

Causas comunes

  • COPY FROM con una ruta en tu portátil mientras el servidor se ejecuta en otra máquina o en un contenedor.
  • Una ruta relativa, que el servidor resuelve en relación con su directorio de datos.
  • El paquete de una extensión no está instalado en el servidor, o es para una versión principal diferente después de pg_upgrade.
  • shared_preload_libraries lista una biblioteca que no está instalada.

Cómo solucionarlo

  1. Cargar archivos del lado del cliente con el comando de psql \copy, que lee el archivo en el cliente y lo envía al servidor.

    \copy orders FROM 'orders.csv' WITH (FORMAT csv, HEADER true)
  2. O transmite desde el cliente con la función de tu controlador COPY FROM STDIN soporte.

  3. Instala el paquete de la extensión para la versión principal del servidor (por ejemplo postgresql-16-postgis-3), luego crea o actualiza la extensión.

    CREATE EXTENSION postgis;
    ALTER EXTENSION postgis UPDATE;

Errores relacionados

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.