열 내보내기 변환Export Column Transformation

열 내보내기 변환은 데이터 흐름에서 데이터를 읽어 파일에 삽입합니다.The Export Column transformation reads data in a data flow and inserts the data into a file. 예를 들어 데이터 흐름에 각 제품 사진과 같은 제품 정보가 포함되어 있으면 열 내보내기 변환을 사용하여 이미지를 파일에 저장할 수 있습니다.For example, if the data flow contains product information, such as a picture of each product, you could use the Export Column transformation to save the images to files.

추가 및 잘림 옵션Append and Truncate Options

다음 표에서는 추가 및 잘림 옵션 설정이 결과에 미치는 영향을 설명합니다.The following table describes how the settings for the append and truncate options affect results.

추가Append 잘라내기Truncate 파일 존재 여부File exists 결과Results
FalseFalse FalseFalse 아니오No 이 변환은 새 파일을 만들고 해당 파일에 데이터를 씁니다.The transformation creates a new file and writes the data to the file.
TrueTrue FalseFalse 아니오No 이 변환은 새 파일을 만들고 해당 파일에 데이터를 씁니다.The transformation creates a new file and writes the data to the file.
FalseFalse TrueTrue 아니오No 이 변환은 새 파일을 만들고 해당 파일에 데이터를 씁니다.The transformation creates a new file and writes the data to the file.
TrueTrue TrueTrue 아니오No 이 변환은 디자인 타임 유효성 검사에 실패합니다.The transformation fails design time validation. 두 속성을 모두 true로 설정하면 안 됩니다.It is not valid to set both properties to true.
FalseFalse FalseFalse Yes 런타임 오류가 발생합니다.A run-time error occurs. 이 변환은 파일은 있지만 해당 파일에 쓸 수 없습니다.The file exists, but the transformation cannot write to it.
FalseFalse TrueTrue Yes 이 변환은 파일을 삭제하고 다시 만든 후 해당 파일에 데이터를 씁니다.The transformation deletes and re-creates the file and writes the data to the file.
TrueTrue FalseFalse Yes 이 변환은 파일을 열고 해당 파일의 끝에 데이터를 씁니다.The transformation opens the file and writes the data at the end of the file.
TrueTrue TrueTrue Yes 이 변환은 디자인 타임 유효성 검사에 실패합니다.The transformation fails design time validation. 두 속성을 모두 true로 설정하면 안 됩니다.It is not valid to set both properties to true.

열 내보내기 변환 구성Configuration of the Export Column Transformation

다음과 같은 방법으로 열 내보내기 변환을 구성할 수 있습니다.You can configure the Export Column transformation in the following ways:

  • 데이터를 쓸 파일 경로가 포함된 열과 데이터 열을 지정합니다.Specify the data columns and the columns that contain the path of files to which to write the data.

  • 데이터 삽입 작업에서 기존 파일을 추가하거나 잘라낼지를 지정합니다.Specify whether the data-insertion operation appends or truncates existing files.

  • 파일에 BOM(바이트 순서 표시)을 쓸지를 지정합니다.Specify whether a byte-order mark (BOM) is written to the file.

    참고

    기존 파일에 데이터를 추가하지 않으며 데이터 형식이 DT_NTEXT인 경우에만 BOM이 기록됩니다.A BOM is written only when the data is not appended to an existing file and the data has the DT_NTEXT data type.

    이 변환은 입력 열의 쌍을 사용합니다. 그 중 하나에는 파일 이름이 있고 다른 하나에는 데이터가 있습니다.The transformation uses pairs of input columns: One column contains a file name, and the other column contains data. 데이터 집합의 각 행에서 서로 다른 파일을 지정할 수 있습니다.Each row in the data set can specify a different file. 변환이 행을 처리하면 지정한 파일에 데이터가 삽입됩니다.As the transformation processes a row, the data is inserted into the specified file. 런타임 시 파일이 존재하지 않을 경우 이 변환은 새로 파일을 만든 후 데이터를 해당 파일에 씁니다.At run time, the transformation creates the files, if they do not already exist, and then the transformation writes the data to the files. 기록될 데이터 형식은 DT_TEXT, DT_NTEXT 또는 DT_IMAGE여야 합니다.The data to be written must have a DT_TEXT, DT_NTEXT, or DT_IMAGE data type. 자세한 내용은 Integration Services Data Types을 참조하세요.For more information, see Integration Services Data Types.

    이 변환에는 하나의 입력, 하나의 출력 및 하나의 오류 출력이 있습니다.This transformation has one input, one output, and one error output.

    SSISSSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.You can set properties through SSISSSIS Designer or programmatically.

    고급 편집기 대화 상자에는 프로그래밍 방식으로 설정할 수 있는 속성이 표시됩니다.The Advanced Editor dialog box reflects the properties that can be set programmatically. 고급 편집기 대화 상자를 사용하거나 프로그래밍 방식으로 설정할 수 있는 속성에 대한 자세한 내용을 보려면 다음 항목 중 하나를 클릭하세요.For more information about the properties that you can set in the Advanced Editor dialog box or programmatically, click one of the following topics:

  • 공용 속성Common Properties

  • 변환 사용자 지정 속성Transformation Custom Properties

    속성을 설정하는 방법에 대한 자세한 내용은 데이터 흐름 구성 요소의 속성 설정을 참조하세요.For more information about how to set properties, see Set the Properties of a Data Flow Component.

