出力

Merge Entities ステージは、2 つの出力ポートを持つことができ、さまざまなシンク ステージを接続できます。一方のシンクで、正しく結合されたエンティティとそのプロパティのデータを取得し、もう一方で、結合できなかったレコードのデータを収集します。このポートをエラー ポートといいます。このポートからシンク ステージに送られるレコードは形式に誤りがあると考えられます。

形式に誤りのあるレコードをキャプチャすることは、そのレコードに関する問題を特定するのに役立ちます。シンク ステージをエラー ポートに接続すると、作成される出力ファイルには、すべてのレコードからのフィールドの上位集合が含まれます。レコードの処理に失敗した理由を示す理由フィールドも含まれます。したがって例えば、あるレコードにタイプ、ID、および場所のフィールドが含まれ、2 つめのレコードにタイプ、ID、およびラベルのフィールドが含まれる場合、出力ファイルには理由、タイプ、ID、場所、およびラベルのフィールドが含まれます。

レコードの処理が失敗する理由としては、次のようなものが考えられます。
  • ID フィールドの値が空である。
  • 入力された ID によって、選択されたモデルからエンティティが 1 つも返されなかった。
  • 入力された ID とタイプの組み合わせによって、選択されたモデルからエンティティが 1 つも返されなかった。
  • ID とタイプの入力形式が正しくない (正しい入力形式は TYPE_VALUE:ID_VALUE)。