コンバージョン ワークスペースのアクション

コンバージョン ワークスペースでは、変換に関する問題を修正したり、インタラクティブ エディタでオブジェクトを変更したり、変換されたスキーマを移行先データベースに適用したりできます。 このページでは、コンバージョン ワークスペースで実行できるすべてのアクションの概要について説明します。

変換ステータスを確認する

コンバージョン ワークスペースの画面。[コンバージョンの概要] タブには、変換されたオブジェクトの数、変換の問題、Gemini による変換の拡張機能が表示されます。
図 1.コンバージョン ワークスペースの概要画面。 （クリックして拡大）
コンバージョン ワークスペースの画面。[コンバージョンの概要] タブには、変換されたオブジェクトの数、変換の問題、Gemini による変換の拡張機能が表示されます。

[コンバージョンの概要] セクションでは、スキーマ変換に関するすべての情報（変換されたオブジェクトの数とタイプ、変換ステータス（未解決の問題や解決済みの問題など）、 Gemini アシストによる自動変換で提供される拡張機能のリストなど）を確認できます。

また、各カテゴリのフィルタを使用して、タイプ、問題の重大度、未解決の問題、解決済みの 問題ごとに、ツリービューに表示されるオブジェクトの 数を絞り込むこともできます。[**コンバージョンの概要**] は、 アップグレードされたコンバージョン ワークスペースでのみ使用できます。

コードとスキーマの変換の進行状況に関する詳細情報を表示する手順は次のとおりです。

  1. コンソール Google Cloud で [Conversion workspaces] に移動し、ワークスペースを選択します。

    コンバージョン ワークスペースに移動

  2. [Oracle] タブで、スキーマ ツリービューを使用して次のいずれかを行います。
    • [Oracle] を選択して、ワークスペース内の変換されたすべてのスキーマのすべてのオブジェクトの情報を表示します。
    • 特定のスキーマまたはオブジェクトを選択して、オブジェクトのサブセットの変換の詳細を表示します。
  3. [**コンバージョンの概要**] タブで、 [**変換されたオブジェクトの概要**] セクションの情報を確認します。Use the [Show objects] button to apply any filter to the tree view in the [Oracle] tab.
  4. [変換に関する問題] タブを使用して、変換に関する問題の解決を開始します。詳細については、 変換に関する問題を解決するをご覧ください。

ソース スキーマからオブジェクトを削除する

ソース スキーマからオブジェクトを削除して、変換から除外します。 削除したオブジェクトは、必要に応じて後で 追加できます。

  1. コンソール Google Cloud で [Conversion workspaces] に移動し、ワークスペースを選択します。

    コンバージョン ワークスペースに移動

  2. [Oracle] タブで、削除するオブジェクトの横にある [その他] > [削除] を選択します。
  3. [オブジェクトの削除] 確認ダイアログで、[削除] をクリックします。
  4. 変換されたスキーマを更新します。 [Convert source]. Database Migration Service が変更を分析し、更新された PostgreSQL スキーマを生成します。

    変換されたスキーマは、 [Cloud SQL for PostgreSQL のドラフト] タブで確認できます。

ソース スキーマにオブジェクトを追加する

ソース スキーマから以前に削除したオブジェクトを追加して、変換に追加できます。

  1. コンソール Google Cloud で [Conversion workspaces] に移動し、ワークスペースを選択します。

    コンバージョン ワークスペースに移動

  2. [Oracle] タブで、 [オブジェクトを追加] をクリックします。
  3. [オブジェクトを追加] セクションで、ソースリストを使用して、ソース スキーマに追加するすべてのエンティティを選択します。

    [オブジェクトをフィルタ] ボタンを使用すると、表示するオブジェクトの数を減らすことができます。 ソース スキーマ ビューでオブジェクトをフィルタするをご覧ください。

  4. [オブジェクトを追加] をクリックします。
  5. 変換されたスキーマを更新します。 [Convert source]. Database Migration Service が変更を分析し、更新された PostgreSQL スキーマを生成します。

    変換されたスキーマは、 [Cloud SQL for PostgreSQL のドラフト] タブで確認できます。

