このトピックでは、データ移行タスクを作成した後のフォローアップ操作について説明します。
移行レポートの表示
移行レポートは、成功したファイル、失敗したファイル、スキップされたファイルのリストなど、移行結果に関する詳細情報を提供します。レポートは、移行タスクの実行ステータスを理解するのに役立ちます。
レポートファイルの種類
タスクの実行ステータスに基づいて、移行されたすべてのファイルのリスト、失敗したファイルのリスト、スキップされたファイルのリストの 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` は異常を意味します。 |
異常の理由 | 異常の理由の説明。 |
移行レポートの取得
データオンライン移行コンソールにログインします。
左側のナビゲーションウィンドウで、[データオンライン移行] > [移行タスク] を選択します。
移行タスクリストで、管理するタスクを見つけ、[管理] をクリックして詳細ページに移動します。
タスクの作成時に [プッシュしない] を選択した場合は、タスク詳細ページに移動して [履歴] タブをクリックし、次に [移行レポートの生成] をクリックします。レポートが生成されたら、[移行レポートのダウンロード] をクリックしてローカルマシンにダウンロードします。
タスクの作成時に Push を選択した場合は、タスク詳細ページに移動し、履歴 タブをクリックします。レポートが生成された後、[移行レポートのダウンロード] をクリックして、ローカルマシンにダウンロードします。
説明データ移行タスクが完了する前に生成された移行レポートは不完全な場合があります。完全なレポートを取得するには、タスクが終了した後にダウンロードしてください。
移行レポートは参照用です。宛先での実際に移行されたコンテンツが最終バージョンとなります。
移行レポートが生成されると、指定された Object Storage Service (OSS) バケットに保存されます。フォルダディレクトリレベルのプレフィックス形式は、タスクの実行ステータスに基づいており、次のようになります。
OSS://<bucket>/<prefix>/aliyun_import_report/<uid>/<jobid>/<runtimeid>/total_list/ OSS://<bucket>/<prefix>/aliyun_import_report/<uid>/<jobid>/<runtimeid>/failed_list/ OSS://<bucket>/<prefix>/aliyun_import_report/<uid>/<jobid>/<runtimeid>/skipped_list/パスパラメーターの説明
フィールド名
フィールドの意味
bucket
宛先バケット。
prefix
宛先データアドレスに指定された移行ディレクトリのプレフィックス。
uid
Alibaba Cloud アカウントの ID。
jobid
タスク ID。タスクの製品ページの [詳細] タブから取得します。
runtimeid
タスク実行レコード ID。タスクの製品ページの [履歴] タブから取得します。
Object Storage Service (OSS) コンソールで、宛先バケット内の移行レポートファイルを見つけます。これらのファイルをダウンロードして、詳細なファイルリストを表示します。詳細については、「ossbrowser 2.0 (プレビュー) グラフィカル管理ツール」をご参照ください。または ossutil ツールを使用して表示することをお勧めします。
移行ログの表示
移行プロセスのログは 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 アクセス権限付与] に必要な権限を付与していること。
[プッシュ] または [ファイルエラーログのみをプッシュ] を選択すると、データオンライン移行は aliyun-oss-import-log-<Alibaba Cloud アカウント ID>-<リージョン> というフォーマットの名前で SLS にプロジェクトを作成します。たとえば、aliyun-oss-import-log-137918634953****-cn-hangzhou のようになります。
[Simple Log Service 権限付与]: このオプションは、[移行ログ] で [プッシュ] または [ファイルエラーログのみプッシュ] を選択した場合に表示されます。
[権限付与] をクリックします。[クラウドリソースアクセス権限付与] ページで、システムは [AliyunOSSImportSlsAuditRole] ロールを作成し、必要な権限を付与します。[権限付与に同意] をクリックして権限付与を完了します。
失敗したファイルのリトライ
移行タスクが終了した後、レポートに一部のファイルの移行が失敗したことが示された場合、新しいサブタスクを作成して、失敗したファイルのみの移行をリトライできます。
手順
データオンライン移行コンソールにログインします。
上部のメニューバーで、タスクが配置されているリージョンを選択します。
左側のナビゲーションウィンドウで、[データオンライン移行] > [移行タスク] を選択します。
移行タスクリストで、管理するタスクを見つけ、[操作] 列の [管理] をクリックして詳細ページに移動します。
[履歴] セクションで、管理するタスクを見つけ、[操作] 列の [失敗したファイルのリトライ] をクリックします。
サブタスク名を変更し、[次へ] をクリックします。
移行帯域幅、毎秒移行されるファイル数、上書きメソッドなどのパラメーターが正しいことを確認し、[次へ] をクリックします。
[OK] をクリックします。サブタスクが開始され、失敗したファイルの移行がリトライされます。