SnowConvert AI - Top-Level Code Units Report¶

Requêtes¶

Dans l’exemple suivant, il s’agit d’une instruction SELECT unique. Cette instruction est une unité de code unique de niveau supérieur.

SELECT * FROM table1;

Dans cet exemple, nous avons une instruction SELECT imbriquée dans une autre instruction SELECT. La requête entière compte pour une unité de code unique de niveau supérieur.

SELECT * FROM (SELECT * FROM table1);

Objets¶

Les objets créés à l’aide d’un DDL comptent pour une unité de code unique de niveau supérieur, même s’ils contiennent d’autres unités de code.

L’instruction suivante crée une vue avec une requête. Dans ce cas, CREATE VIEW compte pour une unité de code unique de niveau supérieur.

CREATE VIEW view1 AS SELECT * FROM table1;

L’instruction CREATE PROCEDURE compte pour une unité de code unique de niveau supérieur, même si elle contient plusieurs instructions.

CREATE PROCEDURE procedure1
AS
BEGIN
    DELETE FROM table1;
END;

Commandes¶

Les commandes indépendantes d’un fichier SQL sont considérées comme des unités de code de niveau supérieur.

Une instruction COMMIT compte pour une unité de code unique de niveau supérieur.

COMMIT;

Corps des paquets dans Oracle¶

Un paquet peut définir plusieurs éléments à l’intérieur de son corps. Le corps du paquet est considéré comme l’unité de code de niveau supérieur car ces éléments ne peuvent être créés individuellement sans créer le corps entier du paquet. Les éléments ou unités de code à l’intérieur du corps d’un paquet ne sont pas comptabilisés comme unités de code de niveau supérieur.

Le code suivant sera signalé comme une unité de code CREATE PACKAGE BODY unique.

CREATE PACKAGE package_body1 IS
    FUNCTION function1
    RETURN VARCHAR
    IS
    BEGIN
        RETURN 'HELLO'';
    END;
END;

Fichiers de script Teradata¶

Les fichiers de script Teradata tels que BTEQ ou TPUMP sont exécutés en tant qu’unités de code autonomes. De ce fait, le fichier entier est considéré comme une unité de code unique de niveau supérieur. Les autres unités de code possibles à l’intérieur de ces fichiers ne sont pas comptabilisées comme unités de code de niveau supérieur.

Le fichier de script BTEQ suivant sera signalé comme une unité de code unique BTEQ de niveau supérieur.

.LOGON e/fml,notebook
.COMPILE FILE = example.spl;
COMMIT;
CALL samplesp1 (8888, pAmount);
.LOGOFF

Lots Transact SQL avec GOTO¶

Chaque instruction de lot Transact SQL peut être exécutée indépendamment. Dans la plupart des cas, chacune de ces instructions est considérée comme une unité de code de niveau supérieur. Toutefois, lorsqu’un lot contient une instruction GOTO sur une étiquette à l’intérieur du même lot, les instructions du lot ne peuvent pas être exécutées indépendamment sans que l’on s’assure qu’elles fonctionnent correctement. Pour cette raison, les instructions qui font partie d’un lot avec une instruction GOTO ne compteront pas pour unités de code de niveau supérieur, mais seulement le lot.

L’exemple de code suivant sera signalé comme une unité de code GOTO/LABEL unique :

DECLARE @Counter int;  
SET @Counter = 1;  
WHILE @Counter < 10  
BEGIN   
    SELECT @Counter  
    SET @Counter = @Counter + 1  
    IF @Counter = 4 GOTO Branch_One
    IF @Counter = 5 GOTO Branch_Two  
END  
Branch_One:  
    SELECT 'Jumping To Branch One.'  
    GOTO Branch_Three;
Branch_Two:  
    SELECT 'Jumping To Branch Two.'  
Branch_Three:  
    SELECT 'Jumping To Branch Three.';
GO

Rapport sur les problèmes¶

