VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
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çãoCHECK junto com a coluna ou como uma restrição no nível da tabela:
Aplicação
O MySQL aplica restriçõesCHECK em INSERT e UPDATE. Uma violação retorna ERROR 3819 (HY000): Check constraint 'name' is violated.:
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:Desabilitando a Aplicação
Desabilite uma restrição específica sem removê-la: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çõesCHECK 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õesCHECK 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áusulasCHECK existentes são válidas e contêm regras que você quer aplicadas.
Solução de Problemas
Veja também
- Normalização no MySQL — o design de esquema que as restrições CHECK complementam
- Triggers do MySQL — uma alternativa às restrições CHECK para validação complexa
- NULL no MySQL — restrições CHECK e NULL interagem de formas não óbvias