このトピックでは、データ移行タスクを作成した後の後続操作について説明します。
移行レポートの確認
移行レポートには、移行結果に関する詳細情報が記載されており、成功・失敗・スキップされたファイルの一覧が含まれます。これにより、移行タスクの実行状況を把握できます。
レポートファイルの種類
タスクの実行状況に応じて、以下の 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 は異常を意味します。 |
異常の理由 | 異常が発生した理由の説明です。 |
移行レポートの取得
データオンライン移行コンソールにログインします。
左側ナビゲーションウィンドウで、データオンライン移行 > 移行タスク を選択します。
移行タスク一覧から管理対象のタスクを見つけ、管理 をクリックして、その詳細ページを開きます。
タスク作成時に プッシュしない を選択した場合は、タスク詳細ページで 履歴 タブをクリックし、その後 移行レポートの生成 をクリックします。レポートが生成されたら、移行レポートのダウンロード をクリックして、ご利用のローカルマシンにダウンロードします。
タスク作成時に プッシュする を選択した場合は、タスク詳細ページで 履歴 タブをクリックします。レポートが生成されたら、移行レポートのダウンロード をクリックして、ご利用のローカルマシンにダウンロードします。
説明データ移行タスクが完了する前に生成された移行レポートは、不完全である可能性があります。完全なレポートを取得するには、タスク完了後にダウンロードしてください。
移行レポートはあくまで参考情報です。実際の移行結果は、デスティネーションにおける実ファイルが最終的な正解となります。
生成後、移行レポートはデスティネーションの 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 アクセス権限付与 のための必要な権限が付与済みであること。
プッシュする または エラーログのみプッシュ を選択すると、データオンライン移行は SLS 内に aliyun-oss-import-log-<Alibaba Cloud アカウント ID>-<リージョン> という形式の名前でプロジェクトを作成します(例:aliyun-oss-import-log-137918634953****-cn-hangzhou)。
Simple Log Service 権限付与:「移行ログ」に対して プッシュする または エラーログのみプッシュ を選択した場合に表示されます。
付与 をクリックします。その後表示される クラウドリソースアクセス権限付与 ページにて、AliyunOSSImportSlsAuditRole ロールが自動作成され、必要な権限が付与されます。権限付与に同意 をクリックして、権限付与を完了します。
失敗したファイルの再試行
移行タスクが終了した後、レポートに一部のファイルが失敗したと表示された場合、失敗したファイルのみを対象とした新しいサブタスクを作成し、再試行します。
操作手順
データオンライン移行コンソールにログインします。
上部メニューバーから、タスクが配置されているリージョンを選択します。
左側ナビゲーションウィンドウで、データオンライン移行 > 移行タスク を選択します。
移行タスク一覧から管理対象のタスクを見つけ、管理 をクリックして、その詳細ページを開きます(操作 列)。
履歴 セクションで、管理対象のタスクを見つけ、失敗したファイルの再試行 をクリックします(操作 列)。
サブタスク名を変更し、次へ をクリックします。
移行帯域幅、1 秒あたりの移行ファイル数、上書き方法などのパラメーターが正しいことを確認し、次へ をクリックします。
OK をクリックします。サブタスクが開始され、失敗したファイルの再試行が実行されます。