issues-report.md

Chaque ligne du rapport sur les problèmes contient des informations sur l’unité de code concernée par le problème. Les colonnes relatives aux unités de code sont les suivantes :

• Base de données de l’unité de code : Il s’agit de la base de données de l’unité de code de niveau supérieur où le problème a été détecté. Elle ne s’applique qu’aux unités de code qui sont des objets.

• Schéma de l’unité de code : Il s’agit du schéma de l’unité de code de niveau supérieur où le problème a été détecté. Elle ne s’applique qu’aux unités de code qui sont des objets.

• Paquet de l’unité de code : Il s’agit du paquet de l’unité de code de niveau supérieur où le problème a été détecté. Elle ne s’applique qu’aux unités de code qui sont des objets.

• Nom de l’unité de code : Il s’agit du nom de l’unité de code de niveau supérieur où le problème a été détecté. Il ne s’applique qu’aux unités de code nommées, comme les objets. Ce nom n’est pas qualifié par une base de données, un schéma ou un paquet.

• ID de l’unité de code : Il s’agit de l’ID de l’unité de code de niveau supérieur où le problème a été détecté. Ce nom est qualifié et un numéro est ajouté pour les unités de code dont le nom est répété.

• Unité de code : Il s’agit du type de l’unité de code de niveau supérieur où le problème a été détecté.

• Taille de l’unité de code : Il s’agit de la taille de l’unité de code de niveau supérieur où le problème a été détecté.

Rapport sur les références d’objet et rapport sur les objets manquants¶

object-references-report.md

missing-objects-report.md

Chaque ligne du rapport sur les références d’objets contient des informations sur l’unité de code de niveau supérieur qui faisait référence à un autre élément. Ces éléments référencés peuvent ne pas être de niveau supérieur, de sorte que ces autres valeurs peuvent ne pas être incluses dans le rapport sur les unités de code de niveau supérieur.

De même que le rapport sur les références d’objets, le rapport sur les objets manquants contient des informations sur l’unité de code de niveau supérieur qui faisait référence à un élément introuvable dans le code.

• Unité de code de l’appelant : Il s’agit du type de l’unité de code de niveau supérieur qui fait référence à un autre élément.

• Base de données de l’unité de code de l’appelant : Il s’agit de la base de données de l’unité de code de niveau supérieur qui fait référence à un autre élément.

• Schéma de l’unité de code de l’appelant : Il s’agit du schéma de l’unité de code de niveau supérieur qui fait référence à un autre élément.

• Nom de l’unité de code de l’appelant : Il s’agit du nom de l’unité de code de niveau supérieur qui fait référence à un autre élément.

• Nom complet de l’unité de code de l’appelant : Il s’agit du nom complet de l’unité de code de niveau supérieur qui fait référence à un autre élément.

Limitations¶

There are some scenarios where the deployment order may not calculate the right level for a specific code unit.

CREATE TABLE TABLE1 ( -- level 0, no dependencies
  COL1 INT
);

CREATE VIEW VIEW1 -- level 1*, depends on level-0 objects and has a missing dependency
AS SELECT * FROM TABLE1, TABLE2;

CREATE VIEW VIEW2 -- level 2*, depends on level-1* objects 
AS SELECT * FROM VIEW1;

CREATE DATABASE LINK DBLINK1
CONNECT TO PUBLIC IDENTIFIED BY VALUES ':1'
USING 'TEST';

CREATE MATERIALIZED VIEW VIEW1 REFRESH WITH ROWID 
AS SELECT * FROM TABLE1@DBLINK1;

CREATE TABLE TABLE1 (
  COL1 INT
);

CREATE OR REPLACE PROCEDURE PROC1 (param1 NUMBER)
IS
BEGIN
    CREATE VIEW VIEW1 
    AS
    SELECT * FROM TABLE1;
END;

CREATE VIEW VIEW2
AS SELECT * FROM VIEW1;