0Pricing
SQL Academy · Aula

SQLFluff e análise estática

Faça a análise estática de SQL com SQLFluff, imponha um padrão da equipe e corrija automaticamente problemas comuns de formatação.

SQLFluff e análise estática é uma aula grátis de SQL Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de SQL Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de SQL Academy inclui 4 aulas no total.

Por que verificar o estilo do SQL

O SQL é escrito manualmente, por isso é fácil formatá-lo de maneira inconsistente. A verificação de estilo impõe automaticamente um padrão para a equipe:

  • Palavras-chave em minúsculas ou em UPPER
  • Vírgula no fim ou no início da linha
  • Convenções de nomenclatura para tabelas e colunas
  • Indentação
  • Antipadrões (SELECT *, JOINs ambíguos etc.)

SQLFluff: o analisador de estilo padrão

De código aberto, compatível com dialetos, oferece suporte a vários tipos de SQL e funciona muito bem com o dbt:

pip install sqlfluff

sqlfluff lint models/
sqlfluff fix models/   # auto-fix where safe

Configuração do SQLFluff

Uma configuração .sqlfluff:

[sqlfluff]
dialect = postgres
templater = dbt
max_line_length = 120

[sqlfluff:rules:capitalisation.keywords]
capitalisation_policy = upper

[sqlfluff:rules:capitalisation.identifiers]
extended_capitalisation_policy = lower

Regras padrão

O SQLFluff tem mais de 50 regras — nomenclatura, layout, uso de maiúsculas e minúsculas, estrutura e ambiguidade. Desative-as por regra:

[sqlfluff]
exclude_rules = AM05, ST05

Desativação em linha

Ignore uma verificação em uma única linha:

SELECT *  -- noqa: AM04
FROM users;

Integração com o dbt

O SQLFluff entende Jinja e ref():

sqlfluff lint --templater dbt models/

Gancho de pré-commit

Execute o SQLFluff antes de cada commit:

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/sqlfluff/sqlfluff
    rev: 3.0.0
    hooks:
      - id: sqlfluff-lint
      - id: sqlfluff-fix

Na integração contínua

Bloqueie PRs com erros de verificação:

# GitHub Actions
- name: SQLFluff
  run: |
    pip install sqlfluff
    sqlfluff lint models/

Antipadrões a verificar

  • L044/AM04 — Evite SELECT *
  • AM05 — Evite JOIN implícito (vírgula)
  • ST05 — Evite subconsultas em FROM (use CTEs)
  • L010 — Uso inconsistente de maiúsculas e minúsculas

Formatador e verificador de estilo

O SQLFluff faz as duas coisas — verifica AND formata automaticamente:

sqlfluff format models/    # newer: dedicated format command
sqlfluff fix models/       # alias for format + safe rule fixes

Outras ferramentas

  • pg_format — formata o SQL de modo legível (com foco em PostgreSQL)
  • O SQLFluff é o mais usado; integra-se ao dbt
  • formatação ao salvar nos editores (VS Code, JetBrains)

Recapitulação

A verificação de estilo elimina discussões sobre estilo e detecta bugs reais.

  • SQLFluff para verificação e formatação
  • .sqlfluff configura as regras
  • Execute no pre-commit e na CI
  • Combine com o dbt para fluxos de trabalho de SQL de ponta a ponta

Verificação rápida

Qual ferramenta é o padrão de código aberto para verificar SQL e funciona com modelos do dbt?

Perguntas Frequentes

A aula “SQLFluff e análise estática” é grátis?

Sim — o texto completo de “SQLFluff e análise estática” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de SQL Academy, atualize para CoddyKit PRO. O curso de SQL Academy inclui 4 aulas no total.

O que vou aprender em “SQLFluff e análise estática”?

Faça a análise estática de SQL com SQLFluff, imponha um padrão da equipe e corrija automaticamente problemas comuns de formatação. Você pratica SQL Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar SQL Academy?

Nenhuma experiência prévia é necessária. SQL Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “SQLFluff e análise estática”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de SQL Academy?

Sim. Cada aula de SQL Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Fundamentos do DBT (Data Build Tool)
  2. SQLFluff e análise estática
  3. Testes de SQL: testes do dbt, Great Expectations
  4. CI para alterações de esquema (GitHub Actions)
← Voltar para SQL Academy