원시 파일 대상

적용 대상: SQL Server Azure Data Factory의 SSIS Integration Runtime

원시 파일 대상은 원시 데이터를 파일에 씁니다. 데이터 형식은 대상에 기본이므로 데이터에는 변환 및 구문 분석이 거의 필요하지 않습니다. 즉, 원시 파일 대상은 플랫 파일 및 OLE DB 대상과 같은 다른 대상보다 더 빠르게 데이터를 쓸 수 있습니다.

원시 데이터를 파일에 쓰는 것 외에도 원시 파일 대상을 사용하여 패키지를 실행하지 않고도 열(메타데이터 전용 파일)만 포함하는 비어있는 원시 파일을 생성할 수 있습니다. 원시 파일 원본을 사용하여 대상에서 이전에 작성한 원시 데이터를 검색합니다. 원시 파일 원본을 메타데이터 전용 파일로 가리킬 수도 있습니다.

원시 파일 형식에는 정렬 정보가 포함됩니다. 원시 파일 대상은 문자열 열에 대한 비교 플래그를 포함하여 모든 정렬 정보를 저장합니다. 원시 파일 원본은 정렬 정보를 읽고 적용합니다. 고급 편집기 사용하여 파일의 정렬 플래그를 무시하도록 원시 파일 원본을 구성하는 옵션이 있습니다. 비교 플래그에 대한 자세한 내용은 문자열 데이터 비교를 참조하세요.

다음과 같은 방법으로 원시 파일 대상을 구성할 수 있습니다.

  • 파일의 이름 또는 원시 파일 대상에서 쓰는 파일의 이름을 포함하는 변수인 액세스 모드를 지정합니다.

  • 원시 파일 대상이 이름이 같은 기존 파일에 데이터를 추가하거나 새 파일을 만드는지 여부를 나타냅니다.

원시 파일 대상은 패키지 실행 사이에 부분적으로 처리된 데이터의 결과를 즉시 기록하는 데 자주 사용됩니다. 원시 데이터를 저장하면 원시 파일 원본에서 데이터를 신속하게 읽고 최종 대상에 로드되기 전에 추가 변환을 수행할 수 있습니다. 예를 들어 패키지는 여러 번 실행될 수 있으며 매번 원시 데이터를 파일에 쓸 수 있습니다. 그런 다음에는 다른 패키지에서 원시 파일 원본을 사용하여 각 파일에서 데이터를 읽고, Union All 변환을 사용하여 데이터를 하나의 데이터 세트로 병합한 다음, SQL Server 테이블과 같은 최종 대상으로 데이터를 로드하기 전에 데이터를 요약하는 추가 변환을 적용할 수 있습니다.

참고 항목

원시 파일 대상은 Null 데이터를 지원하지만 BLOB(Binary Large Object) 데이터는 지원하지 않습니다.

참고 항목

원시 파일 대상에는 연결 관리자가 사용되지 않습니다.

이 원본에는 하나의 일반 입력이 있습니다. 오류 출력은 지원하지 않습니다.

추가 및 새 파일 옵션

WriteOption 속성에는 기존 파일에 데이터를 추가하거나 새 파일을 만드는 옵션이 포함되어 있습니다.

다음 표에서는 WriteOption 속성에서 사용할 수 있는 옵션에 대해 설명합니다.

옵션 설명
Append 기존 파일에 데이터를 추가합니다. 추가된 데이터의 메타데이터는 파일 형식과 일치해야 합니다.
항상 만들기 항상 새 파일을 만듭니다.
한 번 만들기 새 파일을 만듭니다. 파일이 있으면 구성 요소가 실패합니다.
잘라내기 및 추가 기존 파일을 자르고 파일에 데이터를 씁니다. 추가된 데이터의 메타데이터는 파일 형식과 일치해야 합니다.

