柔軟なパイプラインとマッピンググループを実現すべく、変換とマッピングルールで変数値を使用できます。
要件
データの準備は完全に組織レベルでコントロールされ、個々のワークスペースやその権限は認識されない。
という意味だ：
- データの準備は、組織内のすべての作成権限者間で共有されます。
- チェーンビルダーにアクセスできるユーザーは、データの準備にもアクセスすることができます。
- チェーンを作成または編集できるすべてのユーザーは、データの準備でパイプラインを管理できるようになります。
- 一つのデータ準備パイプラインは、組織内の複数のチェーンやワークスペースにまたがって使用することができる。
変数タイプ
パイプラインでは、返却する値によって変数のタイプを使い分けることができます。
| 変数タイプ | 説明 |
|---|---|
| システム | パイプラインの実行時間に関する情報を提供する：
|
| 列 | パイプラインまたはマッピンググループで定義された列の値を返却します。 |
| ランタイム | パイプライン実行時に変数値を設定できるようにする。 |
変数値の入力
変換またはマッピングのルール内で、いくつかの値に対して変数を選択することができます：
- 変換/トランスフォーメーション用の変数を選択するには、フィールドで変数 をクリックする。
- マッピングルールの変数を選択するには、From またはTo フィールドをクリックします。
フィールドに複数の変数値を含むことも、変数と静的値を結合することもできる。
パイプラインまたはマッピンググループのランタイム変数の作成
実行時変数を作成して、パイプラインの実行時に変換グループに値を設定できるようにすることができます。
メモ： 同じデータ型の列に対してのみ、ランタイム変数を使用することができる。データ型の異なる複数の列を持つ変数を使用するには、それぞれのデータ型ごとに別の変数を作成する。
- パイプラインまたはマッピンググループで、Variables タブを選択する。
- 変数を追加する：
- 最初の変数であれば、変数を作成をクリックします。
- それ以外の場合は、変数の編集 の下で、変数の追加 をクリックする。
- 最初の変数であれば、変数を作成をクリックします。
- StringやNumberなど、変数を使用する列のデータ型を選択する。
- パイプラインの実行に変数の値が必要な場合は、必須をチェックしてください。
メモ： 必須 がチェックされていて、実行時に値が入力されていない 場合、変数にデフォルト値があってもパイプラインは実行されません。
- 名称を表示に、変数の識別を手助けする名称を入力します。
- 該当する場合は、変数のデフォルト値を入力する。
- [保存]をクリックします。
ヒント: マッピンググループ用にランタイム変数を作成する場合は、マッピング トランスフォーメーションでマッピンググループを使用するすべてのパイプライン用に対応する変数を作成します。パイプラインとマッピンググループ間の変数のマッピングを手助けすべく、両方に同じ名称を使用します。マッピンググループの変数を区別するには、MG_ のように、その名称に接頭辞を付ける。
パイプラインのランタイム変数のプレビュー値の設定
パイプラインがランタイム変数を使用する場合、変換のプレビューに使用する値を設定します。
注: 実行時変数が必要な場合、パイプラインは変換をプレビューするためにその値を必要とします。実行時変数が必須ではない場合、その値が設定されるまでnullがプレビューに表示されます。
- パイプラインで、変数 タブを選択し、変数の編集 をクリックします。
- プレビュー変数の設定 で、パイプラインのランタイム変数の値を入力します。
- 設定値 をクリックする。
注： 変換処理でエラーが発生しました。 サンプルファイル #### でパイプライン #### のプレビュー中に例外が発生しました。 変数[]は必須としてマークされていますが、空でない値が設定されていません。実行時変数が必須であるがプレビューが入力されていない場合に表示されます。
ランタイム変数の編集
ランタイム変数はいつでも編集できる。
- パイプラインまたはマッピンググループで、変数 タブを選択し、変数の編集 をクリックします。
- 必要に応じて、変数のデータ型、必須 ステータス、名称、デフォルト値を更新する。
- [保存]をクリックします。
- データ型を編集した場合は、その変数値を使用する変換も更新してください。
ランタイム変数の削除
ランタイム変数が不要になった場合は、パイプラインまたはマッピンググループから削除することができます。
- パイプラインまたはマッピンググループで、変数 タブを選択し、変数の編集 をクリックします。
- 削除する変数については、削除 をクリックする。
- [保存]をクリックします。
- その変数を使用していた変換を新規値で更新します。