コンバージョン ワークスペース

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

コンバージョン ワークスペースを使用すると、移行元のデータベースのスキーマとオブジェクトを、移行先のデータベースと互換性のある SQL 構文に変換できます。このページでは、Database Migration Service のコンバージョン ワークスペースの概要について説明します。

• コードとスキーマの自動変換でサポートされるオブジェクトには、スキーマの自動変換でサポートされている Oracle オブジェクトが一覧表示されます。

• インタラクティブな SQL エディタでは、コンバージョン ワークスペース エディタで直接変更できるオブジェクトについて説明します。

• Gemini アシストの変換機能では、生成 AI サポートを統合してスキーマ変換プロセスを迅速化する方法について説明します。

• コンバージョン マッピング ファイルのセクションでは、自動スキーマ変換のルールをオーバーライドするために使用できるカスタマイズ ディレクティブの概要について説明します。

• 以前の変換ワークスペースでは、インタラクティブな SQL エディタをサポートしていない以前のワークスペースについて説明します。

スキーマの自動変換を使用するか、追加のコンバージョン マッピング ファイルを作成するかにかかわらず、Oracle の移行ではサポートされていないデータ型があります。詳細については、 データ型の既知の制限事項をご覧ください。

コードとスキーマの自動変換

コンバージョン ワークスペースを作成すると、Database Migration Service は初期スキーマ変換を自動的に実行します。自動スキーマ変換は、使用可能な Oracle データベース オブジェクトの非常に特定のサブセットをサポートしています。

自動コード変換では、次の Oracle データベース オブジェクトがサポートされています。

インタラクティブ SQL エディタ

インタラクティブな SQL エディタを使用すると、変換された PostgreSQL 構文を Database Migration Service で直接変更できます。コンバージョンに関する問題を解決したり、ニーズに合わせてスキーマを調整したりできます。一部のオブジェクトは、組み込みエディタで変更できません。

編集可能な Oracle オブジェクト

ソース データベースのコードとスキーマを変換したら、インタラクティブ エディタを使用して、特定のタイプのオブジェクトに対して生成された SQL を変更できます。エディタでサポートされている Oracle オブジェクトは次のとおりです。

• テーブル トリガー（権限が必要）
• マテリアライズド ビュー
• パッケージ
• 関数、ストアド プロシージャ
• 類義語
• ビュー
• 制約
• インデックス
• シーケンス

また、一部のオブジェクトは変換されますが、Database Migration Service 内で直接編集することはできません。このようなオブジェクトを変更するには、 変換されたスキーマとコードを適用した後に、移行先データベースで直接更新を行う必要があります。

編集がサポートされていないオブジェクト:

• ユーザー定義オブジェクト タイプ
• テーブル
• スキーマ

Gemini アシストによる変換機能

Database Migration Service は、Gemini for Workspace をコンバージョン ワークスペースに統合し、次の 2 つの領域でコンバージョン プロセスを高速化および改善します。 Google Cloud

• コンバージョン アシスタントを使用してコードの説明機能を提供します。コンバージョン アシスタントは、コンバージョン ロジックの理解、コンバージョンの問題の修正案の提案、変換されたコードの最適化に役立つ一連の専用プロンプトです。

• Gemini コード変換の候補を使用すると、コンバージョンの問題の修正を迅速に行うことができます。これは、コンバージョンの問題を修正する際に Gemini モデルが学習し、ワークスペース内の他の不具合のあるオブジェクトの変更を提案するメカニズムです。

Gemini による変換の詳細については、次のページをご覧ください。

• Gemini アシスタンスを使用して Oracle のコードとスキーマを変換する

• 変換に関する問題のあるコードオブジェクトを修正するワークフローの例

コンバージョン マッピング ファイル

コンバージョン ロジックは、コンバージョン マッピング ファイルでカスタマイズできます。変換マッピング ファイルは、Oracle オブジェクトを PostgreSQL オブジェクトに変換する方法に関する正確な指示（変換ディレクティブ）を含むテキスト ファイルです。

サポートされているコンバージョン ディレクティブ

Database Migration Service は、変換マッピング ファイルの次の変換ディレクティブをサポートしています。

EXPORT_SCHEMA 1

SCHEMA SCHEMA_NAME

DATA_TYPE ORACLE_DATA_TYPE1:PGSQL_DATA_TYPE1
DATA_TYPE ORACLE_DATA_TYPE2:PGSQL_DATA_TYPE2...

DATA_TYPE REAL:double precision,SMALLINT:integer

MODIFY_TYPE SOURCE_TABLE_NAME1:COLUMN_NAME:EXPECTED_END_RESULT_DATA_TYPE
MODIFY_TYPE SOURCE_TABLE_NAME2:COLUMN_NAME:EXPECTED_END_RESULT_DATA_TYPE...

MODIFY_TYPE events:dates_and_times:DATETIME,users:pseudonym:TEXT

PG_INTEGER_TYPE 1

PG_NUMERIC_TYPE 1

DEFAULT_NUMERIC POSTGRESQL_NUMERIC_DATA_TYPE

DEFAULT_NUMERIC integer

