Ruby on Rails - O que é o Arel?

Ruby on Rails é um framework que revolucionou o desenvolvimento web. Um de seus componentes menos visíveis, mas crucial, é o Arel. Este artigo explora como o Arel facilita a construção de consultas SQL de maneira programática, tornando o desenvolvimento mais eficiente e seguro.

Compreendendo o Arel e Seu Papel no Rails

Arel é a sigla para Active Record Relation Library. Ele atua como uma camada intermediária entre o ActiveRecord e o banco de dados, permitindo a construção de consultas SQL complexas usando a sintaxe Ruby. Isso pode resultar em um código mais limpo e fácil de manter, pois abstrai a escrita direta de SQL e manipula consultas ao banco de dados de forma programática.

Vantagens de Usar o Arel

Os principais benefícios de utilizar o Arel são:

• Segurança: O Arel ajuda a proteger contra ataques de injeção SQL, encapsulando a sintaxe SQL dentro dos métodos Ruby.
• Manutenibilidade e Legibilidade: As consultas feitas com Arel são mais fáceis de ler e manter. Mudanças na estrutura ou sintaxe do banco de dados requerem ajustes mínimos no código.
• Desempenho: A geração de consultas eficientes pode reduzir os tempos de resposta do servidor e o consumo de recursos.
• Flexibilidade: O Arel permite realizar consultas complexas como junções, sub-consultas e projeções sem a necessidade de scripting SQL direto.

Aplicações Práticas

A seguir, apresentaremos algumas formas simples de utilizar o Arel, que simplificam tarefas que seriam bastante complexas sem ele.

1- Transformação de timestamps Extração de partes de uma data ou hora com o método 'extract'.

User.distinct.pluck(User[:created_at].extract("year"))
# => SELECT DISTINCT EXTRACT(YEAR FROM "users"."created_at") FROM "users"

2 - Ordenação por outras tabelas O método 'order' do ActiveRecord não aceita a sintaxe tabela: :coluna, mas aceita uma coluna Arel diretamente, opcionalmente seguida por asc ou desc.

User.joins(:comments).order(Comment[:created_at].desc)
# => SELECT "users".* FROM "users" INNER JOIN "comments" ON "comments"."user_id" = "users"."id" ORDER BY "comments"."created_at" DESC

3 - Ordenação com valores nulos Usando 'nulls_last' ou 'nulls_first'.

User.order(User[:email].desc.nulls_last)
# => SELECT "users".* FROM "users" ORDER BY "users"."email" ASC NULLS LAST

4 - Ordenação por uma ordem personalizada Usando Arel::Nodes::Case.

User.order(
Arel::Nodes::Case
  .new(User[:role])
  .when("admin").then(1)
  .when("editor").then(2)
)
# => SELECT "users".* FROM "users" ORDER BY CASE "users"."role" WHEN 'admin' THEN 1 WHEN 'editor' THEN 2 END

5 - Funções de agregação Como soma, contagem, média, mínimo ou máximo.

User.select(:role, User[:id].minimum, User[:id].maximum).group(:role)
# => SELECT "users"."role", MAX("users"."id"), MIN("users"."id") FROM "users" GROUP BY "users"."role"

Finalizando

Como podemos ver, as consultas, até mesmo para agregação ou ordenação avançada, se tornam simples de serem interpretadas quando utilizamos o Arel. Além disso, sua modularidade permite a criação de blocos de regras que facilitam a legibilidade e a manutenção do código.