派生列変換

適用対象: SQL Server Azure Data Factory の SSIS Integration Runtime

派生列変換では、式を変換入力列に適用することにより新しい列の値を作成します。 式には、変換入力からの列、変数、関数、および演算子の任意の組み合わせを含めることができます。 結果は、新しい列として追加するか、または既存の列の値を置き換える値として挿入できます。 派生列変換では複数の派生列を定義でき、任意の変数または入力列を複数の式に含めることができます。

この変換を使用すると、次のタスクを実行できます。

  • 複数の異なる列のデータを 1 つの派生列に連結します。 たとえば、 という式を使用すると、 FirstName 列と LastName 列の値を、1 つのFullName FirstName + " " + LastNameという名前の派生列に結合できます。

  • SUBSTRING などの関数を使用して文字列データから文字を抽出し、その結果を派生列に格納します。 たとえば、 という式を使用すると、 FirstName SUBSTRING(FirstName,1,1)列から名前の頭文字を抽出できます。

  • 数学関数を数値データに適用し、その結果を派生列に格納します。 たとえば、 という式を使用すると、数値列SalesTax ROUND(SalesTax, 2)の長さと有効桁数を、小数点以下 2 桁に変更できます。

  • 入力列と変数を比較する式を作成します。 たとえば、 という式を使用すると、変数 Version と列ProductVersion のデータを比較し、その比較結果に応じて、 Version ProductVersion ProductVersion == @Version? ProductVersion : @Versionのどちらかの値を使用できます。

  • datetime 値の一部を抽出します。 たとえば、 DATEPART("year",GETDATE())という式を使用すると、GETDATE 関数と DATEPART 関数を使用して現在の年を抽出できます。

  • 式を使用して、日付文字列を特定の形式に変換します。

派生列変換の構成

派生列変換は、次の方法で構成できます。

  • 各入力列または変更する新しい列に対し、式を設定します。 詳細については、「Integration Services (SSIS) 式」を参照してください。

    Note

    派生列変換によって上書きされる入力列を式が参照する場合、その式は派生した値ではなく、列の元の値を使用します。

  • データ型が 文字列の場合に結果を新しい列に追加するには、コード ページを指定します。 詳しくは、「 Comparing String Data」をご覧ください。

派生列変換には、FriendlyExpression カスタム プロパティがあります。 このプロパティは、パッケージの読み込み時にプロパティ式で更新できます。 詳細については、「 パッケージでプロパティ式を使用する」および「 変換のカスタム プロパティ」を参照してください。

この変換は、1 つの入力、1 つの標準出力、および 1 つのエラー出力をとります。

プロパティを設定するには SSIS デザイナーから行うか、またはプログラムによって設定します。

[詳細エディター] ダイアログ ボックスには、プログラムによって設定できるプロパティが反映されます。 [詳細エディター] ダイアログ ボックスまたはプログラムで設定できるプロパティの詳細については、次のトピックのいずれかを参照してください。

プロパティの設定方法の詳細については、次のトピックのいずれかを参照してください。

派生列変換エディター

[派生列変換エディター] ダイアログ ボックスを使用すると、新しい列または置換列を作成する式を作成できます。

オプション

[変数] と [列]
使用可能な変数と列の一覧から、下のペインにある既存のテーブル行または一覧の下の新しい行へドラッグすることによって、変数または入力列を使用する式を作成します。

[関数] と [演算子]
関数と演算子を一覧から下のペインにドラッグすることによって、入力データおよび直接出力データを評価する関数または演算子を使用する式を作成します。

[派生列名]
派生列名を指定します。 既定は派生列の番号付けされた一覧ですが、一意のわかりやすい名前を付けることもできます。

[派生列]
一覧から派生列を選択します。 派生列を新しい出力列として追加するか、既存の列のデータを置き換えるかを選択します。

[式]
式を入力するか、前述の使用可能な列、変数、関数、および演算子の一覧からドラッグすることによって式を作成します。

このプロパティの値は、プロパティ式を使用して指定することができます。

関連トピック: Integration Services (SSIS) ExpressionsOperators (SSIS Expression)Functions (SSIS Expression)

[データ型]
新しい列にデータを追加すると、 [派生列変換エディター] ダイアログ ボックスによって自動的に式が評価され、データ型が適切に設定されます。 この列の値は読み取り専用です。 詳細については、「 Integration Services Data Types」を参照してください。

[データ型]
新しい列にデータを追加すると、 [派生列変換エディター] ダイアログ ボックスによって自動的に式が評価され、文字列データに対する列の長さが設定されます。 この列の値は読み取り専用です。

[精度]
新しい列にデータを追加すると、 [派生列変換エディター] ダイアログ ボックスによって、データ型に基づく数値データの有効桁数が自動的に設定されます。 この列の値は読み取り専用です。

スケール
新しい列にデータを追加すると、 [派生列変換エディター] ダイアログ ボックスによって、データ型に基づく数値データの小数点以下桁数が自動的に設定されます。 この列の値は読み取り専用です。

コード ページ
新しい列にデータを追加すると、 [派生列変換エディター] ダイアログ ボックスによって、DT_STR データ型のコード ページが自動的に設定されます。 [コード ページ]は必要に応じて更新できます。

[エラー出力の構成]
[エラー出力の構成] ダイアログ ボックスを使用して、エラーの処理方法を指定します。