ソース スキーマとコード スナップショットを pull する

ソース データベースからスキーマとコードをコンバージョン ワークスペースにいつでも pull できます。ソースを pull すると、変換で新しいオブジェクトを追加したり、既存のオブジェクトを更新したりできます。

更新されたデータベース スキーマとコードを pull しても、カスタム マッピングを明示的に削除しない限り、コンバージョン ワークスペースに存在するカスタム マッピングはリセットされません。

また、ソースを pull しても、コード オブジェクトの SQL の変更はオーバーライドされません。これらの変更は、オブジェクト レベルで直接リセットできます。

  1. コンソール Google Cloud で [Conversion workspaces] に移動し、ワークスペースを選択します。

    コンバージョン ワークスペースに移動

  2. [ 構成を編集 > ソース スキーマのスナップショットを再度 pull する] をクリックします。
  3. ダイアログ ボックスで次の操作を行います。
    1. 省略可: [カスタム マッピングをリセット] を選択して、既存の カスタム マッピングと DDL の変更を削除します。
    2. [スキーマのスナップショットを pull] をクリックします。

      Database Migration Service がソース データベースから新しいスナップショットを pull します。

  4. 変換されたスキーマを更新します。 [Convert source]. Database Migration Service が変更を分析し、更新された PostgreSQL スキーマを生成します。

    変換されたスキーマは、 [Cloud SQL for PostgreSQL のドラフト] タブで確認できます。

カスタム コンバージョン マッピングを使用する

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

カスタム マッピング ファイルを作成する

カスタム マッピング ファイルを作成する手順は次のとおりです。

  1. サポートされている変換ディレクティブのリストを確認します。

  2. 構成ファイルの例を参照してください。

  3. テキスト エディタでカスタム コンバージョン マッピングを作成し、コンバージョン ワークスペースにアップロードします。

カスタム マッピング ファイルを追加する

カスタム コンバージョン マッピング ファイルをワークスペースに追加する手順は次のとおりです。

  1. コンソール Google Cloud で [Conversion workspaces] に移動し、ワークスペースを選択します。

    コンバージョン ワークスペースに移動

  2. コンバージョン エディタ ページで、 [構成を編集] > [構成ファイルを使用してマッピングをカスタマイズ] を選択します。
  3. [**構成ファイル**] ボックスで [**参照**] をクリックし、 システムのファイル選択ツールを使用して構成ファイルを選択します。
  4. [Add file] > [Create mapping] をクリックします。

カスタム マッピング ファイルを削除する

カスタム コンバージョン マッピング ファイルをワークスペースから削除する手順は次のとおりです。

  1. コンソール Google Cloud で [Conversion workspaces] に移動し、ワークスペースを選択します。

    コンバージョン ワークスペースに移動

  2. コンバージョン エディタ ページで、 [構成を編集] [>] [カスタム マッピングを削除] を選択します。

変換の結果を確認する

ソースのコンバージョンを実行したら、ワークスペース エディタ領域で、変換された個々のオブジェクトの変換結果と考えられる問題を確認できます。Google Cloud CLI を使用して、すべての結果と問題をテキスト ファイルに一括で保存することもできます。

コンソール

  1. コンソール Google Cloud で [**コンバージョン ワークスペース**] に移動します。

    コンバージョン ワークスペースに移動

  2. 操作するコンバージョン ワークスペースの表示名をクリックします。

    コンバージョン ワークスペース エディタが開きます。

  3. [Oracle] タブを選択し、ツリービュー テーブルで変換結果を確認するオブジェクトを見つけます。

  4. オブジェクトを選択します。[SQL] タブと [変換に関する問題] タブを使用して、変換を確認します。

  5. 問題が警告であり、対応が必要ない場合は、 解決済みに できます。それ以外の場合は、さらに調査して コンバージョン エディタで 修正できます。

gcloud

