원시 파일 대상Raw File Destination

원시 파일 대상은 원시 데이터를 파일에 기록합니다.The Raw File destination writes raw data to a file. 대상의 기본 데이터 형식을 사용하므로 데이터를 변환하거나 구문 분석할 필요도 거의 없습니다.Because the format of the data is native to the destination, the data requires no translation and little parsing. 따라서 원시 파일 대상은 플랫 파일 및 OLE DB 대상과 같은 다른 대상보다 빨리 데이터를 기록할 수 있습니다.This means that the Raw File destination can write data more quickly than other destinations such as the Flat File and the OLE DB destinations.

원시 데이터를 파일에 기록하는 것 외에도 패키지를 실행할 필요 없이 원시 파일 대상을 사용하여 열만 포함된 비어 있는 원시 파일(메타데이터 전용 파일)을 생성할 수 있습니다.In addition to writing raw data to a file, you can also use the Raw File destination to generate an empty raw file that contains only the columns (metadata-only file), without having to run the package. 원시 파일 원본을 사용하면 대상이 이전에 기록한 원시 데이터를 검색할 수 있습니다.You use the Raw File source to retrieve raw data that was previously written by the destination. 또한 원시 파일 원본이 메타데이터 전용 파일을 가리키도록 설정할 수 있습니다.You can also point the Raw File source to the metadata-only file.

원시 파일 서식에는 정렬 정보가 포함됩니다.The raw file format contains sort information. 원시 파일 대상에는 문자열 열을 위한 비교 플래그를 포함하여 모든 정렬 정보가 저장됩니다.The Raw File Destination saves all the sort information including the comparison flags for string columns. 원시 파일 원본은 정렬 정보를 읽고 적용합니다.The Raw File source reads and honors the sort information. 고급 편집기를 사용하면 파일의 정렬 플래그를 무시하도록 원시 파일 원본을 구성할 수 있습니다.You do have the option of configuring the Raw File Source to ignore the sort flags in the file, using the Advanced Editor. 비교 플래그에 대한 자세한 내용은 Comparing String Data를 참조하십시오.For more information about comparison flags, see Comparing String Data.

다음과 같은 방법으로 원시 파일 대상을 구성할 수 있습니다.You can configure the Raw File destination in the following ways:

  • 원시 파일 대상이 기록할 파일 이름 또는 파일 이름이 포함된 변수인 액세스 모드를 지정합니다.Specify an access mode which is either the name of the file or a variable that contains the name of the file to which the Raw File destination writes.

  • 원시 파일 대상이 같은 이름의 기존 파일에 데이터를 추가할지 아니면 새 파일을 만들지 여부를 나타냅니다.Indicate whether the Raw File destination appends data to an existing file that has the same name or creates a new file.

    원시 파일 대상은 패키지 실행 사이에 부분적으로 처리된 데이터의 결과를 즉시 기록하는 데 자주 사용됩니다.The Raw File destination is frequently used to write intermediary results of partly processed data between package executions. 원시 데이터를 저장하면 원시 파일 원본에서 데이터를 신속하게 읽고 최종 대상에 로드되기 전에 추가 변환을 수행할 수 있습니다.Storing raw data means that the data can be read quickly by a Raw File source and then further transformed before it is loaded into its final destination. 예를 들어 패키지를 여러 번 실행하고 이 때마다 원시 데이터를 파일에 기록할 수 있습니다.For example, a package might run several times, and each time write raw data to files. 그런 다음에는 다른 패키지에서 원시 파일 원본을 사용하여 각 파일에서 데이터를 읽고, UNION ALL 변환을 사용하여 데이터를 하나의 데이터 집합으로 병합한 다음 SQL ServerSQL Server 테이블과 같은 최종 대상으로 데이터를 로드하기 전에 데이터를 요약하는 추가 변환을 적용할 수 있습니다.Later, a different package can use the Raw File source to read from each file, use a Union All transformation to merge the data into one data set, and then apply additional transformations that summarize the data before loading the data into its final destination such as a SQL ServerSQL Server table.

참고

원시 파일 대상은 BLOB(Binary Large Object) 데이터를 제외한 Null 데이터를 지원합니다.The Raw File destination supports null data but not binary large object (BLOB) data.

참고

원시 파일 대상에는 연결 관리자가 사용되지 않습니다.The Raw File destination does not use a connection manager.

이 원본에는 하나의 일반 입력이 있습니다.This source has one regular input. 오류 출력은 지원하지 않습니다.It does not support an error output.

