フラット ファイル ソース

  • [アーティクル]

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

フラット ファイル ソースは、テキスト ファイルからデータを読み取ります。 テキスト ファイルには、Delimited 形式、FixedWidth 形式、または Mixed 形式を使用できます。

  • Delimited 形式では、列区切り記号と行区切り記号を使用して、列と行が定義されます。

  • FixedWidth 形式では、幅を使用して列と行を定義します。 またこの形式には、フィールドを幅いっぱいまで埋めるための文字も含まれています。

  • RaggedRight 形式では、幅を使用して最終列以外のすべての列を定義します。最終列は、行区切り記号で区切られます。

フラット ファイル ソースは、次の方法で構成できます。

  • 変換出力に列を追加します。列には、フラット ファイル ソースによるデータの抽出元となるテキスト ファイルの名前が含まれています。

  • フラット ファイル ソースで、列にある長さ 0 の文字列を NULL 値として解釈するかどうかを指定します。

    Note

    長さ 0 の文字列を NULL として解釈するには、フラット ファイル ソースで使用するフラット ファイル接続マネージャーを、Delimited 形式を使用するように構成する必要があります。 フラット ファイル接続マネージャーで FixedWidth 形式または RaggedRight 形式が使用される場合、空白文字で構成されるデータを NULL 値として解釈できません。

フラット ファイル ソースの出力にある出力列には、FastParse プロパティが含まれています。 FastParse は、列が、 Integration Services に用意されているロケール非依存型の高速な解析ルーチンを使用するか、ロケール依存型の標準的な解析ルーチンを使用するかを示します。 詳細については、「 Fast Parse 」および「 Standard Parse」を参照してください。

出力列には、UseBinaryFormat プロパティも含まれます。 このプロパティを使用して、パック 10 進形式を使用するデータなど、バイナリ データのサポートをファイルに実装します。 既定では、UseBinaryFormat を falseに設定します。 バイナリ形式を使用する場合は、UseBinaryFormat を true に設定し、出力列のデータ型を DT_BYTESに設定します。 この設定を行った場合、フラット ファイル ソースはデータ変換をスキップし、データを出力列にそのまま渡します。 この場合は、派生列変換またはデータ変換などの変換を使用して DT_BYTES データを別のデータ型にキャストするか、スクリプト変換でカスタム スクリプトを記述してデータを解釈できます。 また、カスタム データ フロー コンポーネントを記述してデータを解釈することもできます。 DT_BYTES をキャストできるデータ型の詳細については、「Cast (SSIS 式)」を参照してください。

フラット ファイル ソースは、フラット ファイル接続マネージャーを使用してテキスト ファイルにアクセスします。 フラット ファイル接続マネージャーでプロパティを設定することにより、ファイルおよびファイルの各列に関する情報を提供して、フラット ファイル ソースで、テキスト ファイルのデータをどのように処理するかを指定できます。 たとえば、ファイルの列と行を区切る文字や、各列のデータ型や長さを指定できます。 詳しくは、「 フラット ファイル接続マネージャー」をご覧ください。

この変換は、1 つの出力と 1 つのエラー出力をとります。

フラット ファイル ソースの構成

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

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

データ フロー コンポーネントのプロパティの設定方法の詳細については、「 データ フロー コンポーネントのプロパティを設定する」を参照してください。

[フラット ファイル ソース エディター]\ ([接続マネージャー] ページ)

[フラット ファイル ソース エディター] ダイアログ ボックスの [接続マネージャー] ページを使用すると、フラット ファイル ソースが使用する接続マネージャーを選択できます。 フラット ファイル ソースは、区切り形式、固定幅形式、または区切りと固定幅が混在した形式のテキスト ファイルからデータを読み取ります。

フラット ファイル ソースは、次のいずれかの種類の接続マネージャーを使用できます。

  • ソースが単一のフラット ファイルの場合は、フラット ファイル接続マネージャー。 詳しくは、「 フラット ファイル接続マネージャー」をご覧ください。

  • ソースが複数フラット ファイルで、データ フロー タスクが For ループ コンテナーなどのループ コンテナーの内部にある場合は、複数フラット ファイル接続マネージャー。 コンテナーの各ループで、フラット ファイル ソースは、複数フラット ファイル接続マネージャーが提供する次のファイル名からデータを読み込みます。 詳細については、「 複数フラット ファイル接続マネージャー」を参照してください。

Options

Flat file connection manager
既存の接続マネージャーを一覧から選択するか、 [新規作成]をクリックして新しい接続マネージャーを作成します。

[新規作成]
新しい接続マネージャーを作成するには、 [フラット ファイル接続マネージャー エディター] ダイアログ ボックスを使用します。

[データ ソースの NULL 値をデータ フローで NULL 値として保持する]
データが抽出されたときに NULL 値を保持するかどうかを指定します。 このプロパティの既定値は falseです。 この値がfalseである場合、フラット ファイル変換元は変換元データの NULL 値を各列の適切な既定値で置き換えます。たとえば、文字列型の列の場合は空の文字列、数値型の列の場合は 0 です。

プレビュー
[データ ビュー] ダイアログ ボックスを使用して、結果をプレビューします。 プレビューでは、最大で 200 行を表示できます。

[フラット ファイル ソース エディター]\ ([列] ページ)

[フラット ファイル ソース エディター] ダイアログ ボックスの [列] ノードを使用すると、出力列を各外部 (変換元) 列にマップできます。

Note

フラット ファイル ソースの FileNameColumnName プロパティおよびその出力列の FastParse プロパティは、 [フラット ファイル ソース エディター]ではアクセスできませんが、 [詳細エディター]を使用して設定できます。 これらのプロパティの詳細については、「 Flat File Custom Properties」の「フラット ファイル ソース」を参照してください。

Options

使用できる外部列
データ ソース内の使用できる外部列の一覧を表示します。 このテーブルを使用して列を追加または削除することはできません。

[外部列]
タスクで外部 (変換元) 列を読み取る順序を表示します。 この順序を変更するには、テーブルで選択した列を消去してから、別の順序で一覧から外部列を選択します。

出力列
各出力列の一意な名前を表示します。 既定では選択された外部 (変換元) 列の名前になりますが、一意でわかりやすい名前を付けることもできます。 指定された名前は、 SSIS デザイナーに表示されます。

[フラット ファイル ソース エディター]\ ([エラー出力] ページ)

[フラット ファイル ソース エディター] ダイアログ ボックスの [エラー出力] ページでは、エラー処理オプションの選択や、エラー出力列に対するプロパティの設定を行えます。

Options

[入力または出力]
データ ソースの名前を表示します。

列
[フラット ファイル ソース エディター] ダイアログ ボックスの [接続マネージャー]ページで選択した外部 (変換元) 列を表示します。

Error
エラーが発生した場合に、障害を無視するか、行をリダイレクトするか、コンポーネントを失敗させるかを指定します。

関連項目: データのエラー処理

切り捨て
切り捨てが発生したときの処理方法 (エラーを無視する、行をリダイレクトする、またはコンポーネントを失敗させる) を指定します。

説明
エラーの説明を表示します。

[選択したセルに設定する値]
エラーまたは切り捨てが発生した場合に、選択したすべてのセルに対して障害を無視するか、行をリダイレクトするか、コンポーネントを失敗させるかを指定します。

[適用]
選択したセルにエラー処理オプションを適用します。

参照

フラット ファイル変換先
データ フロー