SnowConvert AI - トップレベルコードユニットレポート¶

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

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

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

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

スコープ外のトップレベルコードユニットとは、 SnowConvert AI の変換スコープ外のコードユニットです。このため、変換率を計算する際には、これらのコードユニットは考慮されません。これらの各コードユニットには、変換率はありません（ 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行のみだからです。

デプロイ順序¶

デプロイ順序の列は、各コードユニットをSnowflakeにデプロイする正しい順序を表しています。

次のコードは、デプロイ順序がどのように計算されるかを詳しく例示しています。

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;

デプロイ順序は 0 から始まるので、依存関係のないコードユニットはこのレベルから始まります。上記の例では、 TABLE1 と TABLE2 はレベル 0 を持ちます。

次のレベルでは、レベル 0 のコードユニットに依存するコードユニットに注目します。 VIEW4 、 VIEW5 、および VIEW6 は TABLE1 と TABLE2 に直接依存するので、それらのレベルは 1 になります。

レベル 1 のすべてのコードユニットを特定した後、レベル 2 のコードユニットに注目します。 その特定のシナリオでは、 VIEW3 が VIEW6 に依存しているだけなので、 VIEW3 はレベル 2 になります。

レベル 2 のすべてのコードユニットを特定したら、レベル3に注目します。上記の例では、 VIEW2 は VIEW4 、 VIEW5 、 VIEW3 に依存しますが、最も高い依存レベルは 2 であるため、 VIEW2 はレベル 3 になります。

最後に、 VIEW2 と VIEW3 に依存する VIEW1 があります。VIEW2 はより高いレベルを持つ依存関係なので、 VIEW1 はレベル 4 になります。

すべての計算が終わると、トップレベルコードユニットレポートは次の表のようになります。

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;