추가 및 새 파일 옵션Append and New File Options

WriteOption 속성에는 기존 파일에 데이터를 추가하거나 새 파일을 만드는 옵션이 포함됩니다.The WriteOption property includes options to append data to an existing file or create a new file.

다음 표에서는 WriteOption 속성에서 사용할 수 있는 옵션에 대해 설명합니다.The following table describes the available options for the WriteOption property.

옵션Option DescriptionDescription
추가Append 기존 파일에 데이터를 추가합니다.Appends data to an existing file. 추가된 데이터의 메타데이터가 해당 파일 형식과 일치해야 합니다.The metadata of the appended data must match the file format.
항상 만들기Create always 항상 새 파일을 만듭니다.Always creates a new file.
한 번 만들기Create once 새 파일을 만듭니다.Creates a new file. 파일이 있는 경우 구성 요소가 실패합니다.If the file exists, the component fails.
잘라내기 및 추가Truncate and append 기존 파일을 잘라낸 다음 데이터를 파일에 기록합니다.Truncates an existing file and then writes the data to the file. 추가된 데이터의 메타데이터가 해당 파일 형식과 일치해야 합니다.The metadata of the appended data must match the file format.

다음은 데이터 추가와 관련된 중요한 항목입니다.The following are important items about appending data:

  • 기존 원시 파일에 데이터를 추가해도 데이터가 다시 정렬되지 않습니다.Appending data to an existing raw file does not re-sort the data.

    정렬된 키가 올바른 순서인지 확인해야 합니다.You need to make certain that the sorted keys remain in the correct order.

  • 기존 원시 파일에 데이터를 추가해도 파일 메타데이터(정렬 정보)는 변경되지 않습니다.Appending data to an existing raw file does not change the file metadata (sort information).

    예를 들어 패키지는 ProductKey(PK)로 정렬된 데이터를 읽습니다.For example, a package reads data sorted on the ProductKey (PK). 패키지 데이터 흐름은 데이터를 기존 원시 파일에 추가합니다.The package data flow appends the data to an existing raw file. 패키지를 처음 실행하면 PK 1000, 1100, 1200의 세 개 행이 수신됩니다.The first time the package runs, three rows are received (PK 1000, 1100, 1200). 원시 파일에는 이제 다음과 같은 데이터가 포함됩니다.The raw file now contains the following data.

  • 1000, productA1000, productA

  • 1100, productB1100, productB

  • 1200, productC1200, productC

    패키지를 두 번째로 실행하면 PK 1001, 1300의 새로운 두 행이 수신됩니다.The second time the package runs, two new rows are received (PK 1001, 1300). 원시 파일에는 이제 다음과 같은 데이터가 포함됩니다.The raw file now contains the following data.

  • 1000, productA1000, productA

  • 1100, productB1100, productB

  • 1200, productC1200, productC

  • 1001, productD1001, productD

  • 1300, productE1300, productE

    새 데이터가 원시 파일의 끝에 추가되고 정렬된 키(PK)의 순서가 뒤섞입니다.The new data is appended to the end of the raw file, and the sorted keys (PK) are out of order. 또한 추가 작업으로 파일 메타데이터(정렬 정보)는 변경되지 않았습니다.In addition, the append operation didn’t change the file metadata (sort information). 원시 파일 원본을 사용하여 이 파일을 읽으면 이 파일의 데이터가 더 이상 올바른 순서가 아니더라도 구성 요소에 이 파일이 여전히 PK로 정렬된 것으로 표시됩니다.If you read the file by using the Raw File source, the component indicates that the file is still sorted on PK even though the data in the file is no longer in the correct order.

    데이터를 추가할 때 정렬된 키를 올바른 순서로 유지하기 위해서는 패키지 데이터 흐름을 다음과 같이 디자인할 수 있습니다.To keep the sorted keys in the correct order while appending data, you can design the package data flow as follows:

  1. 원본 A를 사용하여 새 행을 검색합니다.Retrieve new rows by using Source A.

  2. 원본 B를 사용하여 RawFile1에서 기존 행을 검색합니다.Retrieve existing rows from RawFile1 using Source B.

  3. UNION ALL 변환을 사용하여 원본 A와 원본 B의 입력을 조합합니다.Combine the inputs from Source A and Source B by using the Union All transformation.

  4. PK로 정렬합니다.Sort on PK.

  5. 원시 파일 대상을 사용하여 RawFile2에 기록합니다.Write to RawFile2 by using the Raw File destination.

    RawFile1은 데이터 흐름에서 읽는 중이므로 잠겨 있습니다.RawFile1 is locked because it’s being read from, in the data flow.

  6. RawFile1을 RawFile2로 바꿉니다.Replace RawFile1 with RawFile2.