Google Cloud CLI を使用すると、すべての変換結果または問題をターミナルに出力できます。出力をファイルにリダイレクトすると、オブジェクトの一括確認がより便利になります。

変換結果のリストを取得する

gcloud CLI は、変換結果をターミナルにデータ定義言語 （DDL）ステートメントの形式で表示します。変換結果をファイルに保存するには、次のコマンドを実行します。

  gcloud database-migration conversion-workspaces describe-ddls \
  CONVERSION_WORKSPACE_ID \
  --region=REGION_ID \
  > OUTPUT_FILE_PATH

次のように置き換えます。

  • CONVERSION_WORKSPACE_ID は、コンバージョン ワークスペースの識別子に置き換えます。 コンバージョン ワークスペースの識別子を取得する方法については、 コンバージョン ワークスペースの詳細を表示するをご覧ください。
  • REGION_ID は、コンバージョン ワークスペースがあるリージョンの名前に置き換えます。

  • OUTPUT_FILE_PATH は、出力の保存先となるテキスト ファイルのパスに置き換えます。

    例:

    gcloud database-migration conversion-workspaces describe-ddls \
my-conversion-workspace \
--region=us-central1 \
> ./my-ddls-list.txt

    結果:

    スキーマ変換の結果は、最初の行が DDLs で、以降の行が SQL ステートメントで構成されるテキスト形式で保存されます。

    DDLs
CREATE SCHEMA IF NOT EXISTS "SCHEMA1";
ALTER TABLE "SCHEMA1"."EMPLOYEES" ADD CONSTRAINT PK_ID PRIMARY KEY ("ID");
CREATE OR REPLACE FUNCTION mockschema.func_test_datatype(str1 VARCHAR(65000))
  RETURNS DECIMAL
  LANGUAGE plpgsql
  AS $$
    DECLARE
      str2 VARCHAR(100);
    BEGIN
      SELECT
          employees.first_name
        INTO STRICT
          STR2
        FROM
          mockschema.employees
        WHERE employees.employee_id = CAST(FUNC_TEST_DATATYPE.str1 as DECIMAL)
      ;
      RAISE NOTICE '%', concat('Input : ', FUNC_TEST_DATATYPE.str1, ' Output : ', str2);
      RETURN 0;
    END;
  $$;
CREATE OR REPLACE PROCEDURE greetings AS BEGIN dbms_output.put_line('Hello World!'); END;
CREATE SYNONYM TABLE "SCHEMA1"."SYNONYM1" ON "SCHEMA1"."EMPLOYEES";
CREATE OR REPLACE VIEW "SCHEMA1"."VIEW1" AS SELECT * FROM JOBS;

変換に関する問題のリストを取得する

変換に関する問題をファイルに保存するには、次のコマンドを実行します。

  gcloud database-migration conversion-workspaces describe-issues \
  CONVERSION_WORKSPACE_ID \
  --region=REGION_ID \
  > OUTPUT_FILE_PATH

次のように置き換えます。

  • CONVERSION_WORKSPACE_ID は、コンバージョン ワークスペースの識別子に置き換えます。 コンバージョン ワークスペースの識別子を取得する方法については、 コンバージョン ワークスペースの詳細を表示するをご覧ください。
  • REGION_ID は、コンバージョン ワークスペースがあるリージョンの名前に置き換えます。
  • OUTPUT_FILE_PATH は、出力の保存先となるテキスト ファイルのパスに置き換えます。

例:

  gcloud database-migration conversion-workspaces describe-issues \
  my-conversion-workspace \
  --region=us-central1 \
  > ./my-conversion-issues.txt

結果:

