Dos modelos às consultas SQL
O ORM (Object-Relational Mapping) é o mapeamento entre objetos do código e tabelas de um banco relacional. Uma biblioteca de ORM usa esse mapeamento para consultar e alterar registros por meio de classes da aplicação. Assim, você expressa uma busca com métodos do modelo e a biblioteca produz o SQL correspondente.
No Eloquent, o ORM do Laravel, cada modelo corresponde a uma tabela. Uma instância desse modelo representa um registro, com atributos associados às colunas. A documentação do Laravel 12.x descreve as convenções de nomes e permite configurar a tabela usada por uma classe.
Consulta de contatos ativos
Neste exemplo didático, o projeto já tem o modelo Contact associado à tabela contacts, com as colunas active e name. A expressão Contact::where('active', true)->get() consulta os contatos ativos e devolve uma coleção de modelos. Você pode percorrer essa coleção e ler o atributo name de cada contato para montar a lista na interface.
O método where define o filtro aplicado aos registros no banco. A chamada a get() executa a consulta e reúne os resultados em memória, portanto uma lista extensa pode precisar de paginação. A classe e os nomes de colunas pertencem ao exemplo: criar somente a classe Contact não cria a tabela necessária para executar a busca.
Relações que geram consultas adicionais
Ao exibir o nome da empresa de cada contato, a aplicação também acessa uma relação entre modelos. Se essa relação for carregada individualmente durante a montagem da lista, cada contato pode provocar outra consulta. O resultado na tela pode parecer correto mesmo com um número de consultas que cresce junto da lista.
O Eloquent permite carregar as relações em conjunto com eager loading para reduzir esse padrão conhecido como N+1. A documentação de relações explica seu funcionamento e suas limitações. Você pode comparar as consultas executadas com o volume exibido para conferir o efeito no projeto. A autorização para acessar cada contato continua sob responsabilidade da aplicação.
Dúvidas frequentes
Perguntas frequentes sobre ORM
- O ORM cria as tabelas automaticamente?
- O mapeamento e a criação da estrutura são funções diferentes. No Laravel, uma classe de modelo representa registros de uma tabela existente. As migrations descrevem alterações nessa estrutura e precisam ser executadas para aplicá-las ao banco.
- Usar um ORM dispensa conhecer o SQL?
- O ORM gera consultas SQL, mas você ainda precisa entender quais registros serão lidos ou alterados. O tempo de resposta depende das consultas produzidas e dos índices disponíveis, além do volume de registros.
- O modelo restringe o acesso ao registro encontrado?
- Encontrar um registro pelo modelo não confirma a autorização para consultá-lo ou modificá-lo. No Laravel, políticas e gates permitem implementar essa autorização. A aplicação precisa verificar as permissões para a ação solicitada.
Para continuar
Recursos relacionados
Site de referência
Desenvolvimento Colaborativo da Dev Side Studio
Orientação técnica ao vivo para inspecionar o SQL gerado pelo ORM e investigar consultas adicionais no carregamento de relações.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O ORM permite trabalhar com modelos da aplicação e exige conferir as consultas produzidas durante a revisão do código.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.