루프에서 원시 파일 대상 사용Using the Raw File Destination in a Loop

원시 파일 대상을 사용하는 데이터 흐름이 루프에 있는 경우 파일을 한 번만 만들고 루프가 반복되면 파일에 데이터를 추가할 수 있습니다.If the data flow that uses the Raw File destination is in a loop, you may want to create the file once and then append data to the file when the loop repeats. 파일에 데이터를 추가하려면 추가되는 데이터는 기존 파일의 형식과 일치해야 합니다.To append data to the file, the data that is appended must match the format of the existing file.

루프의 첫 번째 반복에서 파일을 만든 다음 루프의 후속 반복에서 행을 추가하려면 디자인 타임에 다음을 수행해야 합니다.To create the file in the first iteration of the loop, and then append rows in the subsequent iterations of the loop, you need to do the following at design time:

  1. WriteOption 속성을 CreateOnce 또는 CreateAlways로 설정하고 루프의 반복 하나를 실행합니다.Set the WriteOption property to CreateOnce or CreateAlwaysand run one iteration of the loop. 파일이 생성됩니다.The file is created. 이렇게 하면 추가된 데이터와 파일의 메타데이터가 일치하게 됩니다.This ensures that the metadata of appended data and the file matches.

  2. WriteOption 속성을 Append 로 다시 설정하고 ValidateExternalMetadata 속성을 False로 설정합니다.Reset the WriteOption property to Append and set the ValidateExternalMetadata property to False.

    Append 옵션 대신에 TruncateAppend 옵션을 사용할 경우 이전 반복에서 추가된 행이 잘리고 새 행이 추가됩니다.If you use the TruncateAppend option instead of the Append option, it will truncate rows that were added in any previous iteration, and then append new rows. TruncateAppend 옵션을 사용할 경우에도 데이터가 파일 형식과 일치해야 합니다.Using the TruncateAppend option also requires that the data matches the file format.

원시 파일 대상 구성Configuration of the Raw File Destination

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:

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

sqlservercentral.com의 블로그 항목 - 원시 파일의 놀라운 기능Blog entry, Raw Files Are Awesome, on sqlservercentral.com.

원시 파일 대상 편집기(연결 관리자 페이지)Raw File Destination Editor (Connection Manager Page)

원시 파일 대상 편집기를 사용하여 원시 데이터를 파일에 기록하도록 원시 파일 대상을 구성합니다.Use the Raw File Destination Editor to configure the Raw File destination to write raw data to a file.

수행 작업What do you want to do?

원시 파일 대상 편집기 열기 Open the Raw File Destination Editor

  1. Integration ServicesIntegration Services 에서 원시 파일 대상을 SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT)패키지에 추가합니다.Add the Raw File destination to an Integration ServicesIntegration Services package, in SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT).

  2. 구성 요소를 마우스 오른쪽 단추로 클릭한 다음 편집을 클릭합니다.Right-click the component and then click Edit.

연결 관리자 탭에서 옵션 설정 Set options on the Connection Manager tab

액세스 모드Access mode
파일 이름 지정 방법을 선택합니다.Select how the file name is specified. 파일 이름 을 선택하여 파일 이름 및 경로를 직접 입력하고 변수를 사용한 파일 이름 을 선택하여 파일 이름이 포함된 변수를 지정합니다.Select File name to enter the file name and path directly, of File name from variable to specify a variable that contains the file name.

파일 이름 또는 변수 이름File name or Variable name
원시 파일의 이름과 경로를 입력하거나 파일 이름이 포함된 변수를 선택합니다.Enter the name and path of the raw file, or select the variable that contains the file name.

쓰기 옵션Write option
파일을 만들고 파일에 쓰는 데 사용할 메서드를 선택합니다.Select the method used to create and write to the file.

