// Referência de erro do PostgreSQL

PostgreSQL 58P01: arquivo não definido

Um arquivo que o servidor tentou abrir não existe no servidor de banco de dados, tipicamente COPY FROM de um caminho que só existe na sua máquina, ou uma biblioteca de extensão faltando.

SQLSTATE
58P01
Nome
undefined_file
Categoria
Erro do sistema (erros externos ao próprio PostgreSQL)
Mensagem de erro
could not open file "/tmp/orders.csv" for reading: No such file or directory

O que significa

58P01 (undefined_file) significa que o PostgreSQL recebeu «no such file» do sistema operacional. O detalhe importante é onde: do lado do servidor COPY ... FROM '/path', pg_read_file() e CREATE EXTENSION busca no sistema de arquivos do servidor de banco de dados, não no cliente que executa a consulta.

O outro caso frequente é uma biblioteca compartilhada ausente, could not access file "$libdir/postgis-3": No such file or directory, após uma atualização ou em um servidor onde o pacote de uma extensão não está instalado.

Causas comuns

  • COPY FROM com um caminho no seu laptop enquanto o servidor roda em outra máquina ou em um contêiner.
  • Um caminho relativo, que o servidor resolve em relação ao seu diretório de dados.
  • O pacote de uma extensão não está instalado no servidor, ou é para uma versão principal diferente após pg_upgrade.
  • shared_preload_libraries listar uma biblioteca que não está instalada.

Como corrigir

  1. Carregar arquivos do lado do cliente com o comando do psql \copy, que lê o arquivo no cliente e o envia em streaming para o servidor.

    \copy orders FROM 'orders.csv' WITH (FORMAT csv, HEADER true)
  2. Ou transmita do cliente com o COPY FROM STDIN suporte.

  3. Instale o pacote da extensão para a versão principal do servidor (por exemplo postgresql-16-postgis-3), em seguida, crie ou atualize a extensão.

    CREATE EXTENSION postgis;
    ALTER EXTENSION postgis UPDATE;

Erros relacionados

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.