SnowConvert AI - Top-Level Code Units Report¶

Consultas¶

No exemplo a seguir, temos aqui uma única instrução SELECT. Essa instrução é uma única unidade de código de nível superior.

SELECT * FROM table1;

Neste exemplo, temos uma instrução SELECT aninhada dentro de outra instrução SELECT. A consulta inteira conta como uma única unidade de código de nível superior.

SELECT * FROM (SELECT * FROM table1);

Objetos¶

Os objetos criados com um DDL contam como uma única unidade de código de nível superior, mesmo que contenham outras unidades de código em seu interior.

A instrução a seguir cria uma exibição com uma consulta. Nesse caso, CREATE VIEW inteiro conta como uma única unidade de código de nível superior.

CREATE VIEW view1 AS SELECT * FROM table1;

A seguinte instrução CREATE PROCEDURE conta como uma única unidade de código de nível superior, mesmo que contenha vários comandos dentro dele.

CREATE PROCEDURE procedure1
AS
BEGIN
    DELETE FROM table1;
END;

Comandos¶

Os comandos independentes em um arquivo SQL são considerados unidades de código de nível superior.

Uma instrução COMMIT conta como uma única unidade de código de nível superior.

COMMIT;

Corpos de pacotes no Oracle¶

Um pacote pode definir vários elementos dentro de seu corpo. O corpo do pacote é considerado a unidade de código de nível superior porque esses elementos não podem ser criados individualmente sem a criação de todo o corpo do pacote. Os elementos ou unidades de código dentro do corpo de um pacote não contarão como unidades de código de nível superior.

O código a seguir será relatado como uma única unidade de código CREATE PACKAGE BODY.

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

Arquivos de script do Teradata¶

Os arquivos de Script do Teradata, como BTEQ ou TPUMP, são executados como unidades de código autônomas. Por esse motivo, o arquivo inteiro é considerado uma única unidade de código de nível superior. Outras unidades de código possíveis dentro desses arquivos não contarão como unidades de código de nível superior.

O seguinte arquivo de script BTEQ será relatado como uma única unidade de código de nível superior BTEQ.

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

Transacionar lotes SQL com GOTO¶

Cada instrução do Transact-SQL pode ser executada de forma independente. Na maioria dos casos, cada uma dessas instruções é considerada uma unidade de código de nível superior. No entanto, quando há um lote que contém uma instrução GOTO para um rótulo dentro do mesmo lote, as instruções do lote não podem ser executadas independentemente sem garantir que funcionem corretamente. Por esse motivo, as instruções que estiverem em um lote com uma instrução GOTO não contarão como unidades de código de nível superior, apenas o lote.

O exemplo de código a seguir será relatado como uma única unidade de código GOTO/LABEL:

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

Relatório de problemas¶

issues-report.md

Cada linha do Relatório de problemas contém algumas informações sobre a Unidade de código que está sendo afetada pelo problema. As colunas relacionadas às unidades de código são as seguintes:

• Code Unit Database: Esse é o banco de dados da unidade de código de nível superior em que o problema foi encontrado. Isso se aplica apenas a unidades de código que são objetos.

• Code Unit Schema: Esse é o esquema da unidade de código de nível superior em que o problema foi encontrado. Isso se aplica apenas a unidades de código que são objetos.

• Code Unit Package: Este é o pacote da unidade de código de nível superior em que o problema foi encontrado. Isso se aplica apenas a unidades de código que são objetos.

• Code Unit Name: Esse é o nome da unidade de código de nível superior em que o problema foi encontrado. Isso se aplica apenas a unidades de código nomeadas, como objetos. Esse nome não é qualificado por banco de dados, esquema ou pacote.

• Code Unit ID: Este é o ID da unidade de código de nível superior onde o problema foi encontrado. Esse nome tem o nome qualificado e adicionará um número para unidades de código com nomes repetidos.

• Code Unit: Esse é o tipo da unidade de código de nível superior em que o problema foi encontrado.

• Code Unit Size: Esse é o tamanho da unidade de código de nível superior em que o problema foi encontrado.

Relatório de referências a objetos e relatório de objetos ausentes¶

object-references-report.md

missing-objects-report.md

Cada linha do relatório Object References contém informações sobre a unidade de código de nível superior que estava fazendo referência a outro elemento. Esses elementos referenciados podem não ser de nível superior, portanto, esses outros valores podem não ser incluídos no relatório Top-Level Code Units.

Da mesma forma que o relatório Object References, o relatório Missing Objects contém informações sobre a unidade de código de nível superior que fazia referência a um elemento que não podia ser encontrado no código.

• Caller Code Unit: Esse é o tipo da unidade de código de nível superior que está fazendo referência a outro elemento.

• Caller Code Unit Database: Esse é o banco de dados da unidade de código de nível superior que está fazendo referência a outro elemento.

• Caller Code Unit Schema: Esse é o esquema da unidade de código de nível superior que está fazendo referência a outro elemento.

• Caller Code Unit Name: Esse é o nome da unidade de código de nível superior que está fazendo referência a outro elemento.

• Caller Code Unit Full Name: Este é o nome completo da unidade de código de nível superior que está fazendo referência a outro elemento.

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;