O Query Builder do Laravel oferece uma vasta gama de métodos para construir consultas SQL de forma intuitiva. Aqui estão os mais utilizados, com uma explicação e exemplos de cada um:
1. select()
Define quais colunas devem ser retornadas na consulta.
Retorna apenas as colunas id e nome da tabela microbio.
2. where()
Aplica uma condição à consulta.
- Retorna os registos onde
micro_idé igual a 1.
Variantes:
orWhere(): Adiciona uma condiçãoOR.whereIn(): Verifica se o valor está numa lista.whereNull()/whereNotNull(): Verifica valores nulos ou não nulos.
3. join()
Faz uma junção entre tabelas.
- Junta a tabela
micro_armarioscomarmariose retorna a localização dos armários e a quantidade.
Variantes:
leftJoin(): Junção à esquerda.rightJoin(): Junção à direita.
4. orderBy()
Ordena os resultados.
- Ordena os micróbios pelo nome em ordem ascendente.
Variante:
orderByDesc(): Ordenação descendente.
5. groupBy()
Agrupa os resultados com base em uma ou mais colunas.
- Agrupa os registos pelo
arm_ide calcula o total deqt.
6. having()
Aplica condições aos grupos (usado após groupBy).
Retorna apenas os grupos onde a soma de qt é maior que 10.
7. limit() e offset()
Controlam o número de resultados e a posição inicial.
Retorna 5 registos começando no 11.º.
8. pluck()
Obtém uma lista de valores de uma única coluna.
Retorna uma lista simples com os nomes dos micróbios.
9. count(), sum(), avg(), max(), min()
Executam cálculos sobre os dados.
Calculam a soma ou média da coluna qt.
10. raw()
Permite escrever SQL puro quando necessário.
Conta o total de registos na tabela microbio.
11. insert()
Insere novos registos na tabela.
Adiciona um novo registo na tabela micro_armarios.
12. update()
Atualiza registos existentes.
Atualiza a quantidade para 15 no registo com id = 1.
13. delete()
Remove registos.
Remove o registo com id = 1 da tabela micro_armarios.
Estes métodos são a base do Query Builder e podem ser combinados para criar consultas complexas de forma eficiente e legível.
