このページは Cloud Translation API によって翻訳されました。

コンバージョンワークスペースのアクション
bookmark_border コレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。

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

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

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

Google Cloud コンソールで [コンバージョンワークスペース] に移動し、ワークスペースを選択します。
コンバージョンワークスペースに移動
[Oracle] タブで、削除するオブジェクトの横にある [その他] > [削除] を選択します。
[オブジェクトを削除] 確認ダイアログで、[削除] をクリックします。
変換したスキーマを更新します。 [ソースを変換] をクリックします。 Database Migration Service が変更を分析し、更新された PostgreSQL スキーマを生成します。
変換されたスキーマは、[Cloud SQL for PostgreSQL ドラフト] タブで確認できます。

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

ソーススキーマから削除したオブジェクトを追加して、変換に含めることができます。

Google Cloud コンソールで [コンバージョンワークスペース] に移動し、ワークスペースを選択します。
コンバージョンワークスペースに移動
[Oracle] タブで、 [オブジェクトを追加] をクリックします。
[オブジェクトを追加] セクションで、ソースリストを使用して、ソーススキーマに追加するすべてのエンティティを選択します。
[オブジェクトをフィルタ] ボタンを使用して、表示されるオブジェクトの数を減らすことができます。ソーススキーマビューでオブジェクトをフィルタするをご覧ください。
[オブジェクトを追加] をクリックします。
変換したスキーマを更新します。 [ソースを変換] をクリックします。 Database Migration Service が変更を分析し、更新された PostgreSQL スキーマを生成します。
変換されたスキーマは、[Cloud SQL for PostgreSQL ドラフト] タブで確認できます。

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

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

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

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

Google Cloud コンソールで [コンバージョンワークスペース] に移動し、ワークスペースを選択します。
コンバージョンワークスペースに移動
[構成を編集] > [ソーススキーマのスナップショットを再度 pull する] をクリックします。
ダイアログボックスで次のように操作します。
1. （省略可）[カスタムマッピングをリセット] を選択して、既存のカスタムマッピングと DDL の変更を削除します。
2. [スキーマのスナップショットを pull する] をクリックします。
  Database Migration Service は、移行元のデータベースから新しいスナップショットを取得します。
変換したスキーマを更新します。 [ソースを変換] をクリックします。 Database Migration Service が変更を分析し、更新された PostgreSQL スキーマを生成します。
変換されたスキーマは、[Cloud SQL for PostgreSQL ドラフト] タブで確認できます。

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

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

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

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

サポートされているコンバージョンディレクティブのリストを確認する。
構成ファイルの例を参照してください。
カスタムコンバージョンのマッピングをテキストエディタで作成し、コンバージョンワークスペースにアップロードします。

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

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

Google Cloud コンソールで [コンバージョンワークスペース] に移動し、ワークスペースを選択します。
コンバージョンワークスペースに移動
コンバージョンエディタページで、 [設定を編集] > [設定ファイルを使用してマッピングをカスタマイズ] を選択します。
[設定ファイル] ボックスで [参照] をクリックし、システムファイル選択ツールを使用して設定ファイルを選択します。
[ファイルを追加] > [マッピングを作成] をクリックします。

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

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

Google Cloud コンソールで [コンバージョンワークスペース] に移動し、ワークスペースを選択します。
コンバージョンワークスペースに移動
コンバージョンエディタページで、 [設定を編集] > [カスタムマッピングを削除] を選択します。

変換の結果を確認する

ソースの変換が完了したら、ワークスペースの編集領域で、変換結果と、変換された個々のオブジェクトに関する考えられる問題を確認できます。Google Cloud CLI を使用して、すべての結果と問題を一括でテキストファイルに保存することもできます。

コンソールgcloud

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

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

コンバージョンワークスペースエディタが開きます。
[Oracle] タブを選択し、ツリービューの表でコンバージョン結果を確認するオブジェクトを見つけます。
オブジェクトを選択します。[SQL] タブと [コンバージョンの問題] タブを使用して、コンバージョンを確認します。

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 は、コンバージョンワークスペース ID に置き換えます。コンバージョンワークスペース ID を取得する方法については、コンバージョンワークスペースの詳細を表示するをご覧ください。
REGION_ID は、コンバージョンワークスペースが配置されているリージョンの名前に置き換えます。

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