다음은 데이터 추가에 대한 중요한 항목입니다.

  • 기존 원시 파일에 데이터를 추가해도 데이터가 다시 정렬되지 않습니다.

    정렬된 키가 올바른 순서로 유지되도록 해야 합니다.

  • 기존 원시 파일에 데이터를 추가해도 파일 메타데이터(정렬 정보)는 변경되지 않습니다.

예를 들어 패키지는 ProductKey(PK)에서 정렬된 데이터를 읽습니다. 패키지 데이터 흐름은 데이터를 기존 원시 파일에 추가합니다. 패키지가 처음 실행되면 세 개의 행이 수신됩니다(PK 1000, 1100, 1200). 원시 파일에는 다음 데이터가 포함됩니다.

  • 1000, productA

  • 1100, productB

  • 1200, productC

패키지가 두 번째로 실행되면 두 개의 새 행이 수신됩니다(PK 1001, 1300). 원시 파일에는 다음 데이터가 포함됩니다.

  • 1000, productA

  • 1100, productB

  • 1200, productC

  • 1001, productD

  • 1300, productE

새 데이터는 원시 파일의 끝에 추가되고 정렬된 키(PK)는 순서가 다릅니다. 또한 추가 작업은 파일 메타데이터(정렬 정보)를 변경하지 않았습니다. 원시 파일 원본을 사용하여 파일을 읽는 경우 구성 요소는 파일의 데이터가 더 이상 올바른 순서가 아니더라도 파일이 PK에서 정렬됨을 나타냅니다.

데이터를 추가하는 동안 정렬된 키를 올바른 순서로 유지하려면 다음과 같이 패키지 데이터 흐름을 디자인할 수 있습니다.

  1. 원본 A를 사용하여 새 행을 검색합니다.

  2. 원본 B를 사용하여 RawFile1에서 기존 행을 검색합니다.

  3. UNION ALL 변환을 사용하여 원본 A와 원본 B의 입력을 조합합니다.

  4. PK로 정렬합니다.

  5. 원시 파일 대상을 사용하여 RawFile2에 기록합니다.

    RawFile1은 데이터 흐름에서 읽기 때문에 잠겨 있습니다.

  6. RawFile1을 RawFile2로 대체합니다.

루프에서 원시 파일 대상 사용

원시 파일 대상을 사용하는 데이터 흐름이 루프에 있는 경우 파일을 한 번 만든 다음 루프가 반복될 때 파일에 데이터를 추가할 수 있습니다. 파일에 데이터를 추가하려면 추가되는 데이터는 기존 파일의 형식과 일치해야 합니다.

루프의 첫 번째 반복에서 파일을 만든 다음 루프의 후속 반복에 행을 추가하려면 디자인 타임에 다음을 수행해야 합니다.

  1. WriteOption 속성을 CreateOnce 또는 CreateAlways로 설정하고 루프를 한 번 반복 실행합니다. 파일이 생성됩니다. 이렇게 하면 추가된 데이터 및 파일의 메타데이터가 일치합니다.

  2. WriteOption 속성을 Append 로 다시 설정하고 ValidateExternalMetadata 속성을 False로 설정합니다.

추가 옵션 대신 TruncateAppend 옵션을 사용하는 경우 이전 반복에 추가된 행을 잘라 새 행을 추가합니다. TruncateAppend 옵션을 사용하려면 데이터가 파일 형식과 일치해야 합니다.

원시 파일 집합 대상 구성

SSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.

고급 편집기 대화 상자에는 프로그래밍 방식으로 설정할 수 있는 속성이 표시됩니다. 고급 편집기 대화 상자를 사용하거나 프로그래밍 방식으로 설정할 수 있는 속성에 대한 자세한 내용을 보려면 다음 항목 중 하나를 클릭하세요.

구성 요소의 속성을 설정하는 방법에 대한 자세한 내용은 데이터 흐름 구성 요소의 속성 설정을 참조하세요.

sqlservercentral.com의 블로그 항목 - 원시 파일의 놀라운 기능

원시 파일 대상 편집기(연결 관리자 페이지)

