Pular para o conteúdo principal

ZPA 4.3.0

· Leitura de 6 minutos
Maintainer

O ZPA 4.3.0 foi lançado! Esta versão substitui o mecanismo de resolução de nomes. A análise agora lê o projeto inteiro antes de verificar um arquivo, então um nome é resolvido contra as declarações de todos os arquivos: especificações e bodies de packages em arquivos separados, subprogramas avulsos, tipos objeto e os seus métodos, sinônimos e as tabelas que os fontes criam. Ela também pode ler o dicionário de dados do Oracle. Quando um nome não pode ser decidido, porque falta uma declaração ou um texto condicional pode mudá-lo, as regras que dependem dele ficam em silêncio em vez de chutar.

  • Compatibilidade com o SonarQube: Compatível com o SonarQube Community Build 26.7 e mais recentes (testado do 26.7 ao 26.11).

  • Resolução no projeto inteiro:

    • Chamadas se ligam ao overload que o Oracle escolheria, inclusive overloads que diferem só pelo tipo de um argumento.
    • Nomes são resolvidos por %TYPE, %ROWTYPE, records, coleções, atributos e métodos de objetos, e sinônimos.
    • Nomes dentro de SQL são distinguidos de colunas, também em SELECT … INTO, loops de cursor e no texto SQL que EXECUTE IMMEDIATE, OPEN … FOR e DBMS_SQL.PARSE montam a partir de literais.
  • Metadados do banco de dados (opcional): com uma conexão, o ZPA lê as tabelas, views, colunas, tipos objeto, sinônimos e assinaturas de subprogramas dos schemas que você listar, em uma transação somente leitura. Sem conexão, os comandos CREATE TABLE e CREATE SYNONYM dos fontes fazem o mesmo papel. Veja Metadados do banco de dados.

  • Schema de compilação: cada arquivo pode receber o schema em que é compilado, para que nomes qualificados por schema e unidades criadas sem dono sejam resolvidos como no banco. Veja Schema de compilação.

  • Compilação condicional: com os PLSQL_CCFLAGS do projeto, a versão do banco de destino, ou os dois, o ZPA avalia as condições $IF como o Oracle e analisa só o código que é compilado. Veja Compilação condicional.

  • Novas regras, todas ativas por padrão:

    RegraPrecisa de metadados
    FunctionWithoutReturn: funções não devem chegar ao fim sem retornar um valornão
    ParameterInDynamicSql: parâmetros não devem ser concatenados em SQL dinâmiconão
    OuterJoinDiscardedByCondition: condições não devem descartar as linhas que um outer join adicionanão
    ColumnHidesPlSqlName: colunas não devem ocultar parâmetros ou variáveis em condições SQLa coluna precisa ser conhecida, pelos metadados ou por um CREATE TABLE dos fontes
    ImplicitColumnConversion: colunas de caracteres não devem ser comparadas com números ou datasos tipos das colunas, pelos metadados ou por um CREATE TABLE dos fontes
    NotInWithNull: NOT IN não deve ser usado com valores que podem ser nulossó para subconsultas; listas são verificadas sem eles
    NullTestOnNotNullColumn: condições IS NULL não devem testar colunas que nunca podem ser nulassim
    ColumnIntoSmallerVariable: colunas não devem ser lidas em variáveis menores que a colunasim
  • SonarQube:

    • Cada regra declara uma categoria, enviada ao SonarQube como o seu clean code attribute e exibida nas páginas das regras.
    • As descrições das regras são divididas em "Why is this an issue?" e "How can I fix it?", e a maioria agora tem exemplos.
    • Um comentário sonar-resolve aceita uma issue ou a marca como falso positivo, com uma justificativa. Veja Resolvendo issues por comentários.
    • O destaque de símbolos vem da nova resolução e agora cobre aliases e nomes de tabelas, nomes de consultas WITH e qualificadores de FOR UPDATE OF. Literais numéricos, de data e de timestamp são destacados como constantes.
  • Oracle Forms: os metadados do Forms podem informar o tipo de dado de cada item e parâmetro, para que variáveis de host como :BLOCK.ITEM sejam tipadas. O ZPA Forms Extractor grava esse formato por padrão.

Antes de atualizar​

Todos os novos parâmetros de análise são opcionais; Analisando o código lista todos eles.

Para quem desenvolve regras customizadas​

Recompile seus plugins com o ZPA 4.3.0. Alguns também precisam de mudanças no código:

  • O ZPA agora usa o FLR 2.0.0, que muda o AstNode: children é somente leitura, fromIndex e toIndex foram removidos, e um não terminal que não casou nenhuma entrada não tem token. Veja as notas de lançamento do FLR 2.0.0.
  • Novas consultas semânticas respondem a qual declaração um nome, uma chamada, uma coluna ou um campo se refere, se uma declaração é usada e qual o tipo de um valor. Elas são experimentais; veja a API semântica.
  • O modelo de símbolos legado está depreciado (symbolTable, currentScope, Symbol, Scope, SymbolTable, PlSqlType, os acessores de símbolo e tipo de dado de SemanticAstNode). Ele continua funcionando como no 4.2.x e será removido no ZPA 5.0.
  • A API experimental de projeto mudou sem depreciação, como o seu nível de opt-in permite.
  • @Rule aceita uma category, e o PlSqlCheckVerifier executa uma regra pelo scanner, com configurações.

Para mais detalhes veja as notas de lançamento.