このページでは、コンバージョン ワークスペースを作成し、それを使用して Oracle から PostgreSQL への決定論的なコードとスキーマの変換をすぐに実行する方法について説明します。ワークスペースを作成する前に、 移行元データベースの接続プロファイルを作成してください。
必要なロール
コンバージョン ワークスペースを作成するために必要な権限を取得するには、
プロジェクトに対する
Database Migration 管理者（roles/datamigration.admin）
IAM ロールを付与するよう管理者に依頼してください。
ロールの付与の詳細については、Identity and Access Management ドキュメントの アクセス権の管理をご覧ください。
この事前定義ロールには、Database Migration Service でコンバージョン ワークスペースを作成するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限 」セクションを開いてご確認ください。
必要な権限
Database Migration Service でコンバージョン ワークスペースを作成するには、次の権限が必要です。
cloudaicompanion.entitlements.getこの権限は
roles/datamigration.adminロールに含まれています。 Gemini 拡張変換機能に必要です。datamigration.conversionworkspaces.applydatamigration.conversionworkspaces.commitdatamigration.conversionworkspaces.convertdatamigration.conversionworkspaces.createdatamigration.conversionworkspaces.deletedatamigration.conversionworkspaces.getdatamigration.conversionworkspaces.getIamPolicydatamigration.conversionworkspaces.listdatamigration.conversionworkspaces.rollbackdatamigration.conversionworkspaces.seeddatamigration.conversionworkspaces.setIamPolicydatamigration.conversionworkspaces.update
カスタムロールや他の 事前定義ロールを使用して、これらの権限を取得することもできます。
組み込みエディタを備えたワークスペース
インタラクティブなコンバージョン ワークスペースを作成してスキーマ変換を行うには、次の操作を行います。
- コンソール Google Cloud で [**コンバージョン ワークスペース**] に移動します。
- [ワークスペースを設定] をクリックします。
- [コンバージョン ワークスペースを作成] ページで、次の操作を行います。
- コンバージョン ワークスペースの名前、識別子、リージョンを入力します。
- [移行元データベース エンジン] プルダウン メニューから [Oracle] を選択します。
- [移行先データベース エンジン] で [Cloud SQL for PostgreSQL] を選択します。
-
[ワークスペースの Gemini 設定を有効にする] セクションで、チェックボックスを使用して Gemini を活用した 変換機能を有効にします。これらの機能は、後で Gemini のサポートでコードとスキーマを変換する場合に有効にすることもできます。
Gemini を活用した変換機能には、 Gemini for Google Cloud API が必要です。詳細については、 Gemini を活用した変換機能をご覧ください。
- [ワークスペースを作成して続行] をクリックします。
- [ソースの定義とスキーマ スナップショットの pull] ページで、次の操作を行います。
- [ソース接続プロファイル] プルダウン メニューから、移行元データベースの接続プロファイルを選択します。
- [スキーマのスナップショットを pull して続行] をクリックします。
Database Migration Service が移行元データベースに接続してスキーマを取得します。 この処理には数分かかることがあります。
- [オブジェクトを選択して変換] ページで、チェックボックスを使用して、PostgreSQL 構文に変換するオブジェクトを選択します。
すべてのオブジェクトを一度に変換する必要はありません。代わりに、少数のオブジェクトを選択して、 後で変換に追加できます。
- [変換して続行] をクリックします。
コンバージョン ワークスペースが開きます。
- 新しいワークスペースを初めて開くときに、Gemini を活用した自動変換機能にアクセスできるようにアップグレードできます。
次の操作を行います。
- [**Gemini 自動変換の概要**] ダイアログで、[**ワークスペースをアップグレードして新しいエクスペリエンスを試す**] チェックボックスをオンにして、[**続行**] をクリックします。
- [Gemini でソース オブジェクトを変換しますか？] ダイアログで [変換] をクリックします。
Database Migration Service は、決定論的な変換結果に Gemini を活用した変換機能の拡張機能を適用するために、 変換プロセスを再度実行します。 Gemini 自動変換機能の詳細については、 Gemini 自動変換をご覧ください。
以前のコンバージョン ワークスペース
以前のコンバージョン ワークスペースは、古いタイプのコンバージョン ワークスペースであり、機能が制限されています。移行に以前のタイプのコンバージョン ワークスペースを使用することはおすすめしません。以前のコンバージョン ワークスペースを使用する必要がある場合は、[以前のコンバージョン ワークスペースを作成してスキーマを変換する] セクションを開いて詳細をご確認ください。
以前のコンバージョン ワークスペースを作成してスキーマを変換する
以前のコンバージョン ワークスペースでは、Ora2Pg 構成ファイルを使用します。 以前のコンバージョンワークスペースを作成する前に、Database Migration Service の外部で Ora2Pg 構成を作成してください。 詳細については、 以前のコンバージョン ワークスペースを使用するをご覧ください。
- コンソール Google Cloud で [**コンバージョン ワークスペース**] に移動します。
- [ワークスペースを設定] をクリックします。
- [コンバージョン ワークスペースを作成] ページで、次の操作を行います。
- コンバージョン ワークスペースの名前、識別子、リージョンを入力します。
- [移行元データベース エンジン] プルダウン メニューから [Oracle] を選択します。
- [移行先データベース エンジン] で [Cloud SQL for PostgreSQL] を選択します。
- [ワークスペース構成をカスタマイズ] セクションを開き、 [以前のコンバージョン ワークスペースを有効にする] チェックボックスをオンにします。
- [ワークスペースを作成して続行] をクリックします。
- [ソースに接続してオブジェクトを変換する] ページで、次の操作を行います。
- [ソース接続プロファイル] プルダウン メニューから、移行元データベースの接続プロファイルを選択します。
-
[**構成ファイル**] ボックスで [**参照**] をクリックし、システムのファイル選択ツールを使用して変換マッピング ファイルを選択します。
[**ファイルを追加**] をクリックすると、複数の変換マッピング ファイルをアップロードできます。
-
[構成を変換] セクションで、 [スキーマを pull して変換] をクリックします。
Database Migration Service が移行元データベースに接続し、 スキーマを取得して、変換マッピング ファイルで定義されたルールに従って移行先の SQL スキーマに変換します。 この処理には数分かかることがあります。
- [保存して閉じる] をクリックします。
コンバージョン ワークスペースの詳細ページが開きます。
変換後のスキーマを移行先データベースに適用できるようになりました。移行元データベースに主キーのないテーブルが含まれている場合は、変換後のスキーマを適用した後、移行先データベースの変換後のテーブルに主キー制約を手動で作成する必要があります。詳細については、 以前のコンバージョンワークスペースを使用するをご覧ください。
次のステップ
コンバージョン ワークスペースを使用して、変換の問題を修正したり、インタラクティブ エディタでオブジェクトを変更したり、変換後のスキーマを移行先データベースに適用したりできます。Oracle のコードとスキーマを PostgreSQL 構文に変換するをご覧ください。