処理
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
パイプラインの実行は「処理」と呼ばれます。処理では、パイプラインにおけるインポート、加工処理、エクスポートの進捗状況や、その他の統計情報が記録されます。
処理ページに移動するには、上部メニューの［処理］タブをクリックします。
［処理］タブには、組織内のすべてのワークスペースで実行されたすべての処理が一覧表示されます。処理ID、関連付けられているパイプライン、開始日時、実行時間、ステータス、実行したユーザー、使用中の容量、処理した行も確認できます。
処理のリストでは、失敗したパイプライン処理を特定し、再試行できます。
フィルター：
フィルターのドロップダウンを使用すると、処理を種類別に表示できます：［手動での実行］、［手動での実行（データあり）］（更新したデータを使用した手動での実行）、［予約実行］、［バックフィルの実行］、［セクションの実行］、［Zoho Flow］、［Webhook］、［データを再読み込み］、［パイプライン後に実行］、［コード実行］。セクションの処理を表示するには、［セクションの処理を含める］切り替えボタンを有効にします。
テーブル見出しの上部にある各並べ替えアイコンを使用すると、パイプライン、開始日時、ステータスに基づいて処理をすばやく並べ替えることもできます。
DataPrepのパイプラインやその他の要素について詳しくは、こちらをクリックしてください。
処理の概要
［処理］ページで処理をクリックすると、処理の概要に移動します。処理の概要ページには、パイプライン名、処理のステータス、実行時間、実行したユーザー、使用中の容量、処理した行の合計、データの範囲、処理の開始日時と終了日時など、処理の実行に関する主な詳細が表示されます。
メモ：パイプラインの作成画面で［処理の履歴］を選択して、処理の概要ページに移動することもできます。
特定の処理に関する詳細に加え、全体のステータス、各ステージの結果、エクスポート結果など、パイプラインの開始から完了までの実行状況を確認できます。これにより、問題のトラブルシューティング、パフォーマンスの分析、出力内容の品質確認が可能です。
処理が失敗した場合や変更が必要な場合は、［パイプラインを編集する］をクリックしてパイプラインを変更できます。パイプラインで実行されたすべての処理を表示するには、［処理の履歴］をクリックします。
処理の概要では、処理の詳細が次の3つのタブに表示されます：［パイプラインフロー］、［ステージ］、［出力内容］。
パイプラインフロー
［パイプラインフロー］タブには、選択した処理でパイプラインがどのように実行されたかが視覚的に表示されます。パイプライン内のデータの流れ全体を把握し、各手順が正常に完了したかどうかをすばやく確認できます。
このタブには、インポート元から、適用済みの加工処理、最終的なエクスポート先まで、パイプラインのステージが順番に表示されます。フロー内の各ステージには実行ステータスが表示されるため、完了、失敗、スキップ済みの手順を簡単に特定できます。［すべての出力データをダウンロードする］を使用して、すべての出力内容を1つのZIPファイルとしてダウンロードすることもできます。
パイプラインフロー内のステージをクリックすると、そのステージに適用されたルールを確認できます。
ステージ
［処理の概要］ページの［ステージ］セクションでは、パイプラインの各ステージで処理がどのように実行されたかを包括的に確認できます。実行内容はインポート、加工、エクスポートに分けられ、各ステージの概要と詳細が表示されます。インポート、適用済みの加工処理、エクスポートについて、ステータス、処理した行、使用中の容量、開始日時、終了日時などの詳細を確認できます。
インポート
［インポート］ステージには、処理に含まれるすべてのデータソースの詳細が表示されます。インポート全体のステータスと、成功および失敗したインポートの件数を確認できます。各データソースについて、インポートのステータス、インポートしたファイル数、インポートした行数、使用中の容量、インポートの完了にかかった時間などの情報が表示されます。
情報アイコンをクリックすると、データソースの詳細を確認できます。入力データの取得元について、データソースの種類や解析の詳細など、必要な情報が表示されます。
［インポート設定を表示］オプションでは、データソースのインポート設定の概要を確認できます。
ファイル名の横にある［インポート済みファイル］のリンクをクリックすると、バッチファイルのポップアップが開きます。このポップアップには、そのバッチでインポートされたすべてのファイルが一覧表示され、各ファイルのファイル名、使用中の容量、インポートされた行数を確認できます。また、ダウンロードアイコンを使用して、このポップアップから個々のファイルを直接ダウンロードできます。
メモ：このオプションは、ファイル、FTP、クラウドストレージのデータソースでのみ利用できます。
加工
［加工処理］セクションには、処理の実行中に実行されたすべての加工処理の概要が表示されます。加工処理の概要に加え、データの品質指標、処理した行、容量の使用状況、処理時間などの詳細を確認できます。このセクションでは、加工処理の進行状況をすばやく監視し、対応が必要な失敗したステップを特定できます。
情報アイコンをクリックすると、データに適用されているすべてのルールを確認できます。プレビューアイコンを使用すると、そのステージの出力データをすばやく確認できます。また、すべての出力データをまとめてダウンロードしなくても、ダウンロードアイコンをクリックして、特定のステージの出力データを直接ダウンロードできます。
エクスポート
エクスポートステージには、処理によって生成された最終的な出力内容の詳細が表示されます。すべてのエクスポート先と、その実行ステータス、データの品質指標、エクスポートされた行数、使用した容量、各エクスポートに要した時間が一覧表示されます。このステージでは、処理済みデータが目的のエクスポート先に正常に送信されたことを確認できます。
情報アイコンをクリックすると、エクスポート先の詳細を確認できます。また、プレビューアイコンを使用して各ステージの出力内容をすばやく確認し、必要に応じて任意のステージからデータをダウンロードできます。
ステージのステータス
処理の実行中に表示されるステータスは次のとおりです。
成功 - ステージがエラーなく実行されると、このステータスが表示されます。
未実行 - 手動（既存のデータ）またはセクション実行時や、依存関係にある上位ノードではない場合、インポートやステージが実行されない可能性があります。たとえば、セクション実行では、上位からの変更内容が下位に読み込まれますが、新しいインポートは行われません。そのため、インポートステージは実行されません。
メモ：これらのステージの行は、処理した行の計算には含まれません。
キャッシュ - データが前回の実行ですでに処理されている場合や、ステージが今回の実行で依存関係にある上位ノードではない場合、一部のステージがキャッシュされます。たとえば、互いに独立した2つのステージAとBを持つパイプラインについて考えます。Aにのみ加工処理を適用してパイプラインを実行すると、Bは更新されず、既存のデータを引き続き使用します。この場合、Bはキャッシュされます。
メモ：キャッシュされたステージの行は、処理した行の計算には含まれません。
待機中 - パイプラインの実行中、次の処理ステージのバッチがキューに追加されます。
失敗 - エラーのあるステージが失敗すると、このステータスが表示されます。
出力内容
［出力内容］タブでは、処理のすべての出力内容に加え、追加されたエクスポート先、データの品質、出力ステージ、エクスポートされた行数、使用中の容量、エクスポートに要した時間を一覧で確認できます。
各出力内容の情報アイコンをクリックすると、出力内容の詳細を確認できます。また、出力データをプレビューしたり、出力内容をダウンロードしたりできます。
よくある質問
1. データ内の無効な値など、データセットの品質に関する問題が原因でエクスポートに失敗した場合は、どうすればよいですか？
次のようなエラーが原因でエクスポートに失敗した場合は、データ内の無効な値を修正する必要があります。
1. データセットの品質100が設定済みの最低品質100を下回っているため、エクスポートが中止されました。
2. データセットにエクスポート先で受け付けられない無効なデータが含まれているため、エクスポートに失敗しました。
データ内の無効な値を確認するには、次の手順を実行します。
1. ［処理の概要］→［出力内容］タブに移動します。
1. ［処理の概要］→［出力内容］タブに移動します。
2. 無効な列を確認するには、［データの品質］アイコンをクリックします。
4. サンプルに無効な値が含まれていなくても、データ全体には含まれている場合があります。この場合、最後のデータ準備ステージ→右側のペインで、［サンプルの作成方法］の横にある編集アイコンをクリック→［エラーサンプル］を選択し、［適用］をクリックします。
これにより、サンプルデータ内の無効な値が表示されます。これらの無効な値を修正してから、処理を再試行してください。
2. 処理の失敗を防ぐため、パイプラインの実行前にファイルが存在しないかどうかを確認できますか？
Zoho DataPrep 2.0では、差分取得時に入力ファイルが存在するかどうかにかかわらず、パイプライン処理が開始されます。ファイルが存在しない場合、インポートステージで処理が失敗します。DataPrepではこのような状況が自動的に処理されるため、事前に手動で確認する必要はありません。これらの失敗は、処理の概要で確認できます。
3. ダウンロードした出力ファイルのサイズが、［ステージ］タブに表示されるサイズより大きいのはなぜですか？
Zoho DataPrepでは、容量を最適化するため、ファイルが圧縮形式で保存されます。そのため、DataPrep内に表示されるファイルサイズは小さくなります。出力データをダウンロードすると、ファイルサイズはかなり大きくなります。たとえば、DataPrepで1GBの容量を使用するファイルは、出力データとしてダウンロードすると、より多くのスペースを占有する場合があります。
関連情報