REPLACE_COLS SOURCE_TABLE_NAME1(SOURCE1_TABLE1_COLUMN_NAME1:DESTINATION_TABLE1_COLUMN_NAME1,SOURCE_TABLE1_COLUMN_NAME2:DESTINATION_TABLE1_COLUMN_NAME2),SOURCE_TABLE_NAME2(SOURCE_TABLE2_COLUMN_NAME1:DESTINATION_TABLE2_COLUMN_NAME1,SOURCE_TABLE2_COLUMN_NAME2:DESTINATION_TABLE2_COLUMN_NAME2)...

REPLACE_COLS events(dates_and_times:event_dates),users(pseudonym:nickname)

REPLACE_TABLES SOURCE_TABLE_NAME1:DESTINATION_TABLE_NAME1 SOURCE_TABLE_NAME2:DESTINATION_TABLE_NAME2

REPLACE_TABLES "events:login_events" "users:platform_users"

REPLACE_TABLES "events:NEW_SCHEMA_NAME.login_events"
    

データ型のカスタマイズ用のアリアス

変換ディレクティブを使用して Database Migration Service が異なるデータ型を変換する方法を変更する場合（ DATA_TYPE、 MODIFY_TYPE、 PG_NUMERIC_TYPE ディレクティブなどを使用する場合）、ソース SQL データ型の代わりにエイリアスを使用できます。

次のセクションを開くと、Database Migration Service でサポートされているデータ型のエイリアスのリストが表示されます。

コンバージョン マッピング ファイルの例

サポートされているすべてのスキーマ変換ディレクティブを使用するコンバージョン マッピング ファイルのサンプルを次に示します。

EXPORT_SCHEMA 1
SCHEMA root

PG_NUMERIC_TYPE 0
PG_INTEGER_TYPE 1
DEFAULT_NUMERIC integer
DATA_TYPE NUMBER(4\,0):integer
MODIFY_TYPE events:dates_and_times:TIMESTAMP
REPLACE_COLS events(dates_and_times:event_dates),users(pseudonym:nickname)
REPLACE_TABLES events:login_events users:platform_users

このファイルを使用すると、次のようになります。

• EXPORT_SCHEMA 1 は必須のディレクティブです。
• SCHEMA root を使用すると、コンバージョン フローに対して次のような調整が行われます。
  • Database Migration Service は、root スキーマ内のエンティティの変換のみを行います。他のスキーマは変換されません。
  • このファイル内の他のすべてのカスタマイズ ディレクティブは、root スキーマで定義された列とデータ型にのみ適用されます。
• PG_INTEGER_TYPE 1 を使用すると、Database Migration Service は root スキーマのテーブルにあるすべての Oracle 数値データ型を、ANSI ポータブル数値型ではなく PostgreSQL 固有の型に変換します。
• DEFAULT_NUMERIC を使用すると、Database Migration Service は、指定された小数点のない NUMBER 値を PostgreSQL の INTEGER 型に変換します。これは、root スキーマのテーブルにある NUMBER 値にのみ適用されます。
• DATA_TYPE NUMBER(4\,0):integer を使用すると、Database Migration Service は特定の NUMBER(4,0) 値を PostgreSQL の INTEGER に変換します。
• MODIFY_TYPE ディレクティブを使用すると、Database Migration Service は、実際のソース列の形式に関係なく、events ソーステーブルの dates_and_times 列のデータを PostgreSQL DATETIME 型に変換します。
• REPLACE_COLS events(dates_and_times:event_dates),users(pseudonym:nickname) を使用すると、変換されたスキーマ内の次の列の名前が Database Migration Service によって変更されます。
  • ソースの events テーブルの dates_and_times 列は、変換されたスキーマの同じテーブルで event_dates に名前が変更されます。
  • ソースの users テーブルの pseudonym 列は、変換されたスキーマの同じテーブルで nickname に名前が変更されます。
  名前変更オペレーションは、root スキーマの events テーブルと users テーブルにのみ適用されます。
• REPLACE_TABLES events:login_events users:platform_users は、変換されたスキーマ内の次のテーブルの名前を変更します。
  • events テーブルの名前が login_events に変更されました。
  • users テーブルの名前が platform_users に変更されました。
  名前変更オペレーションは、root スキーマの events テーブルと users テーブルにのみ適用されます。

従来のコンバージョン ワークスペース

以前のコンバージョン ワークスペースは、より制限の多い古いタイプのコンバージョン ワークスペースです。従来の変換ワークスペースは、Gemini 拡張変換機能やインタラクティブ SQL エディタをサポートしていません。これらのファイルは、Ora2Pg 移行ツールで移行元のスキーマを変換する場合にのみ使用できます。

移行には、従来型のコンバージョン ワークスペースの使用はおすすめしません。シナリオで以前のコンバージョン ワークスペースを使用する必要がある場合は、 以前のコンバージョン ワークスペースを使用するをご覧ください。

次のステップ

• インタラクティブ コンバージョン ワークスペースの使用方法については、 インタラクティブ コンバージョン ワークスペースを作成するをご覧ください。