例:

gcloud database-migration conversion-workspaces describe-issues \
my-conversion-workspace \
--region=us-central1 \
> ./my-conversion-issues.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 は、コンバージョンワークスペース ID に置き換えます。コンバージョンワークスペース 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.

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

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

Database Migration Service で変換ワークスペースで直接編集できるオブジェクトの一覧については、編集可能な Oracle オブジェクトをご覧ください。

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

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

コンバージョンの結果を確認し、考えられる問題を特定します。
個々のオブジェクトを確認するには Google Cloud コンソールを使用し、すべてのオブジェクトを一括で確認するには gcloud CLI を使用します。
[Cloud SQL for PostgreSQL] タブで、SQL エディタを使用して生成されたコードを更新します。
注: Database Migration Service は、エディタで追加した SQL コードの正確性を検証しません。
スキーマをテストして、Database Migration Service が移行先データベースにコードを正しく適用できることを確認します。

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

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

ソース内の不具合のあるオブジェクトを更新する

問題によっては、移行元データベースで Oracle ステートメントを直接変更する必要がある場合があります。次のように対応します。

ソースデータベースでスキーマとコードを直接更新します。
更新されたソースを Database Migration Service に pull します。
ソースを再度変換し、問題が解決したかどうかを確認します。

コンバージョンマッピングファイルで追加のマッピングを指定

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

変換マッピングファイルを作成します。
構成ファイルをワークスペースに追加します。

ソースタブからオブジェクトを削除してみてください

Database Migration Service では、コンバージョンプロセスのブロックを解除するには、後で問題のあるオブジェクトを詳しく調べることができます。ソースタブからオブジェクトを削除します。

宛先でスキーマをテストする

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

専用の移行ユーザーに CREATEDB 権限があることを確認します。詳細については、移行先の Cloud SQL インスタンスを作成して構成するをご覧ください。
Google Cloud コンソールで、[コンバージョンワークスペース] に移動します。

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

コンバージョンワークスペースエディタが開きます。
[Apply to destination] > [Test (recommended)] をクリックします。

移行先データベースにスキーマを適用するウィザードが表示されます。
[宛先の定義] セクションで、宛先データベースを指す接続プロファイルを選択します。
[定義して続行] をクリックします。
[オブジェクトの選択とアプリケーションのテスト] セクションで、宛先データベースでテストするデータベースエンティティのスキーマを選択します。

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

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

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

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

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

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

コンバージョンワークスペースエディタが開きます。
[宛先に適用] > [適用] をクリックします。

移行先データベースにスキーマを適用するウィザードが表示されます。
[宛先の定義] セクションで、宛先データベースを指す接続プロファイルを選択します。
[定義して続行] をクリックします。
[オブジェクトを確認して移行先に変換を適用する] セクションで、移行先データベースに作成するデータベースエンティティのスキーマを選択します。

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

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

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

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

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

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

コンバージョンワークスペースエディタが開きます。
[移行ジョブを作成] をクリックします。
移行ジョブを作成するで説明されている標準の移行ジョブの手順に進みます。

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

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

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

[フィルタ] フィールドで、次のいずれかのフィルタ方法を使用します。
[プロパティ] リストから、次の自動生成されたオプションのいずれかを選択します。
1. オブジェクト名: 名前（ADMIN など）でオブジェクトをフィルタします。
2. オブジェクトタイプ: 関数やテーブルなど、複数のタイプでオブジェクトをフィルタします。
3. コンバージョンステータス: コンバージョンステータス（対応が必要、問題なしなど）でオブジェクトをフィルタします。
  フィルタプロパティは論理演算子と組み合わせることができます。
クエリを入力します。たとえば、type=table となります。
フィルタリング構文の詳細については、サポートされているフィルタリング構文をご覧ください。
ソーススキーマビューに追加するオブジェクトを選択します。
重要: オブジェクトの選択は、フィルタの変更をしても保持されません。異なる条件を満たすオブジェクトを追加する場合は、より複雑なクエリを使用するか、別々の試行で追加します。

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

基本的な自由形式の検索でオブジェクトを名前でフィルタできます。また、専用の 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*)

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

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