Mostrar código-fonte de SQLAlchemy

{{Info/Software
| nome                = SQLAlchemy
| logo                =
| imagem              =
| legenda             =
| desenvolvedor       = Michael Bayer<ref>[http://techspot.zzzeek.org/ Mike Bayer é o criador do SQLAlchemy e Mako Templates para Python.]</ref>
| data_lancamento     =
| ultima_versao       = 2.0.29
| ultima_data         = {{Data de lançamento|2024|03|23}}<ref>{{Citar web |url=https://github.com/sqlalchemy/sqlalchemy/releases/latest |título=Release SQLAlchemy 2.0.29 |website=github.com |língua=inglês |data=23 de março de 2024 |acessodata=2 de maio de 2024}}</ref>
| versao_beta         =
| data_beta           =
| idiomas             =
| sistema_operacional = [[Multiplataforma]]
| estado              =
| linguagem           = [[Python]]
| genero              = [[Mapeamento objeto-relacional]]
| licença             = [[Licença MIT|MIT]]
| website             = {{URL|https://www.sqlalchemy.org/}}
| repositório         = {{GitHub|sqlalchemy/sqlalchemy}}
}}
'''SQLAlchemy''' é uma biblioteca de [[mapeamento objeto-relacional]] [[SQL]] em [[Software livre|código aberto]] desenvolvido para a [[linguagem de programação]] [[Python]] e disponibilizado sobre a [[licença MIT]].<ref>{{citar web|url=https://bitbucket.org/zzzeek/sqlalchemy/src/775ff3419fa03ddbb1b4b6d7350344b69df461ef/LICENSE?fileviewer=file-view-default|titulo=LICENSE|obra=bitbucket.org|lingua=inglês|acessodata=24/11/2015}}</ref>

O SQLAlchemy fornece "um conjunto completo e bem conhecido de modelos de persistência de nível corporativo, projetado para eficiência e alta performance de acesso a banco de dados, adaptado em uma linguagem de domínio simples e Pytônica". Sua filosofia é que [[Banco de dados|bancos de dados]] SQL se comportem cada vez menos como coleções de objetos, em que mais tamanho e performance comecem a importar, enquanto coleções de objeto se comportem cada vez menos como tabelas e linhas, no qual mais abstração começa a importar. Por esta razão o SQLAlchemy adotou o [[padrão mapeador de dados]] (como o [[Hibernate]] para [[Java (linguagem de programação)|Java]]) em vez do [[padrão de registro ativo]] usado por vários outros mapeadores objeto-relacional.<ref>em [http://www.aosabook.org/en/sqlalchemy.html A arquitetura de aplicações de código aberto]</ref> Entretanto, [[Plug-in|plugins]] adicionais como [http://elixir.ematia.de/ Elixir] e [https://web.archive.org/web/20110612081816/http://www.sqlalchemy.org/docs/orm/extensions/declarative.html declarative] permitem aos usuários desenvolverem usando sintaxe declarativa.

O SQLAlchemy foi lançado em fevereiro de 2006 e rapidamente se tornou uma das ferramentas de mapeamento objeto-relacional mais utilizadas juntamente com o ORM do [[Django (framework web)|Django]], na comunidade Python.

== Exemplo ==
O exemplo que se segue representa um relacionamento n-para-1 entre filmes e seus diretores. É mostrado como classes Python definidas pelo usuário criam as tabelas de banco de dados adequadas, como instâncias com relacionamentos são criadas a partir de ambos os lados da relação e, finalmente, como os dados podem ser consultados - ilustrando consultas SQL geradas automaticamente para o carregamento preguiçoso (lazy) e ansioso (eager).

=== Definição de esquema ===

Criando duas classes Python e suas relativas tabelas de banco de dados no [[SGBD]]:

<syntaxhighlight lang="Python">
from sqlalchemy import *
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import relation, sessionmaker

Base = declarative_base()
 
class Filme(Base):
    __tablename__ = 'filmes'
 
    id = Column(Integer, primary_key=True)
    titulo = Column(String(255), nullable=False)
    ano = Column(Integer)
    dirigido_por = Column(Integer, ForeignKey('diretores.id'))
 
    diretor = relation("Diretor", backref='filmes', lazy=False)
 
    def __init__(self, titulo=None, ano=None):
        self.titulo = titulo
        self.ano = ano
    def __repr__(self):
        return "Filme(%r, %r, %r)" % (self.titulo, self.ano, self.diretor)
 
class Diretor(Base):
    __tablename__ = 'diretores'
 
    id = Column(Integer, primary_key=True)
    nome = Column(String(50), nullable=False, unique=True)
 
    def __init__(self, nome=None):
        self.nome = nome
 
    def __repr__(self):
        return "Diretor(%r)" % (self.nome)
 
engine = create_engine('dbms://user:pwd@host/dbname')
Base.metadata.create_all(engine)

</syntaxhighlight>

=== Inserção de dados ===
A inserção de filmes e seus diretores pode ser alcançada através das duas entidades:
<syntaxhighlight lang="Python">
Session = sessionmaker(bind=engine)
session = Session()

f1 = Filme("Star Trek", 2009)
f1.diretor = Diretor("JJ Abrams")

d2 = Diretor("George Lucas")
d2.filmes = [Filme("Guerra nas Estrelas", 1977), Filme("THX 1138", 1971)]

try:
    session.add(f1)
    session.add(d2)
    session.commit()
except:
    session.rollback()
</syntaxhighlight>

=== Consulta ===
<syntaxhighlight lang="Python">
alldata = session.query(Filme).all()
for somedata in alldata:
    print somedata
</syntaxhighlight>

O SQLAlchemy envia a seguinte consulta para o SGBD (omitindo os apelidos - aliases):
<syntaxhighlight lang="SQL">
SELECT filmes.id, filmes.titulo, filmes.ano, filmes.dirigido_por, diretores.id, diretores.nome 
FROM filmes LEFT OUTER JOIN diretores ON diretores.id = filmes.dirigido_por
</syntaxhighlight>

A saída:
<syntaxhighlight lang="python">
Filme('Star Trek', 2009L, Diretor('JJ Abrams'))
Filme('Guerra nas Estrelas', 1977L, Diretor('George Lucas'))
Filme('THX 1138', 1971L, Diretor('George Lucas'))
</syntaxhighlight>

Definindo <code>lazy=True</code> (padrão), o SQLAlchemy primeiro enviaria uma consulta para obter a lista de filmes e apenas quando necessário (preguiçoso - lazy) para cada diretor uma consulta para obter o nome do diretor correspondente:
<syntaxhighlight lang="SQL">
SELECT filmes.id, filmes.titulo, filmes.ano, filmes.dirigido_por 
FROM filmes

SELECT diretores.id, diretores.nome
FROM diretores 
WHERE diretores.id = %s
</syntaxhighlight>

== Ver também ==
* [[Pylons]]
* [[SQLObject]]
* [[Storm]]
* [[Turbogears]]

{{Referências}}

== Ligações externas ==
* {{Oficial|https://www.sqlalchemy.org/|en}}
* {{GitHub|sqlalchemy/sqlalchemy}}

[[Categoria:Mapeamento objeto-relacional]]
[[Categoria:Bibliotecas Python]]
[[Categoria:Bibliotecas digitais]]
[[Categoria:Software aplicativo]]