원시 파일 대상 편집기를 사용하여 원시 데이터를 파일에 쓰도록 원시 파일 대상을 구성합니다.

수행 작업

원시 파일 대상 편집기 열기

  1. SSDT(SQL Server Data Tools)에서 Integration Services 패키지에 원시 파일 대상을 추가합니다.

  2. 구성 요소를 마우스 오른쪽 단추로 누른 편집합니다.

연결 관리자 탭에서 옵션 설정

액세스 모드
파일 이름 지정 방법을 선택합니다. 파일 이름을 직접 입력하려면 파일 이름을 선택하고, 파일 이름이 포함된 변수를 지정하려면 변수에서 파일 이름 중 파일 이름과 경로를 직접 입력합니다.

파일 이름 또는 변수 이름
원시 파일의 이름과 경로를 입력하거나 파일 이름이 포함된 변수를 선택합니다.

쓰기 옵션
파일을 만들고 파일에 쓰는 데 사용할 메서드를 선택합니다.

초기 원시 파일 생성
단추를 클릭하여 패키지를 실행하지 않고 열(메타데이터 전용 파일)만 포함하는 비어있는 원시 파일을 생성합니다. 파일에는 원시 파일 대상 편집기 페이지에서 선택한 열이 포함됩니다. 원시 파일 원본을 이 메타데이터 전용 파일로 가리킬 수 있습니다.

초기 원시 파일 생성을 클릭하면 메시지 상자가 나타납니다. 확인을 클릭하여 파일 생성을 계속합니다. 취소를 클릭하여 페이지에서 다른 열 목록을 선택합니다.

열 탭에서 옵션 설정

사용 가능한 입력 열
원시 파일에 쓸 하나 이상의 입력 열을 선택합니다.

입력 열
입력 열은 사용 가능한 입력 열에서 선택할 경우 이 테이블에 자동으로 추가되거나 이 테이블에서 입력 열을 직접 선택할 수 있습니다.

출력 별칭
출력 열에 사용할 대체 이름을 지정합니다.

원시 파일 대상 편집기(열 페이지)

원시 파일 대상 편집기를 사용하여 원시 데이터를 파일에 쓰도록 원시 파일 대상을 구성합니다.

수행 작업

원시 파일 대상 편집기 열기

  1. SSDT(SQL Server Data Tools)에서 Integration Services 패키지에 원시 파일 대상을 추가합니다.

  2. 구성 요소를 마우스 오른쪽 단추로 누른 편집합니다.

연결 관리자 탭에서 옵션 설정

액세스 모드
파일 이름 지정 방법을 선택합니다. 파일 이름을 직접 입력하려면 파일 이름을 선택하고, 파일 이름이 포함된 변수를 지정하려면 변수에서 파일 이름 중 파일 이름과 경로를 직접 입력합니다.

파일 이름 또는 변수 이름
원시 파일의 이름과 경로를 입력하거나 파일 이름이 포함된 변수를 선택합니다.

쓰기 옵션
파일을 만들고 파일에 쓰는 데 사용할 메서드를 선택합니다.

초기 원시 파일 생성
단추를 클릭하여 패키지를 실행하지 않고 열(메타데이터 전용 파일)만 포함하는 비어있는 원시 파일을 생성합니다. 원시 파일 원본을 메타데이터 전용 파일로 가리킬 수 있습니다.

단추를 클릭하면 열 목록이 나타납니다. 취소를 클릭하고 열을 수정하거나 확인을 클릭하여 파일 만들기를 진행할 수 있습니다.

열 탭에서 옵션 설정

사용 가능한 입력 열
원시 파일에 쓸 하나 이상의 입력 열을 선택합니다.

입력 열
입력 열은 사용 가능한 입력 열에서 선택할 경우 이 테이블에 자동으로 추가되거나 이 테이블에서 입력 열을 직접 선택할 수 있습니다.

출력 별칭
출력 열에 사용할 대체 이름을 지정합니다.

참고 항목

원시 파일 원본
데이터 흐름