Neste capítulo, será abordado como excluir registros de um banco de dados utilizando o SQLAlchemy. A exclusão de registros é fundamental na administração de dados, especialmente ao remover entradas desatualizadas ou desnecessárias. O SQLAlchemy oferece ferramentas simples e poderosas para lidar com exclusões tanto em operações individuais quanto em operações em massa.

Exclusão de um único registro pelo ID

A forma mais comum de excluir um registro é identificá-lo por um critério específico, como seu ID. Veja como excluir um produto utilizando seu ID.

product = session.query(Product).filter(Product.id == 1).first()

# Check if the product exists
if product:
    # Delete the product
    session.delete(product)
    session.commit()

O código busca um produto com o ID 1, verifica sua existência, marca-o para exclusão com session.delete(product) e aplica a alteração utilizando session.commit().

Exclusão de múltiplos registros

Em algumas situações, é necessário excluir múltiplos registros de uma vez com base em condições específicas. Isso é útil para tarefas como remover itens fora de estoque ou produtos abaixo de um determinado limite de preço.

session.query(Product).filter(Product.is_in_stock == False).delete(synchronize_session="fetch")

# Commit the changes
session.commit()

A consulta filtra os produtos que estão fora de estoque, exclui-os utilizando .delete(synchronize_session="fetch") e garante que a sessão permaneça sincronizada com o banco de dados.

Exclusões em massa

Para conjuntos de dados grandes, exclusões em massa são eficientes. Esse método modifica diretamente os registros no banco de dados sem carregá-los para a memória, economizando tempo e recursos.

session.query(Product).filter(Product.price < 100).delete(synchronize_session="fetch")

# Commit the changes
session.commit()

Este exemplo filtra produtos com preço inferior a $100 e os remove utilizando o método .delete(), proporcionando uma solução rápida e eficiente para tabelas extensas.

Exclusão de todos os registros de uma tabela

Quando for necessário limpar completamente uma tabela, o SQLAlchemy facilita esse processo com uma única consulta.

session.query(Product).delete(synchronize_session="fetch")

# Commit the changes
session.commit()

O método .delete(synchronize_session="fetch") remove todos os registros da tabela Product, sendo útil para redefinir dados ou limpar ambientes de teste.