ZPA 4.3.0
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 queEXECUTE IMMEDIATE,OPEN … FOReDBMS_SQL.PARSEmontam 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 TABLEeCREATE SYNONYMdos 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_CCFLAGSdo projeto, a versão do banco de destino, ou os dois, o ZPA avalia as condições$IFcomo o Oracle e analisa só o código que é compilado. Veja Compilação condicional. -
Novas regras, todas ativas por padrão:
Regra Precisa de metadados FunctionWithoutReturn: funções não devem chegar ao fim sem retornar um valor não ParameterInDynamicSql: parâmetros não devem ser concatenados em SQL dinâmico não OuterJoinDiscardedByCondition: condições não devem descartar as linhas que um outer join adiciona não ColumnHidesPlSqlName: colunas não devem ocultar parâmetros ou variáveis em condições SQL a coluna precisa ser conhecida, pelos metadados ou por um CREATE TABLEdos fontesImplicitColumnConversion: colunas de caracteres não devem ser comparadas com números ou datas os tipos das colunas, pelos metadados ou por um CREATE TABLEdos fontesNotInWithNull: NOT INnão deve ser usado com valores que podem ser nulossó para subconsultas; listas são verificadas sem eles NullTestOnNotNullColumn: condições IS NULLnão devem testar colunas que nunca podem ser nulassim ColumnIntoSmallerVariable: colunas não devem ser lidas em variáveis menores que a coluna sim -
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-resolveaceita 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
WITHe qualificadores deFOR 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.ITEMsejam tipadas. O ZPA Forms Extractor grava esse formato por padrão.
Antes de atualizar
- É necessário o SonarQube 26.7 ou mais recente. O ZPA 4.2.x suportava o 26.2.
- As issues vão mudar, mesmo com o mesmo quality profile:
- As oito regras novas estão ativas por padrão no perfil nativo.
- UnusedVariable, UnusedParameter, UnusedCursor, VariableHiding, UnhandledUserDefinedException, DeterministicFunction, FunctionShouldBeDeterministic, ColumnsShouldHaveTableName, VariableInCount, InsertWithoutColumns e SelectAllColumns agora usam a nova resolução. Elas enxergam declarações de outros arquivos, então algumas issues aparecem e outras somem.
- ColumnsShouldHaveTableName agora verifica consultas com joins ANSI,
exceto as colunas de
USINGe deNATURAL JOIN, que o Oracle não deixa qualificar. - SequenceNextvalInConditionalResult agora verifica comandos SQL avulsos, não só SQL dentro de PL/SQL.
- NotASelectedExpression agora reporta um item de
ORDER BYde umSELECT DISTINCTque é só parte de uma expressão selecionada, o que causa ORA-01791. - Um arquivo que começa com um byte-order mark UTF-8 não falha mais no parsing.
- Compilação condicional: se o seu código usa
$IF, definasonar.zpa.ccflags,sonar.zpa.databaseVersionou os dois. Sem eles, o ZPA não avalia as condições, e as regras se contêm nos nomes que o texto condicional pode mudar.
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,fromIndexetoIndexforam 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 deSemanticAstNode). 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.
@Ruleaceita umacategory, e oPlSqlCheckVerifierexecuta uma regra pelo scanner, com configurações.
Para mais detalhes veja as notas de lançamento.