// Referência de erro do SQL Server

Erro do SQL Server 547: A instrução entrou em conflito com uma restrição

Um INSERT, UPDATE ou DELETE violou uma restrição FOREIGN KEY ou CHECK: uma linha filha sem pai, um pai que ainda tem filhos, ou um CHECK que falhou.

Número do erro
547
Gravidade
16
Categoria
Restrições e chaves
Mensagem de erro
The %ls statement conflicted with the %ls constraint "%.*ls". The conflict occurred in database "%.*ls", table "%.*ls"%ls%.*ls%ls.

O que significa

O erro 547 cobre dois tipos de restrição. Com uma FOREIGN KEY, significa que a instrução deixaria uma referência apontando para o nada: inserir ou atualizar uma linha filha cujo pai não existe, ou excluir ou alterar um pai que linhas filhas ainda usam. Com uma CHECK restrição, significa que uma linha não passou na condição da restrição. A mensagem nomeia o tipo de instrução, a restrição e o banco de dados, tabela e coluna envolvidos.

Causas comuns

  • Inserindo uma linha filha com um valor de chave estrangeira que não tem uma linha pai correspondente (id errado, ou o pai ainda não foi inserido).
  • Excluir uma linha pai, ou alterar sua chave, enquanto linhas filhas a referenciam.
  • Um valor que falha em uma CHECK restrição, como uma quantidade negativa.
  • Adicionar uma chave estrangeira ou restrição CHECK a uma tabela cujos dados existentes já a violam (ALTER TABLE ... ADD CONSTRAINT).
  • Carregar as tabelas na ordem errada: filhos antes dos pais.

Como corrigir

  1. Leia o nome da restrição na mensagem e depois veja o que ela impõe.

    SELECT fk.name, OBJECT_NAME(fk.parent_object_id) AS child_table,
           OBJECT_NAME(fk.referenced_object_id) AS parent_table,
           fk.delete_referential_action_desc
    FROM sys.foreign_keys AS fk WHERE fk.name = N'FK_Orders_Customers';
  2. Para uma inserção, certifique-se de que o pai exista primeiro, ou insira os pais antes dos filhos.

    SELECT * FROM dbo.Customers WHERE CustomerId = 42;
  3. Para uma exclusão, primeiro remova ou reatribua as linhas filhas, ou defina a chave com ON DELETE CASCADE se quiser excluir as linhas filhas junto com a linha pai.

    DELETE FROM dbo.Orders WHERE CustomerId = 42;
    DELETE FROM dbo.Customers WHERE CustomerId = 42;
  4. Ao adicionar uma restrição a dados existentes, encontre as linhas que a violam.

    SELECT o.*
    FROM dbo.Orders AS o
    LEFT JOIN dbo.Customers AS c ON c.CustomerId = o.CustomerId
    WHERE o.CustomerId IS NOT NULL AND c.CustomerId IS NULL;

Reproduza com segurança

Tabelas temporárias não podem ter chaves estrangeiras, então a reprodução usa uma restrição CHECK; uma violação de FOREIGN KEY gera o mesmo número de erro.

CREATE TABLE #p (id int PRIMARY KEY);
CREATE TABLE #c (id int, CHECK (id > 0));
INSERT INTO #c VALUES (-1);  -- Msg 547: The INSERT statement conflicted with the CHECK constraint ...
DROP TABLE #c; DROP TABLE #p;

Perguntas

Como faço para excluir uma linha que outras tabelas referenciam?

Exclua ou atualize primeiro as linhas que fazem referência, ou mude a chave estrangeira para ON DELETE CASCADE ou ON DELETE SET NULL se isso fizer sentido para os dados. Desativar a restrição deixa linhas órfãs para trás.

Erros relacionados

Mais erros de restrições e chaves

O código e o texto da mensagem são de Referência de eventos e erros do Microsoft Database Engine. Veja toda a Lista de erros do SQL Server ou pesquise todos os erros do banco de dados.

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

Trabalhe com SQL Server 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 SQL Server e os outros bancos de dados que você usa.