このトピックでは、データ移行タスク作成後のフォローアップ操作について説明します。
移行レポートの表示
移行レポートには、成功したファイル、失敗したファイル、スキップされたファイルのリストを含む、移行結果に関する詳細情報が記載されています。レポートは、移行タスクの実行ステータスを理解するのに役立ちます。
レポートファイルの種類
タスク実行ステータスに基づいて、3種類の移行レポートファイルが生成されます。すべての移行済みファイルのリスト、失敗したファイルのリスト、スキップされたファイルのリストです。
移行レポートファイルの命名規則
uid@jobid@runtimeid_total_list_n は、すべての移行済みファイルのリストを表します。複数のファイルが存在する可能性があり、n は 0 以上の整数です。
uid@jobid@runtimeid_failed_list_n は、失敗したファイルのリストを表します。複数のファイルが存在する可能性があり、n は 0 以上の整数です。
uid@jobid@runtimeid_skipped_list_n は、スキップされたファイルのリストを表します。複数のファイルが存在する可能性があり、n は 0 以上の整数です。
レポートフィールドの説明
移行レポートファイルのフィールドは、ソースから宛先への移行中にファイルのさまざまなプロパティを記述します。フィールドには次のものが含まれます。
フィールド名 | 説明 |
ソースファイル名 | URLエンコードされたソースファイルの名前。 |
宛先ファイル名 | URLエンコードされたオブジェクトファイルの名前。 |
ソースファイルサイズ | ソースファイルのサイズ。 |
宛先ファイルサイズ | オブジェクトファイルのサイズ。 |
ソースファイル MD5 | ソースファイルの MD5 ハッシュ。このフィールドは、ソースファイルが MD5 ハッシュを返す場合にのみ存在します。 |
宛先ファイル MD5 | オブジェクトファイルの MD5 ハッシュ。 |
ソースファイル CRC-64 | ソースファイルの CRC-64 ハッシュ。このフィールドは、ソースファイルが CRC-64 ハッシュを返す場合にのみ存在します。 |
宛先ファイル CRC-64 | オブジェクトファイルの CRC-64 ハッシュ。 |
ソースファイルの最終更新時刻 | ソースファイルの最終更新時刻。 |
宛先ファイルの最終更新時刻 | オブジェクトファイルの最終更新時刻。 |
ソースオブジェクトバージョンID (マルチバージョン移行の場合のみ) | このフィールドは、マルチバージョン移行でのみ、ソースオブジェクトのバージョンIDを示すために使用されます。 |
宛先オブジェクトバージョンID (マルチバージョン移行の場合のみ) | このフィールドは、マルチバージョン移行でのみ、宛先オブジェクトのバージョンIDを示すために使用されます。 |
移行開始時刻 | ファイルの移行が開始された時刻。 |
移行終了時刻 | ファイルの移行が終了した時刻。 |
異常な移行 (false:正常、true:異常) | 移行が異常であったかどうかを示すブール値フラグです。`false` は正常、`true` は異常を意味します。 |
異常の理由 | 異常の理由の説明。 |
移行レポートの取得
Data Online Migration コンソールにログインします。
左側のナビゲーションウィンドウで、[データオンライン移行] > [移行タスク] を選択します。
移行タスク一覧で、管理するタスクを見つけ、[管理] をクリックして、その詳細ページを表示します。
タスクの作成時に [プッシュしない] を選択した場合は、タスク詳細ページに移動して [履歴] タブをクリックし、次に [移行レポートの生成] をクリックします。 レポートが生成されたら、[移行レポートのダウンロード] をクリックして、レポートをローカルマシンにダウンロードします。
タスクを作成する際に プッシュ を選択した場合は、タスクの詳細ページに移動し、[履歴] をクリックします。レポートが生成された後、[マイグレーションレポートのダウンロード] をクリックして、ローカルマシンにダウンロードします。
説明生成された移行レポートは、データ移行タスクが完了するまで不完全な場合があります。完全なレポートを取得するには、タスク完了後にダウンロードしてください。
移行レポートは参考用です。宛先での実際の移行コンテンツが最終バージョンです。
生成後、移行レポートは宛先 LocalFS の指定されたプレフィックスに保存されます。フォルダーディレクトリレベルのプレフィックス形式は、タスク実行によって異なり、次のとおりです。
LOCAL:/<prefix>/aliyun_import_report/<uid>/<jobid>/<runtimeid>/total_list/ LOCAL:/<prefix>/aliyun_import_report/<uid>/<jobid>/<runtimeid>/failed_list/ LOCAL:/<prefix>/aliyun_import_report/<uid>/<jobid>/<runtimeid>/skipped_list/パスパラメーターの説明
フィールド名
フィールドの意味
prefix
宛先データアドレスに指定された移行ディレクトリプレフィックス。
uid
Alibaba Cloud アカウントのID。
jobid
タスクID。タスク製品ページの [詳細] タブから取得します。
runtimeid
タスク実行レコードID。タスク製品ページの [履歴] タブから取得します。
宛先 LocalFS の指定されたプレフィックスにある移行レポートファイルを見つけて、詳細なファイルリストを表示します。
移行ログの表示
移行プロセスのログは Simple Log Service (SLS) にプッシュできます。これらのログには、成功、失敗、スキップされたファイルのレコードを含め、移行タスク中に各ファイルがどのように処理されたかが詳述されています。移行ログを使用することで、移行の進捗状況をリアルタイムでモニターし、問題のあるファイルを迅速に特定し、監査やトラブルシューティングを実行できます。
ログタイプ
データオンライン移行は、SLS に aliyun-oss-import-log-Alibaba Cloud アカウント ID-現在のコンソールリージョン という名前のプロジェクトを作成します。例:aliyun-oss-import-log-137918634953****-cn-hangzhou。このプロジェクトで移行タスクのログを表示します。プロジェクトには、次の 2 種類のログが含まれています:
drs_import_success_log:成功した移行ログ
drs_import_fail_log:失敗した移行ログ
ログフィールドの説明
次の表に、移行ログの主要なフィールドを説明します。
フィールド名 | フィールドの意味 |
JobName | 移行タスクの名前。 |
JobId | 移行タスク ID。 |
Region | コンソールが配置されているリージョン。 |
Status | 移行されたファイルのステータス。次の 3 つのステータスが含まれます:
|
UserId | ユーザーの UID。 |
ExecuteId | 実行レコード ID。 |
StartTime | 移行開始時刻。 |
EndTime | 移行終了時刻。 |
ListTime | ファイルがスキャンされた時刻。 |
Time | 現在の時刻。 |
SrcObjectName | ソースファイル名。Src で始まるフィールドはソースに関連しています。 ファイル名は URL エンコードされています。例:docs%2Fmy.docir%2Fexample.log。 |
SrcObjectSize | ソースファイルのサイズ。 |
DestObjectName | 宛先ファイル名。Dest で始まるフィールドは宛先に関連しています。 ファイル名は URL エンコードされています。例:docs%2Fmy.docir%2Fexample.log。 |
DestObjectSize | 宛先ファイルのサイズ。 |
移行ログの取得
移行ログをリアルタイムで Alibaba Cloud SLS にプッシュして、クエリと分析を行うことができます。SLS コンソールで、タスク ID やファイル名などのキーワードを使用して正確な検索を実行し、移行プロセスをモニターしたり、問題をトラブルシューティングしたりします。
移行タスクの作成時に [プッシュ] または [エラーログのみプッシュ] を選択して、ログプッシュ機能を有効にする必要があります。タスク作成時に [プッシュしない] を選択した場合、SLS でタスクのログを表示することはできません。
移行ログは完全性を保証するものではありません。移行の完全性を検証するために移行ログを使用しないでください。
移行ログは参照用です。最終的な移行結果は、宛先にある実際のファイルに基づきます。
プッシュしない (デフォルト):移行ログをプッシュしません。
プッシュ:移行ログを SLS にプッシュします。SLS で移行ログを表示します。
ファイルエラーログのみプッシュ:エラー移行ログのみを SLS にプッシュします。SLS でエラー移行ログを表示します。
[プッシュ] または [ファイルエラーログのみプッシュ] を選択する前に、次の操作を完了していることを確認してください。そうしないと、移行タスクが異常になる可能性があります:
SLS サービスをアクティベートしていること。
権限付与ページで、[Simple Log Service アクセス権限付与]に必要な権限を付与しました。
「[Push]」または「[Push Only File Error Logs]」を選択すると、データオンライン移行は、SLS に名前が aliyun-oss-import-log-<Alibaba CloudアカウントID>-<リージョン> という形式のプロジェクトを作成します。たとえば、aliyun-oss-import-log-137918634953****-cn-hangzhou です。
Simple Log Service の権限付与:このオプションは、[移行ログ] で [プッシュ] または [ファイルエラーログのみプッシュ] を選択した場合に表示されます。
「承認」をクリックします。「クラウドリソースアクセス権限付与」ページで、システムは「AliyunOSSImportSlsAuditRole」ロールを作成し、必要な権限を付与します。「権限付与に同意」をクリックして、権限付与を完了します。
失敗したファイルのリトライ
移行タスクが終了した後、レポートで一部のファイルが移行に失敗したことが示された場合、失敗したファイルのみを対象とした新しいサブタスクを作成して、再移行を実行します。
操作手順
データオンライン移行コンソール にログインします。
上部のメニューバーから、タスクが配置されているリージョンを選択します。
左側のナビゲーションウィンドウで、データオンライン移行 > 移行タスク を選択します。
移行タスク一覧で、管理したいタスクを見つけ、[管理] を [操作] 列でクリックして、その詳細ページに移動します。
履歴 セクションで管理対象のタスクを見つけ、失敗したファイルのリトライ 列の 操作 で **[失敗したファイルのリトライ]** をクリックします。
サブタスク名を変更し、次へ をクリックします。
移行帯域幅、1 秒あたりの移行ファイル数、上書き方法などのパラメーターが正しいことを確認し、次へ をクリックします。
OK をクリックします。サブタスクが開始され、失敗したファイルの再移行が実行されます。