ワークスペースに含まれる変換に関する問題はすべて、最初の行に列ヘッダーが含まれ、以降の行に個別の変換に関する問題が含まれるテキスト 形式で保存されます。

  PARENT   NAME               ENTITY_TYPE       ISSUE_TYPE  ISSUE_SEVERITY  ISSUE_CODE  ISSUE_MESSAGE
  SCHEMA1  EMPLOYEES          TABLE             DDL         ERROR           500         unable to parse DDL.
  SCHEMA1  EMPLOYEES          TABLE             CONVERT     WARNING         206         no conversion done.
  SCHEMA1  STORED_PROCEDURE1  STORED_PROCEDURE  DDL         ERROR           500         invalid DDL.
  SCHEMA1  SYNONYM1           SYNONYM           CONVERT     WARNING         206         synonym warning message.

変換されたオブジェクトに対して Gemini 品質評価レポートを実行することもおすすめします。 これらの評価では、変換されたコードが分析され、ソースコードと比較してその正確性と動作に関するフィードバックが提供されます。 詳細については、 Gemini 品質評価をご覧ください。

変換に関する問題を解決する

Database Migration Service では、ソース全体を自動的に変換できない場合があります。 ほとんどの Oracle オブジェクトでは、Database Migration Service のコンバージョン エディタで直接、生成された SQL を調整できます。それ以外の場合は、ソース データベースでオブジェクトを直接変更してから、 ソース スナップショットを再度 pull する必要があります。

Database Migration Service のコンバージョン ワークスペースで直接編集できるオブジェクトの完全なリストについては、 編集可能な Oracle オブジェクトをご覧ください。

スキーマで検出された変換に関する問題を解決する手順は次のとおりです。

  1. コンソール Google Cloud で [Conversion workspaces] に移動し、ワークスペースを選択します。

    コンバージョン ワークスペースに移動

  2. 変換結果を確認し、考えられる問題を特定します。

    個々のオブジェクトを確認するには Google Cloud コンソールを使用し、すべてのオブジェクトを一括で確認するには gcloud CLI を使用します。

  3. 問題のタイプに応じて、ワークスペース エディタで直接修正するか、カスタマイズされた変換マッピング ファイルを指定する必要があります。詳細については、次のセクションを開いてください。

    どのようなタイプの問題に対処する場合でも、 Gemini を搭載した変換アシスタントを使用して解決策を見つけることができます。 詳細については、 Gemini 変換アシスタントを使用するをご覧ください。 問題が警告であり、対応が必要ない場合は、 解決済みにできます。

    組み込みエディタでサポートされているオブジェクトに関する問題を解決する

    ワークスペース エディタでサポートされているオブジェクトで発生した問題を解決する手順は次のとおりです。

    1. [Oracle] ツリービューで問題を見つけて、 [コード] タブを選択します。
    2. SQL エディタを使用して、生成されたコードを更新します。Database Migration Service は、エディタで追加した SQL コードの正確性を検証しません。

    組み込みエディタでサポートされていないオブジェクトに関する問題を解決する

    ワークスペース エディタでサポートされていないオブジェクトで発生した問題を解決するには、次のいずれかを行います。

    ソースで欠陥のあるオブジェクトを更新する
    問題によっては、ソース データベースで Oracle ステートメントを直接変更する必要があります。次の操作を行います。
    1. ソース データベースでスキーマとコードを直接更新します。
    2. 更新されたソースを Database Migration Service に pull します。
    3. ソースを再度変換し、問題が解決しないかどうかを確認します。
    変換マッピング ファイルを使用してマッピングを追加する

    変換マッピング ファイルを使用すると、Database Migration Service が特定の PostgreSQL オブジェクトを変換する方法を正確に定義できます。変換マッピング ファイルを使用する手順は次のとおりです。

    1. 変換マッピング ファイルを作成します。
    2. 構成ファイルをワークスペースに追加します。
    3. ソースを再度変換し、問題が解決しないかどうかを確認します。
    ソースタブからオブジェクトを削除してみる
    Database Migration Service では、 を変換できます。 変換プロセスをブロック解除するには、後で欠陥のあるオブジェクトを詳しく調べることにします。 ソースタブからオブジェクトを削除します。
  4. スキーマをテストして、Database Migration Service がコードを移行先データベースに正しく 適用できることを確認します。

  5. テストが成功した場合は、 [変換に関する問題] タブを使用して、問題を 解決済み にすることをおすすめします。 これにより、これらの問題をコンバージョンの概要から除外して、後で中断したところから再開できます。

