Skip to main content

ユニオンツール

ユニオンツールは、列の名前または位置に基づいて、2 つ以上のデータセットを結合します。

出力には、各列に各入力の行が含まれます。出力で列を上下に積み重ねる、または列を一致させるかを設定できます。

ヒント

このツールには「ツールごとに学習」があります。 サンプルワークフローへのアクセス を参照して、 Designer Cloud でこのサンプルやその他の多くのサンプルに直接アクセスする方法を確認してください。

ツールコンポーネント

Union tool anchors.png

図: ユニオンツールと2つのアンカー。

ユニオンツールには以下の2つのアンカーがあります。

  • 入力アンカー: 入力アンカーは、統一するデータストリームに接続します。入力アンカーの2つの山かっこは、複数の入力を受け入れることを示します。

  • 出力アンカー: 出力アンカーは出力データセットを表示します。

ツールの設定

次の項目を使用して列を垂直にスタック : 列を積み上げる方法を選択します。既定の設定は、[ 列名で自動設定 ] となっています。

  • 名前 : 列の名前でデータを積み上げます。

  • 位置 : ストリーム内の列順でデータを積み上げます。

  • 手動設定 : データの積み上げ方法を手動で指定します。この方法を選択すると、各入力の列が表示されます(例: 行番号#1、#2など)。 位置 または 名前 でテーブルを リセット できます。

警告

モードが 手動で設定 に設定されている場合、 Designer Cloud は、ツールの設定とワークフローの実行時間の間で設定が変更されないと見なします。欠落しているものがある場合、エラーが発生し、ワークフローが停止します。

フィールドの手動設定

手動設定 方式では、 出力 プロパティを設定する必要があります。

まず、データストリームを水平方向と垂直方向にずらして配置し、各入力データセットのデータが異なるセルに配置されるようにします。

  1. (オプション) リセット ドロップダウンで 位置 または 名前 を選択して設定できます。列をリセットするには、 リセット を選択します。データストリームに、位置または名前のいずれかによって一致する列が含まれている場合は、このオプションを使用します。

  2. 次に、 矢印 を使用してデータの積み上げを行ないます。セルを選択し、 左矢印 または 右矢印 を選択して、一致するデータフィールドを積み上げます。

プロパティ

列が異なる場合

自動設定モードでは、列名が異なる場合の処理方法を選択する必要があります。

  • 警告(データ処理を続行) : 結果グリッドに警告が表示されますが、行の処理は続行します。

  • エラー(データ処理を停止) : 結果グリッドにエラーが発生し、レコードの処理が停止します。

  • 無視(データ処理を続行) : 異なる列名を無視し、行の処理を続行します。

列の出力オプション

  • すべての列を出力 : 出力にはすべての列が含まれています。Null 値は空の列に表示されます。

  • 共通の列のみ出力 : 出力には、各入力に共通の列のみが含まれます。

出力順序

出力順序 で、 指定 をオンにして、出力に最初に表示する入力データセットのデータを指定します。チェックボックスをオンにした後、テーブルの並べ替えアイコンを選択したまま、接続を上下にドラッグします。

警告

出力順序を指定する オプションを使用すると、パフォーマンスが低下する可能性があります。

出力について

ユニオンツール出力の2つの要素、データの列名と順序を理解することが重要です。

出力データ列名について

出力データセットで使用される列名は、最初の英数字値順で入力ストリームから取得されます。

既定では、入力データストリームには、ユニオンツールの入力アンカーに接続した順序に基づいて #1 #2 のラベルが付けられます。したがって、列名が異なる場合、出力データセットには#1入力データセットの列名が使用されます。

#2入力データセットの列名を使用する場合は、入力接続の名前を変更します。入力ストリームを選択し、新しい値を入力します。出力列名は、接続の名前に入力されている最初のアルファベット順/数字順の値を持つ接続から取得されます。

union-change-connection-name.png

図: 出力列名の入力ソースの変更。

出力データの順序について

既定の出力順序は、入力データセットをユニオンツールの入力アンカーに接続した順序に対応します。出力データの順序を変更する方法については、出力順序のセクションを参照してください。