Busque linhas com query e get
Recupere todas, uma ou uma linha pela chave primária.
Busque linhas com query e get é uma aula grátis de Flask Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Flask Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Flask Academy inclui 4 aulas no total.
A leitura começa com query
Toda leitura do banco de dados começa com o atributo query do modelo. Ele é a sua porta de entrada para buscar linhas como objetos Python. 🔎
rows = User.queryBusque tudo com all
Chame all() em uma consulta para carregar todas as linhas correspondentes em uma lista Python comum que pode percorrer.
users = User.query.all()
for u in users:
print(u.name)Apenas uma com first
Use first() quando quiser uma única linha. Ele retorna a primeira correspondência ou None se a tabela não tiver nada para retornar.
user = User.query.first()Busque pela chave primária
Quando souber o identificador, get() é o caminho mais rápido. Passe a chave primária, e ele retornará exatamente essa linha.
user = User.query.get(7)get retorna None quando não encontra
Se nenhuma linha tiver esse identificador, get() retornará None silenciosamente em vez de gerar uma exceção. Verifique sempre o resultado antes de usá-lo.
user = User.query.get(999)
if user is None:
print("not found")Obtenha um 404 com facilidade
Em uma visão, get_or_404() busca pelo identificador e encerra automaticamente com uma página 404 quando a linha não existe. Não é necessária nenhuma verificação manual.
user = User.query.get_or_404(7)first_or_404 para leituras filtradas
Combine first_or_404() com um filtro para obter uma correspondência ou gerar um 404 limpo quando nada se encaixar.
u = User.query.filter_by(email=e).first_or_404()Conte sem carregar linhas
Precisa de uma contagem, não dos dados? count() pede diretamente ao banco de dados a quantidade, para que nunca carregue linhas completas na memória.
total = User.query.count()As consultas são preguiçosas
Criar uma consulta ainda não acessa o banco de dados. O SQL só é executado quando chama um método como all, first ou get.
q = User.query
results = q.all()Cada linha é um objeto
Os resultados retornam como verdadeiras instâncias de modelo, portanto lê as colunas como atributos comuns, como user.name e user.email.
user = User.query.first()
print(user.email)Escolha a busca certa
Use get para um identificador conhecido, first para uma entre várias e all para o conjunto completo. Escolher corretamente mantém as leituras claras e rápidas.
Verificação rápida
Conhece a chave primária de um registro. Qual chamada o busca da forma mais direta?
Recapitulação: buscando linhas
Agora lê dados com query: all para listas, first para uma linha, get pelo identificador e os auxiliares or_404 para visões organizadas. Bom trabalho! 🎉
Aprenda Python com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 30
- Aulas
- 120
Perguntas Frequentes
A aula “Busque linhas com query e get” é grátis?
Sim — o texto completo de “Busque linhas com query e get” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Flask Academy, atualize para CoddyKit PRO. O curso de Flask Academy inclui 4 aulas no total.
O que vou aprender em “Busque linhas com query e get”?
Recupere todas, uma ou uma linha pela chave primária. Você pratica Flask Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Flask Academy?
Nenhuma experiência prévia é necessária. Flask Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “Busque linhas com query e get”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Flask Academy?
Sim. Cada aula de Flask Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Busque linhas com query e get
- Filtre, ordene e limite resultados
- Defina relações e chaves estrangeiras
- Junções e carregamento tardio versus antecipado