問題を解決済みにする

変換に関する問題を確認して修正する際に、すでに修正した問題（または移行に影響しないと判断して対応が必要ない問題）を追跡できます。[解決済みにする] 機能を使用すると、このような問題をフィルタして、問題リストを簡単に移動できます。

問題を解決済みにする手順は次のとおりです。

  1. コンソール Google Cloud で [Conversion workspaces] に移動し、ワークスペースを選択します。

    コンバージョン ワークスペースに移動

  2. [ソースツリー] ビューを使用して、変換に関する問題があるオブジェクトを選択します。

  3. [変換に関する問題] タブで、問題の横にある [解決済みにする] をクリックします。 これで、これらの問題をコンバージョンの概要から除外できます。

    コンバージョンに関する問題を解決済みとしてマークし、コンバージョンの概要画面でフィルタリングできる問題解決画面。
    図 2.問題を解決済みにできる [変換に関する問題] 画面。（クリックして拡大）
    コンバージョンに関する問題を解決済みとしてマークし、コンバージョンの概要画面でフィルタリングできる問題解決画面。

移行先でスキーマをテストする

スキーマを移行先データベースに適用する前に、テスト実行を行って、考えられる問題を事前に確認できます。 テストを実行するために、Database Migration Service は一時データベースを作成します。テスト実行は、移行先の Cloud SQL インスタンスに影響しません。

  1. 専用の移行ユーザーに CREATEDB 権限があることを確認します。詳細については、 移行先 Cloud SQL インスタンスを作成して構成するをご覧ください。

  2. コンソール Google Cloud で [**コンバージョン ワークスペース**] に移動します。

    コンバージョン ワークスペースに移動

  3. 操作するコンバージョン ワークスペースの表示名をクリックします。

    コンバージョン ワークスペース エディタが開きます。

  4. [移行先に適用] [>] [テスト（推奨）] をクリックします。

    移行先データベースにスキーマを適用するウィザードが表示されます。

  5. [宛先の定義] セクションで、移行先データベースを指す接続プロファイルを選択します。

  6. [定義して続行] をクリックします。

  7. [オブジェクトを選択してアプリケーションをテスト] セクションで、移行先データベースでテストするデータベース エンティティのスキーマを選択します。

    [オブジェクトをフィルタ] ボタンを使用すると、表示するオブジェクトの数を減らすことができます。 ソース スキーマ ビューでオブジェクトをフィルタするをご覧ください。

  8. [アプリケーションをテスト] をクリックします。

    [Cloud SQL for PostgreSQL] タブでアプリケーションのステータスを確認できます。

移行先にスキーマを適用する

移行先データベースで使用するスキーマが要件とマッピングに従って変換されたら、その結果を移行先データベースに適用できます。移行先にスキーマを適用しても、ソース データベースのデータは変更されません。

  1. コンソール Google Cloud で [**コンバージョン ワークスペース**] に移動します。

    コンバージョン ワークスペースに移動

  2. 操作するコンバージョン ワークスペースの表示名をクリックします。

    コンバージョン ワークスペース エディタが開きます。

  3. [移行先に適用] >[適用] をクリックします。

    移行先データベースにスキーマを適用するウィザードが表示されます。

  4. [宛先の定義] セクションで、移行先データベースを指す接続プロファイルを選択します。

  5. [定義して続行] をクリックします。

  6. [オブジェクトを確認して変換を移行先に適用] セクションで、移行先データベースに作成するデータベース エンティティのスキーマを選択します。

    [オブジェクトをフィルタ] ボタンを使用すると、表示するオブジェクトの数を減らすことができます。 ソース スキーマ ビューでオブジェクトをフィルタするをご覧ください。

  7. [移行先に適用] をクリックします。

    [Cloud SQL for PostgreSQL] タブでアプリケーションのステータスを確認できます。

