コンバージョン ワークスペースを作成し、スキーマを変換する

このページでは、変換ワークスペースを作成し、それを使用して Oracle から PostgreSQL への決定論的コードとスキーマの変換を直ちに実行する方法について説明します。ワークスペースを作成する前に、 移行元データベースの接続プロファイルを作成してください。

必要なロール

変換ワークスペースを作成するために必要な権限を取得するには、プロジェクトに対する データベース移行管理者（roles/datamigration.admin）IAM ロールを付与するよう管理者に依頼してください。

ロールの付与の詳細については、Identity and Access Management のドキュメントの アクセスを管理するをご覧ください。

この事前定義ロールには、Database Migration Service で変換ワークスペースを作成するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

Database Migration Service で変換ワークスペースを作成するには、次の権限が必要です。

  • cloudaicompanion.entitlements.get

    この権限は、roles/datamigration.admin ロールに含まれています。 Gemini を活用したコンバージョン機能で必要になります。

  • datamigration.conversionworkspaces.apply
  • datamigration.conversionworkspaces.commit
  • datamigration.conversionworkspaces.convert
  • datamigration.conversionworkspaces.create
  • datamigration.conversionworkspaces.delete
  • datamigration.conversionworkspaces.get
  • datamigration.conversionworkspaces.getIamPolicy
  • datamigration.conversionworkspaces.list
  • datamigration.conversionworkspaces.rollback
  • datamigration.conversionworkspaces.seed
  • datamigration.conversionworkspaces.setIamPolicy
  • datamigration.conversionworkspaces.update

カスタムロールや他の 事前定義ロールを使用して、これらの権限を取得することもできます。

組み込みエディタを備えたワークスペース

インタラクティブ コンバージョン ワークスペースを作成してスキーマ変換を行うには、次の操作を行います。

  1. Google Cloud コンソールで、[変換ワークスペース] に移動します。

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

  2. [ワークスペースを設定] をクリックします。
  3. [コンバージョン ワークスペースを作成] ページで、次の操作を行います。
    1. 変換ワークスペースの名前、識別子、リージョンを入力します。
    2. [移行元データベース エンジン] プルダウン メニューから [Oracle] を選択します。
    3. [移行先データベース エンジン] で [AlloyDB for PostgreSQL] を選択します。

    4. [ワークスペースの Gemini 設定を有効にする] セクションで、チェックボックスを使用して Gemini を活用したコンバージョン機能を有効にします。これらの機能は、 Gemini アシストを使用してコードとスキーマを変換する場合に後で有効にすることもできます。

      Gemini を活用した変換機能を使用するには、Gemini for Google Cloud API が必要です。詳しくは、 Gemini を活用したコンバージョン機能をご覧ください。

    5. [ワークスペースを作成して続行] をクリックします。
  4. [ソースの定義とスキーマ スナップショットの pull] ページで、次の操作を行います。
    1. [ソース接続プロファイル] プルダウン メニューから、移行元データベースの接続プロファイルを選択します。
    2. [スキーマのスナップショットを pull して続行] をクリックします。

    Database Migration Service が移行元データベースに接続し、スキーマを取得しています。この処理には数分かかることがあります。

  5. [オブジェクトを選択して変換] ページで、チェックボックスを使用して、PostgreSQL 構文に変換するオブジェクトを選択します。

    すべてのオブジェクトを一度に変換する必要はありません。代わりに、今すぐいくつかのオブジェクトを選択して、後で 変換にオブジェクトを追加できます。

  6. [変換して続行] をクリックします。

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

以前のコンバージョン ワークスペース

以前のコンバージョン ワークスペースは、以前のより制限の多いタイプのコンバージョン ワークスペースです。移行に以前のタイプのコンバージョン ワークスペースを使用することはおすすめしません。以前のコンバージョン ワークスペースを使用する必要がある場合は、以前のコンバージョン ワークスペースを作成してスキーマを変換するセクションを開いて詳細を確認してください。

以前のコンバージョン ワークスペースを作成してスキーマを変換する

以前のコンバージョン ワークスペースでは、Ora2Pg 構成ファイルが使用されます。以前のコンバージョン ワークスペースを作成する前に、まず Database Migration Service の外部で Ora2Pg 構成を作成してください。詳細については、 以前のコンバージョン ワークスペースを使用するをご覧ください。

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

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

  2. [ワークスペースを設定] をクリックします。
  3. [コンバージョン ワークスペースを作成] ページで、次の操作を行います。
    1. 変換ワークスペースの名前、識別子、リージョンを入力します。
    2. [移行元データベース エンジン] プルダウン メニューから [Oracle] を選択します。
    3. [移行先データベース エンジン] で [AlloyDB for PostgreSQL] を選択します。
    4. [ワークスペース構成をカスタマイズする] セクションを開き、[以前のコンバージョン ワークスペースを有効にする] チェックボックスをオンにします。
    5. [ワークスペースを作成して続行] をクリックします。
  4. [ソースに接続してオブジェクトを変換する] ページで、次の操作を行います。
    1. [ソース接続プロファイル] プルダウン メニューから、移行元データベースの接続プロファイルを選択します。

    2. [構成ファイル] ボックスで [参照] をクリックし、システム ファイル選択ツールを使用して変換マッピング ファイルを選択します。

      [ファイルを追加] をクリックすると、複数のコンバージョン マッピング ファイルをアップロードできます。

    3. [構成を変換する] セクションで、[スキーマを pull して変換] をクリックします。

      Database Migration Service が移行元データベースに接続し、スキーマを取得して、変換マッピング ファイルで定義されたルールに従って移行先 SQL スキーマに変換します。この処理には数分かかることがあります。

  5. [保存して閉じる] をクリックします。

    コンバージョン ワークスペースの詳細ページが開きます。

変換されたスキーマを移行先データベースに適用できるようになりました。移行元データベースに主キーのないテーブルが含まれている場合は、変換されたスキーマを適用した後、移行先データベースの変換されたテーブルに主キー制約を手動で作成する必要があります。詳細については、 以前のコンバージョン ワークスペースを使用するをご覧ください。

次のステップ

コンバージョン ワークスペースを使用して、変換の問題を修正し、インタラクティブ エディタでオブジェクトを変更して、変換後のスキーマを移行先のデータベースに適用できます。 Oracle のコードとスキーマを PostgreSQL の構文に変換するをご覧ください。