열 내보내기 변환 편집기(열 페이지)Export Column Transformation Editor (Columns Page)

열 내보내기 변환 편집기 대화 상자의 페이지를 사용하여 데이터 흐름에서 파일로 추출할 열을 지정할 수 있습니다.Use the Columns page of the Export Column Transformation Editor dialog box to specify columns in the data flow to extract to files. 열 내보내기 변환 시 데이터를 파일에 추가할 것인지, 아니면 기존 파일을 덮어쓸 것인지를 지정할 수 있습니다.You can specify whether the Export Column transformation appends data to a file or overwrites an existing file.

옵션Options

추출 열Extract Column
텍스트 또는 이미지 데이터를 포함하는 입력 열 목록에서 선택합니다.Select from the list of input columns that contain text or image data. 모든 행에 추출 열파일 경로 열에 대한 정의가 있어야 합니다.All rows should have definitions for Extract Column and File Path Column.

파일 경로 열File Path Column
파일 경로 및 파일 이름을 포함하는 입력 열 목록에서 선택합니다.Select from the list of input columns that contain file paths and file names. 모든 행에 추출 열파일 경로 열에 대한 정의가 있어야 합니다.All rows should have definitions for Extract Column and File Path Column.

추가 허용Allow Append
변환 시 데이터를 기존 파일에 추가할 것인지 여부를 지정합니다.Specify whether the transformation appends data to existing files. 기본값은 false입니다.The default is false.

강제 자름Force Truncate
변환 시 데이터를 쓰기 전에 기존 파일의 내용을 삭제할 것인지를 지정합니다.Specify whether the transformation deletes the contents of existing files before writing data. 기본값은 false입니다.The default is false.

BOM 쓰기Write BOM
BOM(바이트 순서 표시)을 파일에 쓸 것인지 여부를 지정합니다.Specify whether to write a byte-order mark (BOM) to the file. 데이터 형식이 DT_NTEXT 또는 DT_WSTR이고 기존 데이터 파일에 추가되지 않는 경우에만 BOM을 씁니다.A BOM is only written if the data has the DT_NTEXT or DT_WSTR data type and is not appended to an existing data file.

열 내보내기 변환 편집기(오류 출력 페이지)Export Column Transformation Editor (Error Output Page)

열 내보내기 변환 편집기 대화 상자의 오류 출력 페이지를 사용하여 오류 처리 방법을 지정할 수 있습니다.Use the Error Output page of the Export Column Transformation Editor dialog box to specify how to handle errors.

옵션Options

입/출력Input/Output
출력의 이름을 확인합니다.View the name of the output. 이름을 클릭하여 열을 포함할 뷰를 확장할 수 있습니다.Click the name to expand the view to include columns.

Column
열 내보내기 변환 편집기 대화 상자의 페이지에서 선택한 출력 열을 표시합니다.View the output columns that you selected on the Columns page of the Export Column Transformation Editor dialog box.

오류Error
오류가 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Specify what you want to happen if an error occurs: ignore the failure, redirect the row, or fail the component.

잘림Truncation
잘림이 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Specify what you want to happen if a truncation occurs: ignore the failure, redirect the row, or fail the component.

DescriptionDescription
작업에 대한 설명을 표시합니다.View the description of the operation.

이 값을 선택한 셀에 설정Set this value to selected cells
오류나 잘림 발생 시 선택한 모든 셀에 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Specify what should happen to all the selected cells when an error or truncation occurs: ignore the failure, redirect the row, or fail the component.

적용Apply
선택한 셀에 오류 처리 옵션을 적용합니다.Apply the error handling option to the selected cells.