Skip to main content

Agente de Otimização SQL

O Agente de Otimização SQL é uma ferramenta integrada à plataforma Carol que auxilia a melhorar a performance de pipelines SQL. Ele analisa consultas, sugere melhorias e aponta pontos de atenção para otimização.

Pré-requisitos​

  • Acesso à plataforma Carol.
  • Extensão Carol BigQuery instalada no VS Code.
  • Arquivo de pipeline SQL com extensão .csql.

Como utilizar​

VSCode​

  1. Abra a pipeline no arquivo .csql no VS Code com a extensão Carol SQL.
  2. Clique no botão Carol - Run Query ou utilize o atalho correspondente que, por padrão, é a tecla F5.
  3. Aguarde a execução da query.

Resultados da query Descrição da imagem: Resultados da execução da query aparecem na aba lateral do VS Code.

  1. Após a execução, um botão Otimizar SQL aparecerá na parte inferior do editor. Ao clicá-lo a extensão envia a query ao agente de IA.
  2. O agente retorna:
  • Sugestões de melhoria automáticas: Refaz a query aplicando boas práticas.
  • Dicas e alertas: Pontos de atenção que o usuário deve avaliar manualmente.

Após isso basta revisar as sugestões e aceitar ou não as melhorias.

Exemplo de otimização

Pipeline Checkout​

Também é possível obter sugestões de melhorias após realizar o checkout das pipelines na Carol!

  1. Ao executar um checkout aparecerá uma notificação com o botão "Otimizar SQL"

    Notificação Otimizar SQL

  2. Ao clicar será aberto um modal com uma lista de sugestões para otimizar nas pipelines.

    Sugestões de melhoria nas pipelines

Observações importantes​

  • Nem todas as sugestões podem ser aplicadas diretamente. Avalie o contexto da pipeline antes de aplicar mudanças.
  • O agente não substitui a revisão humana, mas serve como uma ferramenta de apoio para melhorar performance e legibilidade.
  • As otimizações são baseadas em boas práticas para o BigQuery, motor utilizado para o processamento SQL na Plataforma Carol.
  • Revise as dicas do agente antes de implementar alterações.
  • Utilize a otimização como parte de um processo contínuo de melhoria de pipelines.

Limitações​

Dialeto SQL​

  • O Agente de Otimização SQL dá suporte apenas a queries SQL que utilizam o dialeto BigQuery GoogleSQL.
  • As otimizações são direcionadas para Pipelines SQL executadas na plataforma Carol, porém é possível utilizar para otimizar consultas quaisquer.

Uso gratuito​

  • Atualmente o agente possui uma limite para otimizar queries baseado na quantidade de caracteres, caso seja enviada uma query com mais caracteres do que o especificado será retornado uma mensagem de erro avisando sobre o limite.
  • Em um primeiro momento, o agente contém uma limitação de chamadas gratuitas por usuário por mês. Caso tenha interesse em utilizar o agente com mais frequência entre em contato com o time IDeIA via issue no Jira.