SnowConvert: Oracle

SnowConvert for Oracleとは

SnowConvert は、 Oracle SQL および PL/SQL を理解し、以下の変換を行うソフトウェアです。

SnowConvert 用語集

これらのコード変換のマジックに没頭する前に、ここで用語/定義のいくつかを紹介し、さまざまなドキュメントでこれらが使用されるときにその意味が分かるようにしておきます。

  • _ SQL （構造化クエリ言語）: _ 大半の現代的なデータベースアーキテクチャーにおけるデータの保存、操作、検索のための標準言語。

  • _ PL/SQL: _ SQL のためのプロシージャ言語。これはOracleによって作成され、現在でもOracleのストアドプロシージャや関数のスクリプト言語として使用されています。

  • _ SnowConvert _ : Oracleデータファイルを安全かつ自動的にSnowflakeクラウドデータプラットフォームに変換するソフトウェアです。

  • _ 変換ルールまたは変換ルール: _ ソースコードの一部から SnowConvert に変換し、期待されるターゲットコードを決定するルール。

  • _ 解析: _ 解析または構文解析は、ソースコードを理解し、変換ルールを処理するための内部データ構造を構築するために、 SnowConvert によって行われる初期処理です。

Snowflake SnowConvert が実行できるコード変換のいくつかを見てみましょう。

コード変換

Oracle SQL からSnowflake SQL へ

SnowConvert for Oracleは、 SQL のOracleソースコードを取り込み、ソースコード内のデータ定義言語（DDL）、データ操作言語（DML）、および関数を、Snowflake SQL の対応する SQL に変換します。

例

以下は、単純な CREATE TABLE ステートメントの変換例です。

ソースコード:

CREATE TABLE "MyTable"
(
  "COL1" NUMBER,
  "COL2" NUMBER,
  "COL3" NUMBER GENERATED ALWAYS AS (COL1 * COL2) VIRTUAL,
  "COL4" LONG,
  "COL5" CLOB,
  "COL6" ROWID,
  "COL7" NVARCHAR2(10),
  "COL8" RAW(255),
  CONSTRAINT "PK" PRIMARY KEY ("COL1")
);
Copy

移行されたSnowflake SQL コード:

CREATE OR REPLACE TABLE "MyTable"
  (
    "COL1" NUMBER(38, 18) /*** SSC-FDM-0006 - NUMBER TYPE COLUMN MAY NOT BEHAVE SIMILARLY IN SNOWFLAKE. ***/,
    "COL2" NUMBER(38, 18) /*** SSC-FDM-0006 - NUMBER TYPE COLUMN MAY NOT BEHAVE SIMILARLY IN SNOWFLAKE. ***/,
    "COL3" NUMBER(38, 18) /*** SSC-FDM-0006 - NUMBER TYPE COLUMN MAY NOT BEHAVE SIMILARLY IN SNOWFLAKE. ***/ AS (COL1 * COL2),
    "COL4" VARCHAR,
    "COL5" VARCHAR,
    "COL6" VARCHAR(18) !!!RESOLVE EWI!!! /*** SSC-EWI-0036 - ROWID DATA TYPE CONVERTED TO VARCHAR ***/!!!,
    "COL7" VARCHAR(10),
    "COL8" BINARY,
    CONSTRAINT "PK" PRIMARY KEY ("COL1")
  )
  COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
  ;
Copy

この変換された SQL には、多数の変換されたものがあることにお気づきでしょう。ハイライトの一部:

  • ユーザーが指定しない場合、すべてのテーブルと表示名にデフォルトで PUBLIC スキーマを追加

  • CREATE TABLE から CREATE OR REPLACE TABLE へ

  • データ型の変換:

    • LONG から VARCHAR へ

    • CLOB から VARCHAR へ

    • ROWID から VARCHAR へ

    • NVARCHAR2 から VARCHAR へ

    • RAW から BINARY へ

  • データ型属性: GENERATED ALWAYS AS (COL1 * COL2) VIRTUAL から AS (COL1 * COL2) へ

データ型とそれに相当する詳細情報: データ型。その他の例はドキュメントの他の部分にあります。

