> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# チェックポイント再開
> 対応するOctoparseのローカル実行を、最初から再収集せずに、保存された進行状況から再開します。
チェックポイント再開を使うと、中断したローカル抽出を、最初から全体を再収集するのではなく、保存された進行状況から続行できます。
Octoparse 10.2で導入されたこの機能は、長時間かかるローカルタスク向けに設計されています。こうしたタスクでは、やり直すと多くのページを再訪し、完了済みのループを繰り返し、すでに収集したデータを再び待つことになりかねません。
## 保存される内容
対応するローカルタスクの実行中、Octoparseは抽出がどこで止まったかを再構築できるだけの進行状況を記録します。ワークフローに応じて、保存されるチェックポイントには次の情報が含まれます。
* すでに出力した行数
* URL・テキスト・アイテム・スクロールの各ループにおける現在位置
* ループ内の残りのアイテム
* 保存された地点に到達するために必要なワークフロー位置とページ
* Boostモード実行における個々のサブタスクの進行状況
現在の実行ですでに保存されている抽出データは維持されます。タスクを再開すると、Octoparseはその実行を復元し、残りのデータの収集を続けます。
## 再開したときに起こること
たとえば、5,000件の商品ページを収集するローカルタスクが、3,200行を出力した時点で停止したとします。
タスクを再度開くか開始すると、Octoparseは保存されたチェックポイントが現在のタスクのものであり、まだ利用できるかを確認します。有効であれば、実行画面に記録された進行状況が表示され、次の2つの選択肢が示されます。
* **Resume**：前回の実行を復元し、保存されたワークフロー位置に戻り、残りの作業を続けます。
* **Re-collect**：チェックポイントを破棄し、最初から新しい実行を開始します。
再開は、必ずしも最後のURLを開いてすぐ次の行を抽出することを意味しません。ワークフローによっては、保存された位置に安全に到達するために、ナビゲーションやループ状態の一部を再生する必要があります。この再生の間、Octoparseは記録した進行状況を使って完了済みの作業をスキップし、再生された出力を新しいデータとして扱わないようにします。保存された位置に一致すると、通常の抽出が続きます。
Boostモードでは、Octoparseはサブタスク単位でも進行状況を復元します。完了済みのサブタスクはスキップされ、一時停止・停止・失敗・未完了のサブタスクは待機キューに戻されます。
## どれだけの作業を保持できるか
効果は、実行がいつ止まったか、どれだけの作業がすでに完了していたかによって変わります。
| チェックポイント再開なし | チェックポイント再開あり |
| --------------------- | -------------------------- |
| 最初の入力またはページからタスクをやり直す | 実行の未完了部分に向けて続行する |
| すでに処理したページやループを再訪する | 記録されたループとワークフローの進行状況を復元する |
| 完了済みのサブタスクの再実行を待つ | 完了済みのBoostモードのサブタスクをスキップする |
| 中断のたびに新しい実行を作成する | 既存の実行と収集済みデータをそのまま使い続ける |
改善が最も大きいのは、大量のURLリスト、深いページネーション、長いループ、サブタスクの多いBoostモードのタスクです。開始直後に中断された実行は、完了間際に中断された実行より、保持できる作業が少なくなります。
## 中断したローカル実行を再開する
中断したローカル実行を開くか、タスク一覧から同じタスクを開始します。
有効なチェックポイントがあれば、Octoparseは保存された位置を表示します。出力行数、ループの進行状況、完了済み・残りのサブタスクなどが含まれる場合があります。
**Resume**を選ぶと前回の実行を復元します。保存された進行状況を意図的に破棄して最初から実行したい場合は、**Re-collect**を選びます。
Octoparseは、記録された位置に到達する前に、ページのナビゲーションやワークフローのアクションを再生することがあります。実行画面には、進行状況を復元中であること、チェックポイントに一致したことが表示されます。
残りの抽出が終わったら、出力行数と、中断地点付近のサンプルレコードを確認します。最終的なデータセットが、意図した入力を、想定外の欠落や重複なくカバーしているかを確認します。
## チェックポイントが使えない場合
チェックポイントは、特定のタスク設定と実行を表します。Octoparseは再開前にこれを検証し、保存された進行状況が互換性のないタスクに適用されないようにします。
次の場合は再収集が必要になることがあります。
* チェックポイント作成後に、タスクまたは入力URLが変更された
* チェックポイントが存在しない、破損している、または現在のワークフローに一致しない
* 保存された進行状況が、別のローカル実行モードのものである
* 前回の実行が正常に完了し、残りの作業がない
* スケジュールされたローカル実行が開始した場合。スケジュール実行は、再開の判断を待たず、最初から開始します
検証に失敗した場合、Octoparseはチェックポイントを利用不可とし、不確かな位置から黙って続行するのではなく、最初からの実行を提示します。
チェックポイントはローカルのデスクトップ実行とともに保存されます。進行状況が記録されたのと同じOctoparseデスクトップ環境でタスクを再開してください。
## チェックポイント再開・一時停止・再試行
これらのアクションは、それぞれ異なる問題を解決します。
| アクション | 使う場面 |
| ---------- | ------------------------------------------------- |
| 一時停止と再開 | 実行画面がまだ開いていて、実行中のプロセスを一時的に止めたいとき |
| チェックポイント再開 | 前回のローカル実行が停止し、保存された進行状況から再構築する必要があるとき |
| Re-collect | タスクが変わった、前回の進行状況がもう役立たない、または最初からクリーンなデータセットが欲しいとき |
## 関連ページ
タスクをどこで実行するかを選びます。
逐次実行と並列実行のローカル抽出を理解します。
タスクの進行状況と実行結果を確認します。