// Referência de erro do PostgreSQL

PostgreSQL 3D000: banco de dados não existe

A conexão aponta para um banco de dados que não está neste servidor. Geralmente é um erro de digitação, uma diferença de maiúsculas e minúsculas ou um cliente que usa o nome do usuário como nome do banco de dados.

SQLSTATE
3D000
Nome
invalid_catalog_name
Categoria
Nome de catálogo inválido
Mensagem de erro
database "shop" does not exist

O que significa

Toda conexão PostgreSQL é feita a um único banco de dados, indicado na string de conexão. Se não houver nenhum banco com esse nome no servidor que você alcançou, o login para com 3D000.

Os nomes de banco de dados diferenciam maiúsculas de minúsculas quando criados com aspas, e muitos clientes preenchem um padrão: psql e o libpq usa o nome do usuário como nome do banco de dados quando nenhum é fornecido, então psql -U app tenta abrir um banco de dados chamado app.

Causas comuns

  • Um erro de digitação, ou um banco de dados criado com um nome entre aspas contendo maiúsculas e minúsculas, como "Shop".
  • Nenhum banco de dados fornecido, então o cliente usou o nome do usuário como nome do banco de dados.
  • Conectando ao servidor ou porta errados (outra instância, um contêiner diferente) onde o banco de dados nunca foi criado.
  • O banco de dados foi removido ou ainda não foi criado pelos scripts de configuração.

Como corrigir

  1. Conecte-se a um banco de dados que sempre exista, como postgres, e liste os bancos de dados.

    -- psql -h db -U app -d postgres
    SELECT datname FROM pg_database ORDER BY datname;
  2. Crie o banco de dados se ele deve existir.

    CREATE DATABASE shop OWNER app;
  3. Passe o nome do banco de dados explicitamente na string de conexão, por exemplo postgresql://app@db:5432/shop ou psql -d shop.

  4. Se ele foi criado com letras maiúsculas, use o nome exato. Em uma URL ou -d opção não são necessárias aspas: psql -d Shop.

Perguntas

Por que o psql diz que o banco de dados não existe quando eu dei apenas um nome de usuário?

Quando nenhum banco de dados é especificado, o psql conecta-se a um banco de dados com o mesmo nome do usuário. Adicione -d postgres ou o banco de dados que você deseja.

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.