移行ジョブの管理
Oracle Cloud Infrastructure Database Migrationで、移行ジョブとは、ソース・データベースからターゲット・データベースにデータを移動するプロセスです。ジョブを実行する前に移行について検証事前チェックを実行して、適切に構成されていることを確認します。ジョブはいくつかの操作を使用して管理できます。
移行の検証 🔗
Oracle Cloud Infrastructure Database Migrationで移行リソースを使用してジョブを実行する前に、移行リソースを検証する必要があります。
検証ジョブ中にクラウド移行前アドバイザ・ツール(CPAT)の実行を有効にした場合、CPATレポートおよび失敗したチェックの詳細は、「ジョブの詳細」ページに表示されます。詳細は、検証オプションの構成および対話型検証移行前アドバイザ・レポートの確認を参照してください。
対話型検証移行前アドバイザ・レポートの確認 🔗
データベース移行では、クラウド移行前アドバイザ・ツール(CPAT)との統合を含む対話型検証レポートが提供されます。CPATを使用すると、データベース移行は移行ジョブ中にソース・データベースを分析し、指定したOracle Cloudターゲットに基づいて問題のあるデータベース機能および構成についてアドバイスします。CPATはデフォルトで実行され、次の機能と利点があります:
-
データベースで使用されている、ターゲット環境でサポートされていない機能について警告します
-
Data Pumpのエクスポートおよびインポート操作に使用する修正変更またはパラメータ(あるいはその両方)の提案を行います
-
ソース・データベースに対して実行できるチェックに失敗した場合の修正スクリプトを生成します
検証ジョブの実行後、ジョブ出力には、実行されたチェック、問題の説明および問題を解決するために実行できるアクションが表示されます。
CPATの結果を表示またはダウンロードするには
-
移行リソースの詳細ページで、「ジョブ」、ジョブ名、「フェーズ」の順にクリックします。
-
「移行前アドバイザの検証」フェーズ名をクリックして、検証移行前アドバイザの詳細ページを開きます。
このページから、CPATレポートのダウンロード、レポート統計の表示、および「チェック」リストのドリルダウンを行うことができます。
チェック・リスト操作
フィルタ: 左側の「フィルタ」チェックボックスを使用して、リストされたチェックをフィルタできます。
個々のチェックのドリルダウン: リストのチェック名をクリックすると、CPATレポートからそのチェックの詳細が表示されます。
チェック詳細
「チェック詳細の表示」パネルには、次が表示されます
-
表示されている結果の原因となった問題、移行への潜在的な影響、問題を軽減するために実行できるアクション、該当する場合はソース・データベースで実行できる修正スクリプトの場所など、チェックに関する情報。
-
「確認済」インジケータ。このインジケータを使用すると、チェックを実行するタスクを完了したかどうかにかかわらず「移行前アドバイザの検証」リストに表示されるように、チェックを「確認済」としてマークできます。
チェック詳細のリンクをクリックして、「いいえ」または「はい」の値に変更します。このインジケータは、チェックの処理方法に影響を与えません。利便性のために使用できます。
-
チェックで問題ありのフラグが付けられたオブジェクトのリスト。
一部のチェックではオブジェクトの読取り専用リストが表示され、一部のチェックではリストされたオブジェクトを対話形式で更新できます。
修正スクリプトの実行
修正スクリプトの場所は、個々のチェックの「チェック詳細の表示」パネルに表示されます。
「修正スクリプトの場所」は、ソース・データベース上のスクリプトの場所を指定します。
ソース・データベースに対して修正スクリプトを実行するには、sys管理権限が必要です。
マルチテナント・アーキテクチャでは、CDBで修正スクリプトを実行する必要があります。PDBで実行すると、エラーが発生します。
問題のあるオブジェクトの除外
検証の実行後、「チェック詳細の表示」ペインにリストされているすべてのオブジェクトの「除外」列に「いいえ」が表示されます。
次の検証実行からオブジェクトを除外するには、リスト内のオブジェクトの横にあるボックスを選択して「選択項目を除外」をクリックするか、「すべて除外」を選択してチェックにリストされたすべてのオブジェクトを除外できます。
除外するオブジェクトを選択すると、「除外」列に「はい」が表示されます。「はい」とマークされたオブジェクトは、次の検証実行ではCPATによって無視され、次回検証を実行するときに「オブジェクト」リストに表示されません。
この変更を反映するために、移行の「選択したオブジェクト」構成も更新されます。「移行の詳細」ページの「選択したオブジェクト」に、除外ルールを含む新しい行が表示されます。このオブジェクトを再度含める場合は、「選択したオブジェクト」リストでルールを削除する必要があります。
「すべて除外」では、表示されているページのすべてのオブジェクトに加えて、表示されていないページのオブジェクトも除外されます。ただし、チェックボックス列の最初のボックスを選択して「すべて除外」をクリックすると、現在のページにリストされているオブジェクトのみが除外されます。
表を除外しても、CPAT分析からは除外されません。スキーマ全体が除外されている場合は、CPATからスキーマを除外できます。Oracle Cloudでサポートされていない表が存在すると、CPATレポートでブロッカ・ステータスが発生する可能性があります。
オブジェクトの明示的な包含および除外の詳細は、Oracle移行でのオブジェクトの選択を参照してください。
ジョブの一時停止と再開 🔗
移行ジョブを開始するときに、指定したフェーズで一時停止するようにジョブを構成できます。その後、準備ができたときにジョブを再開できます。
移行ジョブを開始すると、確認ダイアログが開きます。「次の後にユーザー入力が必要」でフェーズを選択することで、任意の時点で一時停止するようにジョブを構成できます。
一時停止するように選択したフェーズが完了すると、ジョブは、再開(または終了)するまで「待機中」状態になります。
「レプリケーション・ラグのモニター」フェーズの後で一時停止した場合、「待機中」状態の間、トランザクション・レプリケーションは継続します。これは再開時に停止します。
中断していたところからジョブを開始するには、次のいずれかを行います:
-
移行の詳細ページの「ジョブ」表で、再開しようとするジョブの「アクション」(3つのドット)メニューで「再開」を選択します。
-
ジョブの詳細ページで「再開」をクリックします。
この時点で、完了後にジョブを一時停止する別のフェーズを選択できます。
ジョブ詳細の表示 🔗
移行の詳細ページでは、Oracle Cloud Infrastructure Database Migrationで移行リソースが実行したジョブのリストを表示できます。これには次の情報が含まれます:
-
名前: ジョブの名前
-
状態: ジョブ・リソースの状態。次のいずれかになります:
-
受入れ済: ジョブは実行待ちです。
-
進行中: 検証ジョブまたは移行ジョブが現在実行中です。
-
不明: ステータスを取得できず、データベース移行はリカバリの続行を待機しています。必要なアクションはありません。
-
終了済: 「取消済」と同様に、到達できません。
-
失敗: 検証ジョブの場合、事前チェックは失敗し、ユーザー・アクションは必要ありません。移行ジョブの場合、ジョブは失敗し、ユーザー・アクション(ジョブの中止または再開)を待機しています。
-
成功: ジョブは正常に完了しました。
-
待機中: 移行ジョブが一時停止され、ユーザー入力を待機しています。
-
取消中: 移行ジョブは中断アクションの後に停止処理中です。
-
取消済: 移行ジョブは中断アクションの後に停止しました。ジョブがこの状態になったら、移行リソースで新しいジョブを実行できます。
-
-
タイプ: 「移行」または「評価」
-
ステータス詳細: 状態に関する追加の詳細を含むサポート・メッセージが表示されます。
たとえば、検証ジョブが失敗し、「状態」が「失敗」の場合、「ステータス詳細」は、ジョブが失敗し、データベース移行がジョブを自動的に終了したことを示します。
「不明」状態が表示された場合、「ステータス詳細」は、データベース移行でジョブの最新のステータスを取得できず、停止時間のリカバリを待機していることを示します。
-
作成日: ジョブが作成された時点のタイムスタンプ
「ジョブ」表からジョブを選択して詳細を表示します。
ジョブの詳細ページで、次のようなジョブ情報を確認できます:
-
OCID: リソースの一意のOracle Cloud ID
-
作成日: 移行が作成された日時
「ジョブ情報」ボックスの下に、メトリック(データベース移行メトリックを参照)、フェーズ(データベース移行ジョブ・フェーズを参照)、サポートされないオブジェクトなど、ジョブに関連付けられたリソースに関する情報が表示されます。
オンラインOracle移行のパラメータ・ファイルの表示 🔗
GoldenGateサービス統合を使用した移行ジョブの失敗が原因でオンライン移行が「注意が必要」状態になった場合は、ExtractおよびReplicatのパラメータ・ファイルを表示および編集してから、オンラインOracle移行を再開することを選択できます。
この機能は、組込みのGoldenGateを使用する場合にのみ適用されます。
ジョブ詳細 - フェーズ
オンライン移行のレプリケーションを設定するためにGoldenGateプロセス(Extract、Replicat)パラメータ・ファイルが作成されている場合は、それらを表示できます。移行リソースの詳細ページで、「ジョブ」、ジョブ名、「フェーズ」をクリックして、失敗したジョブのフェーズを確認できます。
「パラメータ・ファイルの表示」オプションをクリックして、現在のレプリケーション(Extract、Replicat)パラメータ・ファイルを表示します。
オンライン移行のレプリケーション設定の現在の状態に応じて、ExtractとReplicatの両方のパラメータ・ファイルを表示できる場合とできない場合があります。パラメータ・ファイルは、「準備」フェーズの終了中または終了後に表示できます。パラメータ・ファイルが作成されていない場合は、表示できません。同様に、レプリケーション・ターゲットの準備・フェーズ中または後にReplicatパラメータ・ファイルを表示できます。
- タイプや作成詳細などの詳細。
- 「パラメータ・ファイルの表示」をクリックして、ExtractファイルまたはReplicatファイルを読取り専用モードで表示します。
この機能は、GoldenGate ExtractまたはReplicatが使用可能な場合にのみファイルが表示される一部のフェーズにのみ適用されます。
パラメータ・ファイルの変更後、この失敗状態のオンライン移行を再開します。
オンラインOracle移行のパラメータ・ファイルの編集 🔗
GoldenGateサービス統合を使用して、移行ジョブが失敗したためにオンライン移行ジョブが「注意が必要」状態になった場合、ExtractおよびReplicatパラメータ・ファイルを表示および編集し、オンラインOracle移行を再開することを選択できます。
レプリケーション・プロセスが「アクティブ」の場合、Extract/Replicatパラメータ・ファイルのみを表示できます。各プロセスのExtract/Replicatがその時点でアクティブではなく、「注意が必要」状態の場合にのみ編集できます。
- オンライン移行のレプリケーション設定に属する現在のExtractまたはReplicatパラメータ・ファイルを表示および編集できます。
- レプリケーション・パラメータ・ファイルに対して実行するすべての更新は、便宜上バージョニングされます。
- ExtractまたはReplicatのパラメータ・ファイルで編集するたびに、元の出荷時のデフォルト・バージョンが常に保持され、参照用に元に戻されます。
- ExtractまたはReplicatのいずれかのパラメータ・ファイルを編集すると、保存後すぐにレプリケーション設定に適用されます。
- 失敗したプロセスから、ファイルの保存後に移行を再開できます。
ジョブ詳細 - フェーズ
移行リソースの詳細ページで、「ジョブ」、ジョブ名、「フェーズ」の順にクリックすると、失敗したジョブのフェーズを確認できます。
パラメータは、GoldenGateプロセスのフェーズおよび現在の状態(ExtractまたはReplicat)に応じて編集できます。
「パラメータ・ファイル」パネルには、現在使用中のパラメータ・ファイルが表示されます。
- タイプや作成詳細などの詳細。
- 「パラメータ・ファイルの編集」をクリックして、ExtractまたはReplicatファイルを編集します。
- フリーフォーム・エディタを使用してパラメータ・ファイルを編集します。
- 無効なパラメータ・ファイルの編集を実行した場合、GoldenGateは、画面に表示されるエラーで編集を拒否します。
- 「新規として保存して最新にする」オプションをクリックして、この新しいバージョンのファイルを保存し、「すべてのファイルを表示」オプションで使用可能なリストからアクセスします。新しいバージョンが保存され、GoldenGateに適用され、「使用中」としてマークされます。
- 編集したファイルを保存しない場合は、「取消」をクリックします。
- これらの2つの編集済バージョンまたは元の(ファクトリ)パラメータ・ファイルのいずれかを切り替えることができます。
- 元の(ファクトリ)パラメータ・ファイルは、Oracleによって提供されます。
- アクション・メニュー(3つのドット)から、「編集して現在のものにする」を選択してファイルを切り替えます。ファイルを表示、編集および保存したり、ファイルを表示および保存できます。
- ファクトリ(元の)パラメータ・ファイルに切り替えることができます。
- Oracleが提供する元の(ファクトリ)パラメータ・ファイルは削除されず、必要に応じて使用できます。
この機能は、「準備」、「レプリケーション・ターゲットの準備」、「レプリケーション・ラグのモニター」、「スイッチオーバー」などの一部のフェーズにのみ適用できます。このファイルは、GoldenGate ExtractまたはReplicatが使用可能な場合にのみ表示されます。
パラメータ・ファイルの変更後、この失敗状態のオンライン移行を再開します。
ジョブ・ステータスのモニタリング 🔗
Oracle Cloud Infrastructure Database Migrationには、移行ジョブのステータスを様々なレベルでモニターできるコンソール内の様々な場所があります。
「ジョブ詳細」ページ
移行の詳細ページでは、「ジョブ」をクリックすると、そのリソースを使用して実行されたジョブに関する情報を表示できます。
「ログのダウンロード」をクリックすると、データベース移行サービスによって生成されたログを表示できます。
ジョブ情報の詳細の下で、「メトリック」、「フェーズ」および「サポートされないオブジェクト」をクリックして、移行ジョブの詳細を取得できます。
ジョブ詳細 - フェーズ
移行リソースの詳細ページで、「ジョブ」、ジョブ名、「フェーズ」の順にクリックすると、そのジョブのフェーズのうち、完了したもの、保留中のもの、現在実行中のもの(ラベルが「開始済」)を確認できます。
表示するエラーまたは警告テキスト(またはログ)があるフェーズの場合、フェーズ名はクリック可能なハイパーリンクとして表示され、フェーズのアクション・アイテム・メニューには「詳細の表示」が含まれます。フェーズ名のリンクまたは「詳細の表示」アクションをクリックすると、「フェーズ詳細の表示」パネルが開き、エラーまたは警告の詳細が表示されます
- 名前: フェーズの名前
- ステータス: フェーズのステータス。失敗ステータスは、ジョブが失敗したことを通知します。
- 期間: エラーが発生した時点までのフェーズの開始から経過した時間。
- 問題: ジョブ失敗の原因となった問題。
- アクション: エラーを解決するために実行できるアクション。
- エラー・メッセージ: ジョブ失敗の原因となった検証エラーまたは移行エラー。
「ログのダウンロード」では、Data Pumpログをダウンロードします。「初期ロードのエクスポート」および「初期ロードのインポート」フェーズで、移行モードで実行されるジョブに適用されます。
「移行前アドバイザの検証」フェーズは特殊なケースです。このリンクによって検証移行前アドバイザの詳細ページが開き、そこからクラウド移行前アドバイザ・ツール(CPAT)レポートのダウンロード、CPATレポート統計の表示、「チェック」リストのドリルダウンを行うことができます。
CPATレポートおよび対話型の詳細ページの詳細は、対話型検証移行前アドバイザ・レポートの確認を参照してください。
移行ワークフロー・フェーズの詳細は、データベース移行のジョブ・フェーズを参照してください。
メトリックの詳細は、データベース移行メトリックを参照してください。
アプリケーションのスイッチオーバーの準備 🔗
次の手順を実行すると、読取り/書込みアプリケーションのスイッチオーバー中のデータ損失がゼロになります:
論理移行ワークフローの間にソース・データベースとターゲット・データベースの両方が読取り/書込みで開かれます。次の条件が適用されます。
-
読取り専用アプリケーションの場合、GoldenGate Replicatが未処理ソース・トランザクションをすべて適用した後、すぐにスイッチオーバーを実行できます。これにより、それらのサービスではアプリケーションの停止時間をゼロにすることができます。
-
読取り/書込みアプリケーションで確実にデータ損失をゼロにするには、アプリケーションをスイッチオーバーする前に、すべてのトランザクションがターゲットに適用されていることを確認する必要があります。
アプリケーションが読み書き可能な場合、確実にデータ損失をゼロにするには、次の手順を実行する必要があります:
-
フェーズ
ODMS_MONITOR_REPLICATION_LAG
の後に移行ジョブを一時停止します。このフェーズでは、ターゲット・データベースでReplicatが停止するまでOracle GoldenGate ExtractおよびReplicatの操作がモニターされます。エンドツーエンド(E2E)のレプリケーション遅延は30秒未満である必要があります。
-
フェーズ
ODMS_MONITOR_REPLICATION_LAG
が完了し、移行ジョブが一時停止されたら、ソース・データベース上のワークロードを停止します(ダウンタイムの開始)。 -
移行ジョブを再開し、フェーズ
ODMS_SWITCHOVER
の後に別の一時停止をスケジュールします。このフェーズでは、次の処理が実行されます:
-
レプリケーションのE2Eラグがまだ30秒未満であることを確認します
-
ソース・データベース上の未処理トランザクションがExtractで取得されていることを確認します
-
Extractを停止します
-
残りすべての証跡ファイル・データがReplicatによって適用されたことを確認します
-
Replicatを停止します
-
-
フェーズ
ODMS_SWITCHOVER
が完了したら、ターゲット・データベースでワークロードを開始できます(ダウンタイムの終了)。
ジョブの終了 🔗
移行ジョブを終了できるのは、実行中または一時停止中です。
-
移行の詳細ページのジョブのリストで、削除しようとするジョブの「アクション」(3つのドット)メニューで「中断」を選択します。
ジョブの詳細ページで「中断」をクリックすることもできます。
-
「ジョブの中断」ダイアログで、「中断」をクリックします。
ジョブのタグの管理 🔗
タグは、テナンシ内でリソースを探すために役立ちます。Oracle Cloud Infrastructure Database Migrationでは、移行ジョブのタグの追加や表示は、「移行の詳細」ページおよび「ジョブの詳細」ページで行うことができます。
移行の詳細ページで、ページの左側にある「リソース」の下で「ジョブ」を選択します。
「ジョブ」表で、ジョブの「アクション」(3つのドット)メニューから、「タグの追加」または「タグの表示」を選択します。
ジョブの詳細ページで、「ジョブ情報」ボックスの上で「タグの追加」を選択するか、「タグ」タブをクリックしてタグの表示や編集を行うことができます。
タグ付けの詳細は、タグおよびタグ・ネームスペースの管理を参照してください。
ジョブAPIの使用 🔗
移行ジョブの管理には、次の操作を使用できます:
- EvaluateMigration
- StartMigration
- GetJob
- UpdateJob
- DeleteJob
- ResumeJob
- AbortJob
- GetJobOutputConten
- ListJobs
- ListJobOutputs
APIの使用およびリクエストの署名の詳細は、REST APIおよびセキュリティ資格証明を参照してください。SDKの詳細は、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。