コンバージョン エディタから移行ジョブを作成する

コンバージョン エディタ インターフェースから直接、コンバージョン ワークスペースを使用する移行ジョブを作成できます。

  1. コンソール Google Cloud で [**コンバージョン ワークスペース**] に移動します。

    コンバージョン ワークスペースに移動

  2. 操作するコンバージョン ワークスペースの表示名をクリックします。

    コンバージョン ワークスペース エディタが開きます。

  3. [移行ジョブを作成] をクリックします。

  4. 移行ジョブを作成する で説明されている標準の移行ジョブの手順を行います。

ソース スキーマ ビューでオブジェクトをフィルタする

データベース スキーマには数千ものオブジェクトが含まれていることが多く、変換作業を分割するのが困難です。スキーマ スナップショットからソース スキーマ ビューにオブジェクトを追加する場合は、フィルタを使用して表示するオブジェクトの数を制限できます。フィルタを使用すると、オブジェクトをより細かく追加し、スキーマの選択したサブセットの変換に集中できます。

ソース スキーマ ビューにオブジェクトを追加する場合は、フィルタ ビューを使用します。

  1. [フィルタ] フィールドで、次のいずれかのフィルタ方法を使用します。
  2. [プロパティ] リストから、次のいずれかの自動補完オプションを選択します。
    1. オブジェクト名 : オブジェクトを名前でフィルタします（例: ADMIN. ）。
    2. オブジェクト タイプ : オブジェクトを複数のタイプ（ 関数 や テーブル など）でフィルタします。
    3. 変換ステータス : オブジェクトを変換ステータス（対応が必要 や問題なし など）でフィルタします。
    4. Gemini によって拡張 : Gemini 自動変換で変換されたオブジェクトをフィルタします。

    フィルタ プロパティを論理演算子と組み合わせることができます。

  3. クエリを入力します。例: type=table。

    フィルタリング構文の詳細については、 サポートされているフィルタリング構文をご覧ください。

  4. ソース スキーマ ビューに追加するオブジェクトを選択します。

サポートされているテキスト フィルタリング構文

オブジェクトは、基本的なフリーテキスト検索で名前でフィルタすることも、専用の type プロパティを使用することもできます。 どちらの方法でも、フィルタリング用の Google API の正式な仕様がサポートされています。 つまり、ワイルドカードを含むリテラル、論理演算子、比較 演算子を使用できます。

フリーテキスト フィルタリング

フリーテキストを使用して、オブジェクトを名前でフィルタします。この方法は大文字と小文字が区別され ワイルドカードがサポートされています。

例:

*JOB* クエリはワイルドカードを使用して、 JOB 部分文字列を含むエンティティを検索します。フィルタ ビューには、いくつかのテーブル と 1 つのストアド プロシージャが返されます。

名前でオブジェクトをフィルタリングした結果の例のスクリーンショット。
type プロパティを使用してフィルタする

Database Migration Service でサポートされているすべての標準タイプでオブジェクトをフィルタできます。

type プロパティは、等号（=）演算子と不等号（!=）演算子を使用して、次のリテラルをサポートします。database、schema、table、column、index、sequence、stored_procedure、function、view、synonym、materialized_view、udt、constraint、database_package、trigger、および event_trigger。

例:

type=table フィルタは、スキーマに存在するテーブルのみを返します。

タイプ プロパティでオブジェクトをフィルタリングした結果の例のスクリーンショット。

テキスト フィルタリング条件を組み合わせる

複数の条件を論理演算子で組み合わせることで、複数の条件を指定できます。

たとえば、名前に JOB または EMPLOYEE の部分文字列が含まれるテーブルのみを検索するには、次のクエリを使用します。

  type=table AND (*JOB* OR *EMPLOYEE*)

その結果、フィルタには一致するすべてのテーブルが表示されます。

タイプと名前のプロパティの組み合わせでオブジェクトをフィルタリングした結果の例のスクリーンショット。