Oracle PL/SQL

SnowConvert は、Oracleストアドプロシージャおよび関数（PL/SQL）を取り込み、それらを Snowflake Scripting または JavaScript に変換してSnowflake SQL に埋め込みます。Oracle CREATE PROCEDURE および REPLACE PROCEDURE 構文はSnowflake CREATE OR REPLACE PROCEDURE 構文に置き換えられます。

例

ログに使用されるテーブルに挿入する、Oracleの単純な CREATE PROCEDURE の変換の例を示します。

注釈

この例は、Snowflake Scriptingと JavaScript の両方で使用されます。

CREATE OR REPLACE PROCEDURE SC_DEMO.PROC_LOG 
      (final_proc  VARCHAR2, 
       final_message   VARCHAR2,
       logger_type VARCHAR2 DEFAULT 'I')
AS
BEGIN
  INSERT INTO SC_DEMO.PROC_LOG_TABLE
    VALUES (SC_DEMO.final_logging_seq.NEXTVAL,
            sysdate,
            SUBSTR(logger_type, 1, 1),
            SUBSTR(final_proc, 1, 30),
            SUBSTR(final_message, 1, 1024));
  COMMIT;

END;
Copy

Snowflake Scriptingへ

Snowflake Scriptingは、Snowflake SQL の拡張機能として動作し、プロシージャロジックのサポートを追加します。これにより、ストアドプロシージャを作成し、Oracle PL/SQL の同様の動作やステートメントを再現することができます。

移行例

CREATE OR REPLACE PROCEDURE SC_DEMO.PROC_LOG
(final_proc VARCHAR, final_message VARCHAR,
 logger_type VARCHAR DEFAULT 'I')
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
  BEGIN
    INSERT INTO SC_DEMO.PROC_LOG_TABLE
      VALUES (SC_DEMO.final_logging_seq.NEXTVAL, CURRENT_TIMESTAMP(),
              SUBSTR(:logger_type, 1, 1),
              SUBSTR(:final_proc, 1, 30),
              SUBSTR(:final_message, 1, 1024));
    --** SSC-FDM-OR0012 - COMMIT REQUIRES THE APPROPRIATE SETUP TO WORK AS INTENDED **
    COMMIT;
  END;
$$;
Copy

JavaScript へ

JavaScript がスクリプト言語として呼び出される場合、すべての内部ステートメントは JavaScript に変換されます。JavaScript API の詳細については、 このドキュメント をご確認ください。

移行例

-- Additional Params: -t JavaScript
CREATE OR REPLACE PROCEDURE SC_DEMO.PROC_LOG
(final_proc STRING, final_message STRING,
 logger_type STRING DEFAULT 'I')
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
  // SnowConvert Helpers Code section is omitted.

  EXEC(`INSERT INTO SC_DEMO.PROC_LOG_TABLE
  VALUES (SC_DEMO.final_logging_seq.NEXTVAL, CURRENT_TIMESTAMP(),
            SUBSTR(?, 1, 1),
            SUBSTR(?, 1, 30),
            SUBSTR(?, 1, 1024))`,[LOGGER_TYPE,FINAL_PROC,FINAL_MESSAGE]);
  EXEC(`--** SSC-FDM-OR0012 - COMMIT REQUIRES THE APPROPRIATE SETUP TO WORK AS INTENDED **
COMMIT;`);
$$;
Copy

この変換された SQL では、Snowflake SQL に組み込まれた新しい言語（JavaScript）に変換されていることがわかります。ハイライトいくつかありますが、このドキュメントにはこの種の変換を理解するための要点がすべて書かれていると言っていいでしょう。

// ... 必要な SnowConvert ヘルパーはここに挿入されています ... と記述された行は、実際には SnowConvert JavaScript ヘルパー があります。長くなるため、この最初の例からは削除しました。

これで完了です。Snowflake SnowConvert は、データプラットフォームの変更に伴う苦痛やフラストレーションを解消します。次のページでは、 SnowConvert for Oracleの使用方法について詳しく説明します。

言語: 日本語