PostgreSQL 23502: valor nulo viola restrição de não-nulo
Um INSERT ou UPDATE deixou uma coluna NOT NULL vazia, geralmente porque a coluna foi omitida e não tem padrão.
- SQLSTATE
23502- Nome
not_null_violation- Categoria
- Violação de restrição de integridade
O que significa
A NOT NULL a coluna deve ter um valor em cada linha. 23502 significa que a nova linha ou a linha atualizada tinha NULL lá, seja explicitamente ou porque a coluna foi deixada de fora de um INSERT e seu valor padrão é NULL.
O DETAIL a linha mostra a linha inteira que falhou. O PostgreSQL 13 e posteriores nomeiam a tabela na mensagem; as versões mais antigas dizem apenas null value in column "email" violates not-null constraint.
Causas comuns
- O
INSERTnão lista a coluna e a coluna não possuiDEFAULT. - O aplicativo enviou
NULL, por exemplo, um campo não definido ou uma busca que falha. INSERT ... SELECTou umUPDATEcom uma subconsulta que não retornou nenhuma linha, produzindoNULL.- Uma coluna adicionada com
NOT NULLque o código existente não conhece.
Como corrigir
-
Forneça o valor ou dê à coluna um valor padrão.
INSERT INTO users (id, name, email) VALUES (7, 'Ada', '[email protected]'); ALTER TABLE users ALTER COLUMN created_at SET DEFAULT now();
-
Use
COALESCEquando uma busca ou expressão pode retornarNULL.UPDATE orders o SET region = COALESCE((SELECT region FROM customers c WHERE c.id = o.customer_id), 'unknown');
-
Se a coluna deve permitir valores ausentes, remova a restrição.
ALTER TABLE users ALTER COLUMN phone DROP NOT NULL;
Reproduza com segurança
CREATE TEMP TABLE u (id int, email text NOT NULL); INSERT INTO u (id) VALUES (1); -- ERROR: null value in column "email" of relation "u" violates not-null constraint
Erros relacionados
23505chave duplicada viola a restrição única23503violação de restrição de chave estrangeira23514violação de restrição de verificação515SQL Server: Não é possível inserir o valor NULL na coluna1048MySQL: a coluna não pode ser nula1364MySQL: o campo não tem valor padrãoORA-01400Oracle: não é possível inserir NULL na colunaSQLITE_CONSTRAINT_NOTNULLSQLite: falha na restrição NOT NULL
Mais erros de violação de restrição de integridade
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.
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.