초기 원시 파일 생성Generate initial raw file
패키지를 실행할 필요 없이 열만 포함된 빈 원시 파일(메타데이터 전용 파일)을 생성하려면 단추를 클릭합니다.Click the button to generate an empty raw file that contains only the columns (metadata-only file), without having to run the package. 파일에는 원시 파일 대상 편집기페이지에서 선택한 열이 포함됩니다.The file contains the columns that you selected on the Columns page of the Raw File Destination Editor. 원시 파일 원본이 이 메타데이터 전용 파일을 가리키도록 설정할 수 있습니다.You can point the Raw File source to this metadata-only file.

초기 원시 파일 생성을 누르면 메시지 상자가 표시됩니다.When you click Generate initial raw file, a message box appears. 확인 을 클릭하여 파일 만들기를 계속합니다.Click OK to proceed with creating the file. 페이지의 서로 다른 열 목록을 선택하려면 취소 를 클릭합니다.Click Cancel to select a different list of columns on the Columns page.

열 탭에서 옵션 설정 Set options on the Columns tab

사용 가능한 입력 열Available Input Columns
원시 파일에 쓸 하나 이상의 입력 열을 선택합니다.Select one or more input columns to write to the raw file.

입력 열Input Column
입력 열은 사용 가능한 입력 열에서 선택할 경우 이 테이블에 자동으로 추가되거나 이 테이블에서 입력 열을 직접 선택할 수 있습니다.An input column is automatically added to this table when you select it under Available Input Columns, or you can select the input column directly in this table.

출력 별칭Output Alias
출력 열에 사용할 대체 이름을 지정합니다.Specify an alternate name to use for the output column.

원시 파일 대상 편집기(열 페이지)Raw File Destination Editor (Columns Page)

원시 파일 대상 편집기를 사용하여 원시 데이터를 파일에 기록하도록 원시 파일 대상을 구성합니다.Use the Raw File Destination Editor to configure the Raw File destination to write raw data to a file.

수행 작업What do you want to do?

원시 파일 대상 편집기 열기 Open the Raw File Destination Editor

  1. Integration ServicesIntegration Services 에서 원시 파일 대상을 SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT)패키지에 추가합니다.Add the Raw File destination to an Integration ServicesIntegration Services package, in SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT).

  2. 구성 요소를 마우스 오른쪽 단추로 클릭한 다음 편집을 클릭합니다.Right-click the component and then click Edit.

연결 관리자 탭에서 옵션 설정 Set options on the Connection Manager tab

액세스 모드Access mode
파일 이름 지정 방법을 선택합니다.Select how the file name is specified. 파일 이름 을 선택하여 파일 이름 및 경로를 직접 입력하고 변수를 사용한 파일 이름 을 선택하여 파일 이름이 포함된 변수를 지정합니다.Select File name to enter the file name and path directly, of File name from variable to specify a variable that contains the file name.

파일 이름 또는 변수 이름File name or Variable name
원시 파일의 이름과 경로를 입력하거나 파일 이름이 포함된 변수를 선택합니다.Enter the name and path of the raw file, or select the variable that contains the file name.

쓰기 옵션Write option
파일을 만들고 파일에 쓰는 데 사용할 메서드를 선택합니다.Select the method used to create and write to the file.

초기 원시 파일 생성Generate initial raw file
패키지를 실행할 필요 없이 열만 포함된 빈 원시 파일(메타데이터 전용 파일)을 생성하려면 단추를 클릭합니다.Click the button to generate an empty raw file that contains only the columns (metadata-only file), without having to run the package. 원시 파일 원본이 메타데이터 전용 파일을 가리키도록 설정할 수 있습니다.You can point the Raw File source to the metadata-only file.

단추를 클릭하면 열 목록이 나타납니다.When you click the button, a list of the columns appears. 취소를 클릭하고 열을 수정하거나 확인을 클릭하여 파일 만들기를 계속할 수 있습니다.You can click cancel and modify the columns or click OK to proceed with creating the file.

열 탭에서 옵션 설정 Set options on the Columns tab

사용 가능한 입력 열Available Input Columns
원시 파일에 쓸 하나 이상의 입력 열을 선택합니다.Select one or more input columns to write to the raw file.

입력 열Input Column
입력 열은 사용 가능한 입력 열에서 선택할 경우 이 테이블에 자동으로 추가되거나 이 테이블에서 입력 열을 직접 선택할 수 있습니다.An input column is automatically added to this table when you select it under Available Input Columns, or you can select the input column directly in this table.

출력 별칭Output Alias
출력 열에 사용할 대체 이름을 지정합니다.Specify an alternate name to use for the output column.

관련 항목:See Also

원시 파일 원본 Raw File Source
데이터 흐름Data Flow