列の伝播

概要

ソースで列の名前変更、型変更、削除を行った場合、その列にマッピングされているすべての下流ステップも合わせて更新する必要があります。列の伝播 を使うと、1回の確認でこの作業を自動的に行えます。

伝播は、ColumnMapper を持つすべてのステップ（Project Table、Calculate、Append、Merge など）から利用できます。マッパーのツールバーにある2つのボタンで操作します。

• Propagate All — マッパー内のすべての列を伝播します
• Propagate Selected — マッパーのグリッドで選択した列のみを伝播します

列の変更を伝播する

1. 変更したい列を含むワークフローステップを開きます
2. ColumnMapper で変更（名前変更、型変更など）を行います
3. マッパーのツールバーで Propagate All をクリックします（行を選択して Propagate Selected をクリックすることもできます）
4. ソースステップに依存するすべてのステップのツリーが表示された 下流に反映 ダイアログが開きます
5. 変更を適用するステップにチェックを入れます。子ステップは自動的に連動します
6. 集計ステップでは、下部の 集計 パネルで新しい列に使用する集計関数を選択します
7. Confirm をクリックします

集計 パネルには、標準の集計関数が一覧表示されます。ウィンドウ関数と併用する グループ化以外の詳細 は、ステップ自体のマッパーで設定するため、ここには表示されません。選択した集計が列に適合しない場合は、ダイアログに該当する列と理由が表示されるので、別の集計を選択できます。

ダイアログのデフォルトは安全側に設定されています。下流の行にその列の明示的なマッピングがない場合は、ソースの名前がターゲットとして再利用されるため、途中で情報が失われることはありません。

伝播される内容

• 列の名前変更 — ソース名からターゲット名への変更
• 型の変更 — 列が現れるすべての場所で dtype が更新されます
• このステップで追加された新しい列 — 下流のマッパーへ引き継がれます
• ソースに適用された除去操作

その列を参照しないステップもツリーには表示されますが、デフォルトではチェックが外れています。

エラーと再試行

ダイアログを開いた後に別のユーザーが下流のステップを編集していた場合、伝播は古いバージョンのエラーで失敗します。ダイアログは依存関係グラフを自動的に再取得し、選択内容を保持したまま再試行できます。再取得自体が失敗した場合も選択内容は保持されるため、根本的な問題を解決してからもう一度試せます。

ノート

列の伝播は、同じワークフロー内のステップのみを変更します。下流のワークフローがそのテーブルを使用している場合は、そのマッパーを別途更新するか、依存関係の監査を実行して影響を受けるステップを確認してください。