SnowConvert AI - Top-Level Code Units Report¶

トップレベルコードユニットとは¶

コードユニットとは、その名のとおり、最もアトミックで独立した実行要素です。ほとんどの場合、これらはステートメントですが、スクリプトファイルも1つの要素として実行されるため、スクリプトファイルも含まれます。

一部のコードユニットは、他のコードユニットの中にネストすることができます。ユニットの階層において、その上に他のコードユニットがない場合、それはトップレベルコードユニットと呼ばれます。

スコープ外のコードユニットとは¶

Out-of-scope Top-Level Code Units are Code Units that are out of the conversion scope of SnowConvert AI. Because of this, these code units are not considered when calculating the conversion rate. Each of these code units will not have a conversion rate (it will appear as N/A).

入力コードにスコープ外のコードユニットのみが含まれている場合、移行全体のコード行数変換率は0%になります。

以下の CREATE TRIGGER は、スコープ外のコードユニットとみなされます。

CREATE OR REPLACE TRIGGER my_trigger
    AFTER 
    UPDATE
    ON my_table
    FOR EACH ROW
BEGIN
   NULL;
END;

トップレベルコードユニットの例¶

次のセクションでは、トップレベルコードユニットの例をいくつか紹介します。

SELECT * FROM table1;

SELECT * FROM (SELECT * FROM table1);

CREATE VIEW view1 AS SELECT * FROM table1;

CREATE PROCEDURE procedure1
AS
BEGIN
    DELETE FROM table1;
END;

COMMIT;

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

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

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

他のレポートでコードユニットが扱われる手法¶

コードユニットの手法は、他のレポートでも紹介されています。このセクションでは、これらの値がどのように表示されるか、または他のレポートとどのように関連するかについて説明します。

トップレベルコードユニットレポートの情報¶

例¶

ORACLE SQL 内の次の CREATE TABLE がtable_example.sqlというファイルにあるとします。

CREATE TABLE my_table (
  my_column DATE DEFAULT TO_DATE(CURRENT_DATE, 'J'),
  NOT A VALID COLUMN
);

CREATE OR REPLACE TABLE my_table (
   my_column TIMESTAMP /*** SSC-FDM-OR0042 - DATE TYPE COLUMN HAS A DIFFERENT BEHAVIOR IN SNOWFLAKE. ***/ DEFAULT PUBLIC.JULIAN_TO_GREGORIAN_DATE_UDF(CURRENT_DATE(), 'J')
--                                                                                                                                                                          ,
-- ** SSC-EWI-0001 - UNRECOGNIZED TOKEN ON LINE '3' COLUMN '3' OF THE SOURCE CODE STARTING AT 'NOT'. EXPECTED 'Column Definition' GRAMMAR. LAST MATCHING TOKEN WAS ',' ON LINE '2' COLUMN '52'. FAILED TOKEN WAS 'NOT' ON LINE '3' COLUMN '3'. CODE '15'. **
--  NOT A VALID COLUMN
 )
 COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
 ;

トップレベルコードユニットレポートには、先に示したテーブルが1つだけ表示されます。

以下は、この CREATE TABLE ステートメントのエントリで報告されるすべての値です。

• パーティションキー の値は移行によって異なります。

• ファイルタイプ は、.sql拡張子を持つファイルで移行されたため、 SQL となります。

• CREATE TABLE ステートメントは TABLE コードユニットカテゴリの一部であるため、 カテゴリ は TABLE になります。

• コードユニット 自体は CREATE TABLE になります。

• このコードユニットが見つかった ファイル名 はtable_example.sqlです。

• CREATE TABLE ステートメントがファイルの先頭にあると仮定すると、 行番号 は1になります。

• コード行 の数字は4になります。

• EWI カウント 列は、出力コードに1つの解析 EWI があるため、1と表示されます。

• FDM カウント 列に1と表示されるのは、出力コードにデータ型に関連する FDM 問題があるためです。

• 出力コードに PRF の問題が存在しないため、 PRF カウント は0を報告します。

• この場合の 最大 EWI 重大度 は、例の解析 EWI の重大度であるため、「Critica」になります。もう1つの重大度は「Low」です。

• このカスタムユーザー定義関数は、入力コードの TO_DATE 関数を変換するために追加されたため、 使用された UDFs 列は JULIAN_TO_GREGORIAN_DATE_UDF になります。

• EWI 列は「SSC-EWI-0001」と表示されます。これは出力コードで追加された EWIs のうちの1つだからです。

• FDM 列は「SSC-FDM-OR0042」と表示されます。これは出力コードで追加された FDMs のうちの一つだからです。

• 出力コードには PRF の問題が存在しないため、 PRF 列は「N/A」と表示されます。

• 変換ステータス は「Partial」になります。これは、このコードユニットの一部のフラグメントのみが、 EWIs なしで移行できたためです。

• LoC 変換パーセント は50%です。4行中、変換に成功したのは2行のみだからです。

Deployment Order¶

The deployment order column represents the correct order to deploy each code unit into Snowflake.

The following code exemplifies in depth how the deployment order is calculated.

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

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

CREATE VIEW VIEW1 -- level 4, depends on level-3 objects
AS SELECT * FROM VIEW2, VIEW3;

CREATE VIEW VIEW2 -- level 3, depends on level-2 objects
AS SELECT * FROM VIEW4, VIEW5, VIEW3;

CREATE VIEW VIEW4 -- level 1, depends on level-0 objects
AS SELECT * FROM TABLE1, TABLE2;

CREATE VIEW VIEW5 -- level 1, depends on level-0 objects
AS SELECT * FROM TABLE1;

CREATE VIEW VIEW3 -- level 2, depends on level-1 objects
AS SELECT * FROM VIEW6;

CREATE VIEW VIEW6 -- level 1, depends on level-0 objects
AS SELECT * FROM TABLE2;

The deployment order starts with 0, so code units without any dependencies will start at this level. In the example above, TABLE1 and TABLE2 will have a level 0 .

For the next level, we will focus on code units that depend on code units of level 0. VIEW4, VIEW5, and VIEW6 depend directly on TABLE1 and TABLE2, so their level will be 1.

After identifying all the code units of level 1 , we will focus on code units of level 2. In that particular scenario, just VIEW3 depends on VIEW6 , so VIEW3 will be level 2.

Once we identify all code units of level 2, we will focus on level 3. In the example above, VIEW2 depends on VIEW4, VIEW5 and VIEW3, however, the highest dependency level is 2, so, VIEW2 will be of level 3.

Finally, we got VIEW1, which depends on VIEW2 and VIEW3. Since VIEW2 is the dependency with higher level, VIEW1 will get level 4.

After making all the calculations, the top-level code units report will look something like the following table.

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;