O programa termina com um erro fatal, ou com uma mensagem de erro do sistema operacional que aponta para um problema no programa (um exemplo oposto seria uma mensagem de “disco cheio”, porque você mesmo deve corrigir esse problema).

O programa produz uma saída errada para qualquer entrada dada.

O programa se recusa a aceitar uma entrada válida (conforme definido na documentação).

O programa aceita uma entrada inválida sem mostrar uma mensagem de erro. Porém, tenha em mente que a sua ideia de entrada inválida pode ser a nossa ideia de uma extensão, ou de compatibilidade com a prática tradicional.

O PostgreSQL falha ao compilar, construir ou instalar segundo as instruções nas plataformas com suporte.

A sequência exata dos passos, desde o início do programa, necessários para reproduzir o problema. Isto deve estar autocontido; não é suficiente enviar meramente o comando SELECT, sem enviar os comandos CREATE TABLE e INSERT que o precederam, caso a saída dependa dos dados contidos nas tabelas. Não temos tempo para realizar a engenharia reversa do esquema do seu banco de dados e, se tivermos que criar nossos próprios dados, provavelmente não vamos conseguir reproduzir o problema.

O melhor formato para um caso de teste, para problemas relacionados com a linguagem SQL, é um arquivo mostrando o problema que possa ser executado a partir da interface cliente psql (certifique-se de não existir nada em seu arquivo de inicialização ~/.psqlrc). Uma maneira fácil de criar esse arquivo é usando o pg_dump para gerar as declarações da tabela e dos dados necessários para montar o cenário e, depois, adicionar o comando com problema. Encorajamos você a minimizar o tamanho do exemplo, mas isto não é absolutamente necessário. Se o erro for reproduzível, nós o encontraremos de qualquer maneira.

Se a sua aplicação utiliza alguma outra interface cliente, tal como o PHP, então, por favor, tente isolar o comando com o problema. Provavelmente não iremos configurar um servidor Web para reproduzir o seu problema. De qualquer maneira, lembre-se de fornecer os arquivos de entrada exatos, e não suponha que o problema aconteça com “arquivos grandes”, ou “bancos de dados de tamanho médio”, etc., porque estas informações são muito pouco precisas para serem úteis.

A saída obtida. Por favor, não diga que “não funcionou” ou que “deu pau” (crashed). Se houver uma mensagem de erro, mostre-a, mesmo que você não a entenda. Se o programa terminar com um erro do sistema operacional, diga qual. Se nada acontecer, informe. Mesmo que o resultado do seu caso de teste seja o término anormal do programa, ou seja, óbvio de alguma outra forma, pode ser que não aconteça na nossa plataforma. O mais fácil a ser feito é copiar a saída do terminal diretamente, se isso for possível.

É muito importante especificar o que você espera como saída. Se for escrito apenas “Esse comando produz essa saída”, ou “Isso não é o que eu esperava”, poderemos executar, olhar a saída, e achar que está tudo correto, exatamente o que esperávamos que acontecesse. Não devemos gastar tempo decodificando a semântica exata por trás de seus comandos. Abstenha-se, particularmente, de dizer meramente “Isto não é o que o SQL diz ou o que o Oracle faz”. Pesquisar o comportamento correto do SQL não é uma tarefa divertida, nem sabemos como todos os outros bancos de dados relacionais existentes se comportam (se o problema for o término anormal do programa, esse item obviamente pode ser omitido).

Todas as opções de linha de comando e outras opções de inicialização, incluindo as variáveis de ambiente relevantes e os arquivos de configuração alterados em relação ao padrão. Novamente, forneça a informação exata. Se estiver sendo utilizada uma distribuição pré-configurada, que inicializa o servidor de banco de dados durante o boot, você deve tentar descobrir como isto é feito.

Qualquer coisa que você tenha feito que seja diferente das instruções de instalação.

A versão do PostgreSQL. Pode ser executado o comando SELECT version(); para descobrir a versão do servidor ao qual você está conectado. A maioria dos programas executáveis também têm a opção --version; pelo menos postgres --version e psql --version devem funcionar.

$ postgres --version
postgres (PostgreSQL) 14.5
$ psql --version
psql (PostgreSQL) 14.5

Se a função ou as opções não existirem, então a versão sendo usada é mais que antiga o suficiente para merecer uma atualização. Se estiver sendo usada uma versão pré-configurada, como RPMs, informe, incluindo qualquer sub-versão que o pacote possa ter. Se estiver se referindo a uma versão do Git, isto deve ser mencionado, incluindo a data e a hora da versão.

Se a sua versão for anterior a 14.5, quase certamente lhe pediremos para atualizar. Existem muitas correções de erro e melhorias a cada nova liberação, portanto é bem possível que o erro encontrado em uma versão antiga do PostgreSQL já esteja corrigido. Só podemos oferecer suporte limitado às instalações usando versões antigas do PostgreSQL; se for desejado mais do que pode ser fornecido, deve ser levado em consideração a contratação de um suporte comercial.

Informações da plataforma. Isto inclui o nome e a versão do núcleo, a biblioteca C, o processador e a memória. Geralmente basta informar o fornecedor e a versão, mas não se deve supor que todo mundo saiba exatamente o que o “Debian” contém, ou que todo mundo use x86_64. Havendo problemas de instalação, então também são necessárias informações sobre as ferramentas empregadas (compilador, make, etc.).