このページでは、コンバージョン ワークスペースを設定する方法について説明します。コンバージョン ワークスペースを作成する前に、次のことを行ってください。
- 移行元の Oracle データベースの接続プロファイルを作成します。詳細については、Oracle 接続プロファイルを作成するをご覧ください。
- 省略可: 以前のコンバージョン ワークスペースを使用する場合は、Ora2Pg 構成ファイルを準備します。 Ora2Pg を構成するをご覧ください。
コンバージョン ワークスペースでは、移行元のデータベースのスキーマとオブジェクトを、移行先のデータベースと互換性のある形式に変換できます。この変換により、Database Migration Service は移行元と移行先のデータベース間でデータを移行できます。
コンバージョン ワークスペースは [コンバージョン ワークスペース] ページで確認、変更できます。また、移行ジョブ間で再利用できます。
コンバージョン ワークスペースを設定する手順は次のとおりです。
- コンバージョン ワークスペースの設定を定義します。
- ソース データベースに接続し、ソース オブジェクトを Database Migration Service に pull します。
ソースのコンバージョンを実行します。
エディタが組み込まれたコンバージョン ワークスペースの場合: コンバージョン ワークスペースに組み込まれているエディタを使用します。このエディタは、コンバージョン結果を変換、表示、変更できるライブ エディタ スペースです。
以前のワークスペースの場合: Ora2Pg を使用してスキーマを変換する
変換されたスキーマを移行先データベースに適用する: Database Migration Service は、変換された SQL を使用して、移行先データベースに必要なエンティティをすべて作成します。これにより、移行されたデータがデータベースに正しく読み込まれるようになります。
コンバージョン ワークスペースの設定を定義する
Google Cloud コンソールの [コンバージョン ワークスペース] ページに移動します。
[ワークスペースをセットアップ] をクリックし、ダイアログ ウィンドウで次のいずれかを選択します。
組み込みのコンバージョン エディタで新しいコンバージョン ワークスペースを使用する場合は、[新しいワークスペースをセットアップ] をクリックします。
または
Ora2Pg 変換ツールで以前のワークスペースを使用する場合は、[以前のワークスペースを設定] をクリックします。
次の表を参照して、[コンバージョン ワークスペースを作成する] ページの [コンバージョン ワークスペースを作成する] パネルのフィールドに入力します。
フィールド 説明 コンバージョン ワークスペース名 コンバージョン ワークスペースの表示名を入力します。これは、移行ジョブを作成するときや、コンバージョン ワークスペースのリストで移行ジョブを探すときに、ワークスペースを識別するために使用されます。 コンバージョン ワークスペース ID このフィールドは、入力したコンバージョン ワークスペース名に基づいて Database Migration Service が自動的に入力します。自動生成された ID を保持することも、変更することもできます。 リージョン コンバージョン ワークスペースが保存されるリージョンを選択します。接続プロファイルと移行ジョブで使用できるのは、同じリージョンに保存されているコンバージョン ワークスペースのみです。リージョンの選択は、コンバージョン ワークスペースがソースに接続できるかどうかには影響しませんが、リージョンでダウンタイムが発生した場合の宛先への接続と可用性に影響する可能性があります。この選択は永続的であり、変更できません。 移行元データベース エンジン [Oracle] が自動的に選択されます。 移行先データベース エンジン 宛先データベース エンジンを選択します。 [コンバージョン ワークスペースを作成する] セクションに表示されている前提条件を確認します。これらは、この移行パスの準備に必要なものを確認するために、Database Migration Service によって自動的に生成されます。前提条件には、次の方法に関する情報が含まれます。
コンバージョン ワークスペースが移行元の Oracle データベースからデータを取得できるように移行元の Oracle データベースを構成する
この手順でこれらの前提条件を完了することをおすすめしますが、コンバージョン ワークスペースの作成が完了する前であればいつでも完了できます。
[Create workspace and continue] をクリックします。
ソースに接続してオブジェクトを変換する
ソーススキーマ オブジェクトの変換パスは、使用する変換ワークスペースによって異なります。
エディタが組み込まれたワークスペース
[ソース接続プロファイル] プルダウン リストから移行元の接続プロファイルを選択します。
[テストを実行] をクリックして、Database Migration Service がソースと通信できることを確認します。
テストに失敗した場合は、プロセスのどの部分に問題があったかが示されます。必要な変更を行った後、再度テストできます。
問題のあるフローの部分に移動して問題を修正し、再度テストします。
[スキーマを pull して続行] をクリックします。
Database Migration Service が移行元データベースに接続して、スキーマとコード情報をダウンロードします。このオペレーションは、ネットワーク接続やデータベースのサイズなどの要因によっては数分かかることがあります。
Database Migration Service がソース情報の取得を完了すると、インターフェースが [オブジェクトの選択と変換] セクションに自動的に切り替わります。
[オブジェクトを選択して変換] で、移行元のスキーマを使用して、Database Migration Service が移行先データベースの SQL エンジンと互換性のあるスキーマとコードに変換するすべてのエンティティを選択します。
この選択は永続的ではありません。後で、コンバージョン エディタ内で直接オブジェクトを追加または削除できます。これにより、コンバージョン プロセスを柔軟に操作し、重視するオブジェクトのみを操作できます。
この時点では、次の 2 つのいずれかの操作を行うことができます。
[保存して次へ] をクリックします。
Database Migration Service によってコンバージョン ワークスペースが作成されます。エディタ空間を表示してワークスペースの設定を編集することはできますが、スキーマとコードはまだ変換されていません。移行ジョブを実行する前に、変換を実行して移行先データベースのスキーマとコードを準備する必要があります。
[ソースを変換] に進みます。
[変換して続行] をクリックします。
Database Migration Service は、変換ワークスペースを作成し、初期のスキーマとコードの変換を実行します。コンバージョン ワークスペース エディタで、自動生成された SQL をプレビューできるようになりました。
コンバージョンの問題を確認するに進みます。
以前のワークスペース
[ソース接続プロファイル] プルダウン リストから移行元の接続プロファイルを選択します。
省略可。[詳細を表示] をクリックすると、接続プロファイルの詳細が表示されます。
[テストを実行] をクリックして、Database Migration Service がソースと通信できることを確認します。
テストに失敗した場合は、プロセスのどの部分に問題があったかが示されます。必要な変更を行った後、再度テストできます。
問題のあるフローの部分に移動して問題を修正し、再度テストを行います。
[参照] をクリックして、構成した Ora2Pg 構成ファイルを選択してアップロードします。
省略可。追加の Ora2Pg 構成ファイルをアップロードするには、[ファイルを追加] をクリックします。
[スキーマを取得して変換] をクリックして、Database Migration Service が指定された Ora2Pg 構成を使用してデータを移行できることを確認します。モニタリング対象には以下が含まれます。
ソース データベースへの接続
移行元データベースからスキーマとコードを取得する
移行元データベースと移行先データベース間のテーブル マッピングを作成する
移行元データベースのスキーマとコードを、移行先データベースのダイアレクトと互換性のあるダイアレクトに変換する
テストが失敗した場合:
すべての Ora2Pg 構成ファイルを修正します。
更新された DDL を移行先の Cloud SQL for PostgreSQL インスタンスに再適用します。
[スキーマを pull して再度変換する] をクリックします。
[保存して閉じる] をクリックします。
ダイアログ ボックスで [保存して閉じる] をクリックします。