SQLAlchemy ORM - carregamento rápido

O carregamento rápido reduz o número de consultas. SQLAlchemy oferece funções de carregamento rápido invocadas por meio de opções de consulta que fornecem instruções adicionais para a consulta. Essas opções determinam como carregar vários atributos por meio do método Query.options ().

Carregamento de subconsulta

Queremos que Customer.invoices carregue avidamente. A opção orm.subqueryload () fornece uma segunda instrução SELECT que carrega totalmente as coleções associadas aos resultados recém carregados. O nome “subconsulta” faz com que a instrução SELECT seja construída diretamente por meio da Consulta reutilizada e incorporada como uma subconsulta em um SELECT na tabela relacionada.

from sqlalchemy.orm import subqueryload
c1 = session.query(Customer).options(subqueryload(Customer.invoices)).filter_by(name = 'Govind Pant').one()

Isso resulta nas duas seguintes expressões SQL -

SELECT customers.id 
AS customers_id, customers.name 
AS customers_name, customers.address 
AS customers_address, customers.email 
AS customers_email
FROM customers
WHERE customers.name = ?
('Govind Pant',)

SELECT invoices.id 
AS invoices_id, invoices.custid 
AS invoices_custid, invoices.invno 
AS invoices_invno, invoices.amount 
AS invoices_amount, anon_1.customers_id 
AS anon_1_customers_id
FROM (
   SELECT customers.id 
   AS customers_id
   FROM customers
   WHERE customers.name = ?) 
   
AS anon_1 
JOIN invoices 
ON anon_1.customers_id = invoices.custid 
ORDER BY anon_1.customers_id, invoices.id 2018-06-25 18:24:47,479 
INFO sqlalchemy.engine.base.Engine ('Govind Pant',)

Para acessar os dados de duas tabelas, podemos usar o programa abaixo -

print (c1.name, c1.address, c1.email)

for x in c1.invoices:
   print ("Invoice no : {}, Amount : {}".format(x.invno, x.amount))

O resultado do programa acima é o seguinte -

Govind Pant Gulmandi Aurangabad [email protected]
Invoice no : 3, Amount : 10000
Invoice no : 4, Amount : 5000

Carga Unida

A outra função é chamada orm.joinedload (). Isso emite um LEFT OUTER JOIN. O objeto principal, bem como o objeto ou coleção relacionado, são carregados em uma etapa.

from sqlalchemy.orm import joinedload
c1 = session.query(Customer).options(joinedload(Customer.invoices)).filter_by(name='Govind Pant').one()

Isso emite a seguinte expressão, dando a mesma saída que acima -

SELECT customers.id 
AS customers_id, customers.name 
AS customers_name, customers.address 
AS customers_address, customers.email 
AS customers_email, invoices_1.id 
AS invoices_1_id, invoices_1.custid 
AS invoices_1_custid, invoices_1.invno 
AS invoices_1_invno, invoices_1.amount 
AS invoices_1_amount

FROM customers 
LEFT OUTER JOIN invoices 
AS invoices_1 
ON customers.id = invoices_1.custid

WHERE customers.name = ? ORDER BY invoices_1.id
('Govind Pant',)

O OUTER JOIN resultou em duas linhas, mas retorna uma instância de Customer. Isso ocorre porque o Query aplica uma estratégia de “exclusividade”, com base na identidade do objeto, às entidades retornadas. O carregamento antecipado associado pode ser aplicado sem afetar os resultados da consulta.

O subqueryload () é mais apropriado para carregar coleções relacionadas, enquanto o joinload () é mais adequado para relacionamento muitos-para-um.