Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
O MySQL aplica restrições CHECK. A sintaxe era aceita em versões mais antigas, mas ignorada silenciosamente — um comportamento que surpreendeu muitos desenvolvedores que migraram do PostgreSQL.

Definindo Restrições CHECK

Adicione uma restrição CHECK junto com a coluna ou como uma restrição no nível da tabela:
Ou junto com a definição da coluna:
Restrições no nível da tabela são necessárias quando a expressão de verificação abrange várias colunas:

Aplicação

O MySQL aplica restrições CHECK em INSERT e UPDATE. Uma violação retorna ERROR 3819 (HY000): Check constraint 'name' is violated.:
A mensagem de erro inclui o nome da restrição, e é por isso que nomear as restrições vale a digitação extra. Restrições CHECK não são avaliadas em DELETE. Elas também não são reavaliadas quando a própria restrição é adicionada a uma tabela existente — adicionar uma restrição a uma tabela com dados existentes que a violam falha imediatamente.

Adicionando e Removendo Restrições

Adicione uma restrição a uma tabela existente:
Remova uma restrição nomeada:
Liste todas as restrições de uma tabela:

Desabilitando a Aplicação

Desabilite uma restrição específica sem removê-la:
Reabilite-a:
NOT ENFORCED é útil durante migrações de dados, quando você precisa contornar a validação temporariamente. Reabilite a aplicação da restrição quando a migração estiver concluída.

CHECK vs Triggers vs Validação na Aplicação

Use CHECK para regras simples e autocontidas: faixas válidas, valores permitidos, números não negativos, ordem de datas. Use um trigger quando a regra exige consultar outras tabelas. Use a validação na aplicação para regras que envolvem estado externo (limites de taxa, verificações de disponibilidade).

Perguntas Frequentes

As restrições CHECK funcionam em todos os mecanismos de armazenamento?

Sim. Ao contrário de alguns recursos do MySQL, as restrições CHECK funcionam no InnoDB, no MyISAM e em outros mecanismos de armazenamento. Porém, tabelas MyISAM podem ter restrições definidas que são sintaticamente válidas, mas esse mecanismo de armazenamento não tem rollback, então uma restrição que falha no MyISAM pode deixar dados parciais. O InnoDB trata as violações de forma limpa, com rollback completo.

As restrições CHECK podem referenciar outras tabelas?

Não. As expressões CHECK são limitadas à linha atual da tabela atual. Subconsultas, stored functions e referências a outras tabelas não são permitidas em expressões CHECK. Use um trigger para validação entre tabelas.

As restrições CHECK sempre existiram no MySQL?

A sintaxe era aceita em versões mais antigas do MySQL, mas as restrições eram ignoradas silenciosamente. Se você está migrando de um esquema mais antigo, verifique se as cláusulas CHECK existentes são válidas e contêm regras que você quer aplicadas.

Solução de Problemas

Veja também