Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB
Validação de esquema
Nesta página
A validação de esquema permite criar regras de validação para seus campos, como tipos de dados permitidos e intervalos de valores.
O MongoDB usa um modelo de esquema flexível, o que significa que os documentos em uma collection não precisam ter os mesmos campos ou tipos de dados por padrão. Depois de estabelecer um esquema de aplicativo, você pode usar a validação de esquema para garantir que não haja alterações de esquema não intencionais ou tipos de dados impróprios.
Você pode implementar validação de esquema na UI para sistemas hospedados no MongoDB Atlas.
Quando usar a validação de esquema
As necessidades de validação de esquema dependem de como os usuários usam seu aplicativo. Quando seu aplicativo está nos estágios iniciais de desenvolvimento, a validação de esquema pode impor restrições inúteis porque você não sabe como deseja organizar seus dados. Especificamente, os campos em suas collections podem mudar ao longo do tempo.
A validação de esquema é mais útil para um aplicativo estabelecido em que você tem uma boa noção de como organizar seus dados. Você pode usar a validação de esquema nos seguintes cenários:
Para uma coleta de usuários, garanta que o campo
passwordseja somente armazenado como uma string. Esta validação impede que os usuários salvem sua senha como um tipo de dados inesperado, como uma imagem.Para uma collection de vendas, certifique-se de que o campo
itempertença a uma lista de itens que sua loja vende. Essa validação evita que um usuário acidentalmente digite incorretamente um nome de item ao inserir dados de vendas.Para uma collection de alunos, certifique-se de que o campo
gpaseja sempre um número positivo. Essa validação evita erros durante a entrada de dados.
Quando o MongoDB verifica a validação
Depois de adicionar regras de validação de esquema a uma collection:
Todas as inserções de documentos devem corresponder às regras.
O nível de validação do esquema define como as regras são aplicadas aos documentos existentes e às atualizações de documentos. Para saber mais, consulte Especificar nível de validação para documentos existentes.
Para localizar documentos em uma collection que não correspondam às regras de validação do esquema, consulte Localizar documentos que não correspondem ao esquema.
O que acontece quando um documento falha na validação
Por padrão, quando uma operação de inserção ou atualização resultaria em um documento inválido, o MongoDB rejeita a operação e não grava o documento na coleta.
Como alternativa, você pode configurar o MongoDB para permitir documentos inválidos e registrar avisos quando ocorrerem violações de esquema.
Para saber mais, consulte Escolher como lidar com documentos inválidos.
Começar
Para tarefas comuns envolvendo validação de esquema, consulte as seguintes páginas:
Saiba mais
Para saber mais sobre o modelo de esquema flexível do MongoDB, consulte Modelagem de dados.