Flat File Connection Manager

  • 아티클

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

플랫 파일 연결 관리자를 사용하면 패키지에서 플랫 파일의 데이터에 액세스할 수 있습니다. 예를 들어 플랫 파일 원본 및 대상은 플랫 파일 연결 관리자를 사용하여 데이터를 추출 및 로드할 수 있습니다.

플랫 파일 연결 관리자는 하나의 파일만 액세스할 수 있습니다. 파일을 여러 개 참조하려면 플랫 파일 연결 관리자 대신 다중 플랫 파일 연결 관리자를 사용하십시오. 자세한 내용은 Multiple Flat Files Connection Manager을 참조하세요.

열 길이

기본적으로 플랫 파일 연결 관리자는 문자열 열의 길이를 50자로 설정합니다. 플랫 파일 연결 관리자 편집기 대화 상자에서 샘플 데이터를 평가하고 이러한 열의 길이를 자동으로 조정하여 데이터가 잘리지 않거나 열 너비를 초과하지 않도록 할 수 있습니다. 또한 플랫 파일 원본 또는 변환에서 열 길이를 나중에 조정하지 않는 한 문자열 열 길이가 데이터 흐름 전체에서 동일하게 유지됩니다. 이러한 문자열 열이 보다 좁은 대상 열에 매핑되면 사용자 인터페이스에 경고가 나타나고 런타임 시 데이터 잘림으로 인한 오류가 발생할 수 있습니다. 오류나 잘림이 발생하지 않도록 하기 위해 플랫 파일 연결 관리자, 플랫 파일 원본 또는 변환에서 대상 열과 호환 가능하도록 열 크기를 조정할 수 있습니다. 출력 열의 길이를 수정하려면 고급 편집기 대화 상자의 입/출력 속성 탭에서 출력 열의 Length 속성을 설정합니다.

연결 관리자를 사용하는 플랫 파일 원본을 추가 및 구성한 후에 플랫 파일 연결 관리자에서 열 길이를 업데이트한 경우에는 플랫 파일 원본에서 출력 열의 크기를 수동으로 조정하지 않아도 됩니다. 플랫 파일 원본 대화 상자를 열면 플랫 파일 원본에 열 메타데이터를 동기화하는 옵션이 제공됩니다.

플랫 파일 연결 관리자 구성

패키지에 플랫 파일 연결 관리자를 추가하면 SQL Server Integration Services에서 런타임에 플랫 파일 연결로 확인되는 연결 관리자를 만들고, 플랫 파일 연결 속성을 설정하며, 플랫 파일 연결 관리자를 패키지의 Connections 컬렉션에 추가합니다.

연결 관리자의 ConnectionManagerType 속성이 FLATFILE로 설정됩니다.

기본적으로 플랫 파일 연결 관리자는 따옴표로 표시되지 않은 데이터에서 항상 행 구분자를 검사하고 행 구분자를 찾으면 새 행을 시작합니다. 그러면 연결 관리자가 열 필드가 누락된 행을 사용하여 파일을 올바르게 구문 분석할 수 있습니다.

일부 경우에는 이 기능을 비활성화해야 패키지 성능이 향상될 수 있습니다. 플랫 파일 연결 관리자 속성 AlwaysCheckForRowDelimiters를 False로 설정하여 이 기능을 비활성화할 수 있습니다.

다음과 같은 방법으로 플랫 파일 연결 관리자를 구성할 수 있습니다.

  • 사용할 파일, 로캘 및 코드 페이지를 지정합니다. 로캘은 날짜 같은 로캘 구분 데이터를 해석하는 데 사용되고 코드 페이지는 문자열 데이터를 유니코드로 변환하는 데 사용됩니다.

  • 파일 형식을 지정합니다. 구분 기호로 분리된 형식, 고정 폭 형식 또는 왼쪽 정렬 형식을 사용할 수 있습니다.

  • 머리글 행, 데이터 행 및 열 구분 기호를 지정합니다. 열 구분 기호는 파일 수준에서 설정하고 열 수준에서 덮어쓸 수 있습니다.

  • 파일의 첫 번째 행에 열 이름이 포함되는지 여부를 나타냅니다.

  • 텍스트 한정자 문자를 지정합니다. 텍스트 한정자를 인식하도록 각 열을 구성할 수 있습니다.

    한정자 문자를 사용하여 한정된 문자열에 한정자 문자를 포함할 수 있는 기능이 플랫 파일 연결 관리자에서 지원됩니다. 텍스트 한정자가 두 번 나올 경우 해당 문자열이 한 번 나온 것처럼 리터럴로 해석됩니다. 예를 들어 텍스트 한정자가 작은따옴표이고 입력 데이터가 'abc', 'def', 'g'hi'인 경우 출력 데이터는 abc, def, g'hi입니다. 그러나 한정된 문자열에 포함된 한정자의 인스턴스로 인해 DTS_E_PRIMEOUTPUTFAILED 오류가 발생하며 플랫 파일 원본이 실패하게 됩니다.

  • 개별 열에 대해 이름, 데이터 형식 및 최대 너비와 같은 속성을 설정합니다.

SSDT(SQL Server Data Tools)의 속성 창에 식을 지정하여 플랫 파일 연결 관리자에 대한 ConnectionString 속성을 설정할 수 있습니다. 유효성 검사 오류를 방지하려면 다음을 수행합니다.

  • 식을 사용해서 파일을 지정할 경우, 플랫 파일 연결 관리자 편집기 의 파일 이름상자에 파일 경로를 추가합니다.

  • 플랫 파일 연결 관리자에서 DelayValidation 속성을 True로 설정합니다.

플랫 파일 연결 관리자에서 플랫 파일 대상에 식을 사용하여 런타임에 파일 이름을 만들 수 있습니다.

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

연결 관리자를 프로그래밍 방식으로 구성하는 방법에 대한 자세한 내용은 ConnectionManager 및 프로그래밍 방식으로 연결 추가로 설정됩니다.

플랫 파일 연결 관리자 편집기(일반 페이지)

플랫 파일 연결 관리자 편집기 대화 상자의 일반 페이지를 사용하여 파일과 데이터 형식을 선택할 수 있습니다. 플랫 파일 연결을 사용하면 패키지를 텍스트 파일에 연결할 수 있습니다.

플랫 파일 연결 관리자에 대한 자세한 내용은 Flat File Connection Manager를 참조하십시오.

옵션

연결 관리자 이름
워크플로의 플랫 파일 연결에 고유한 이름을 지정합니다. 제공한 이름은 SSIS 디자이너에 표시됩니다.

설명
연결에 대한 설명을 입력합니다. 해당 연결의 용도를 설명하여 패키지를 이해하기 쉽고 유지 관리하기 편하도록 만드는 것이 가장 좋습니다.

파일 이름
플랫 파일 연결에 사용할 경로와 파일 이름을 입력합니다.

찾아보기
플랫 파일 연결에 사용할 파일 이름을 찾습니다.

로캘
정렬과 날짜 및 시간 형식에 사용할 언어별 정보를 제공하는 로캘을 지정합니다.

유니코드
유니코드를 사용할지 여부를 나타냅니다. 유니코드를 사용하면 코드 페이지를 지정할 수 없습니다.

코드 페이지
비유니코드 텍스트에 대한 코드 페이지를 지정합니다.

형식
구분 기호로 분리됨, 고정 폭, 왼쪽 정렬 중 어떤 형식을 사용할지를 지정합니다.

값 Description
구분됨 열 페이지에 지정된 구분 기호로 열을 구분합니다.
고정 폭 열에 고정 폭이 지정됩니다.
왼쪽 정렬 왼쪽 정렬 파일은 마지막 열을 제외한 모든 열에 고정 폭이 지정된 파일입니다. 마지막 열은 행 구분 기호로 구분됩니다.

텍스트 한정자
사용할 텍스트 한정자를 지정합니다. 예를 들어 텍스트 필드를 따옴표로 묶도록 지정할 수 있습니다.

참고

텍스트 한정자를 선택한 후에는 없음 옵션을 다시 선택할 수 없습니다. 텍스트 한정자의 선택을 취소하려면 없음 을 입력합니다.

머리글 행 구분 기호
구분 기호 목록에서 머리글 행 구분 기호를 선택하거나 구분 기호 텍스트를 입력합니다.

값 설명
{CR}{LF} 머리글 행을 캐리지 리턴-줄 바꿈 조합으로 구분합니다.
{CR} 머리글 행을 캐리지 리턴으로 구분합니다.
{LF} 머리글 행을 줄 바꿈으로 구분합니다.
세미콜론 {;} 머리글 행을 세미콜론으로 구분합니다.
콜론 {:} 머리글 행을 콜론으로 구분합니다.
쉼표 {,} 머리글 행을 쉼표로 구분합니다.
탭 {t} 머리글 행을 탭으로 구분합니다.
세로 막대 {|} 머리글 행을 세로 막대로 구분합니다.

건너뛸 머리글 행
건너뛸 머리글 행 또는 초기 데이터 행 수를 지정합니다(있는 경우).

첫 번째 데이터 행의 열 이름
첫 번째 데이터 행에 열 이름을 제공할지 여부를 나타냅니다.

플랫 파일 연결 관리자 편집기(열 페이지)

플랫 파일 연결 관리자 편집기 대화 상자의 열 페이지를 사용하여 행 및 열 정보를 지정하고 파일을 미리 볼 수 있습니다.

플랫 파일 연결 관리자에 대한 자세한 내용은 Flat File Connection Manager를 참조하십시오.

정적 옵션

연결 관리자 이름
워크플로의 플랫 파일 연결에 고유한 이름을 지정합니다. 제공한 이름은 SSIS 디자이너에 표시됩니다.

설명
연결에 대한 설명을 입력합니다. 해당 연결의 용도를 설명하여 패키지를 이해하기 쉽고 유지 관리하기 편하도록 만드는 것이 가장 좋습니다.

플랫 파일 형식 동적 옵션

형식 = 구분 기호로 분리됨

행 구분 기호
사용 가능한 행 구분 기호의 목록에서 선택하거나 구분 기호 텍스트를 입력합니다.

값 설명
{CR}{LF} 행이 캐리지 리턴-줄 바꿈 조합으로 구분됩니다.
{CR} 행이 캐리지 리턴으로 구분됩니다.
{LF} 행이 줄 바꿈으로 구분됩니다.
세미콜론 {;} 행이 세미콜론으로 구분됩니다.
콜론 {:} 행이 콜론으로 구분됩니다.
쉼표 {,} 행이 쉼표로 구분됩니다.
탭 {t} 행이 탭으로 구분됩니다.
세로 막대 {|} 행이 세로 막대로 구분됩니다.

열 구분 기호
사용 가능한 열 구분 기호의 목록에서 선택하거나 구분 기호 텍스트를 입력합니다.

값 설명
{CR}{LF} 열이 캐리지 리턴-줄 바꿈 조합으로 구분됩니다.
{CR} 열이 캐리지 리턴으로 구분됩니다.
{LF} 열이 줄 바꿈으로 구분됩니다.
세미콜론 {;} 열이 세미콜론으로 구분됩니다.
콜론 {:} 열이 콜론으로 구분됩니다.
쉼표 {,} 열이 쉼표로 구분됩니다.
탭 {t} 열이 탭으로 구분됩니다.
세로 막대 {|} 열이 세로 막대로 구분됩니다.

새로 고침
새로 고침을 클릭하여 건너뛸 구분 기호의 변경 결과를 검토합니다. 이 단추는 다른 연결 옵션을 변경한 후에만 표시됩니다.

행 미리 보기
선택한 옵션을 사용하여 열과 행으로 구분된 플랫 파일로 샘플 데이터를 표시합니다.

열 다시 설정
열 다시 설정을 클릭하여 원래 열을 제외한 모든 열을 제거합니다.

형식 = 고정 폭

글꼴
미리 보기 데이터를 표시할 글꼴을 선택합니다.

원본 데이터 열
빨간색 세로 행 표식을 밀어 행 너비를 조절하고 미리 보기 창의 맨 위에 있는 눈금자를 클릭하여 열 너비를 조절합니다.

행 너비
개별 열의 구분 기호를 추가하기 전에 행 길이를 지정합니다. 또는 미리 보기 창에서 빨간색 세로줄을 끌어 행의 끝을 표시합니다. 행 너비 값이 자동으로 업데이트됩니다.

열 다시 설정
열 다시 설정을 클릭하여 원래 열을 제외한 모든 열을 제거합니다.

형식 = 왼쪽 정렬

참고

왼쪽 정렬 파일은 마지막 열을 제외한 모든 열에 고정 폭이 지정된 파일입니다. 마지막 열은 행 구분 기호로 구분됩니다.

글꼴
미리 보기 데이터를 표시할 글꼴을 선택합니다.

원본 데이터 열
빨간색 세로 행 표식을 밀어 행 너비를 조절하고 미리 보기 창의 맨 위에 있는 눈금자를 클릭하여 열 너비를 조절합니다.

행 구분 기호
사용 가능한 행 구분 기호의 목록에서 선택하거나 구분 기호 텍스트를 입력합니다.

값 설명
{CR}{LF} 행이 캐리지 리턴-줄 바꿈 조합으로 구분됩니다.
{CR} 행이 캐리지 리턴으로 구분됩니다.
{LF} 행이 줄 바꿈으로 구분됩니다.
세미콜론 {;} 행이 세미콜론으로 구분됩니다.
콜론 {:} 행이 콜론으로 구분됩니다.
쉼표 {,} 행이 쉼표로 구분됩니다.
탭 {t} 행이 탭으로 구분됩니다.
세로 막대 {|} 행이 세로 막대로 구분됩니다.

열 다시 설정
열 다시 설정을 클릭하여 원래 열을 제외한 모든 열을 제거합니다.

플랫 파일 연결 관리자 편집기(고급 페이지)

플랫 파일 연결 관리자 편집기 대화 상자의 고급 페이지를 사용하여 Integration Services가 플랫 파일에 있는 데이터를 읽고 쓰는 방법을 지정하는 속성을 설정할 수 있습니다. 사용자는 플랫 파일에 있는 열 이름을 바꿀 수 있고 파일의 각 열에 대해 데이터 형식 및 구분 기호를 포함하는 속성을 설정할 수 있습니다.

기본적으로 문자열 열의 길이는 50자입니다. 이러한 열의 길이를 조정하여 데이터가 잘리거나 열 너비를 초과하지 않도록 할 수 있습니다. 또한 대상 열과의 호환성을 위해 다른 메타데이터를 업데이트할 수 있습니다. 예를 들어 정수 데이터만 포함하는 열의 데이터 형식을 DT_I2와 같은 숫자 데이터 형식으로 변경할 수 있습니다. 이러한 수정을 수동으로 수행하거나 유형 선택 단추를 클릭하여 열 유형 제안 대화 상자를 사용하여 예제 데이터를 평가하고 자동으로 일부를 변경할 수 있습니다.

플랫 파일 연결 관리자에 대한 자세한 내용은 Flat File Connection Manager를 참조하십시오.

옵션

연결 관리자 이름
워크플로의 플랫 파일 연결 관리자에 고유한 이름을 지정합니다. 제공한 이름은 SSIS 디자이너에 표시됩니다.

설명
연결 관리자에 대한 설명을 입력합니다. 설명에 해당 연결 관리자의 용도를 정의하면 패키지를 이해하기 쉬우며 유지 관리가 간편합니다.

각 열의 속성을 구성하십시오.
왼쪽 창에서 열을 선택하면 오른쪽 창에 해당 속성이 표시됩니다. 데이터 형식 속성에 대한 설명은 다음 표를 참조하십시오. 나열된 일부 속성은 일부 플랫 파일 형식에 대해서만 구성 가능합니다.

속성 Description
ColumnType 열 유형이 구분 기호로 분리됨, 고정 폭 또는 왼쪽 정렬 중 어떤 것인지를 나타냅니다. 이 속성은 읽기 전용입니다. 왼쪽 정렬 파일은 마지막 열을 제외한 모든 열에 고정 폭이 지정된 파일입니다. 마지막 열은 행 구분 기호로 구분됩니다.
OutputColumnWidth 저장할 값을 바이트 수로 지정합니다. 유니코드 파일의 경우 이 값은 문자 수입니다. 데이터 흐름 태스크에서 이 값은 플랫 파일 원본의 출력 열 너비를 설정하는 데 사용됩니다. 개체 모델에서 이 속성의 이름은 MaximumWidth입니다.
DataType 사용 가능한 데이터 형식의 목록에서 선택합니다. 자세한 내용은 Integration Services Data Types을 참조하세요.
TextQualified 텍스트 데이터가 인용 문자 등의 텍스트 한정자로 묶였는지 여부를 나타냅니다.

True: 플랫 파일의 텍스트 데이터가 한정됩니다. False: 플랫 파일의 텍스트 데이터가 한정되지 않습니다.
이름 설명 열 이름을 지정합니다. 이름을 입력하지 않으면 Integration Services 는 자동으로 열 0, 열 1 등과 같은 형식으로 이름을 만듭니다.
DataScale 숫자 데이터의 소수 자릿수를 지정합니다. 소수 자릿수란 소수점 이하 자릿수를 말합니다. 자세한 내용은 Integration Services Data Types을 참조하세요.
ColumnDelimiter 사용 가능한 열 구분 기호의 목록에서 선택합니다. 텍스트에 거의 사용되지 않는 구분 기호를 선택합니다. 고정 폭 열에 대해서는 이 값이 무시됩니다.

{CR}{LF} . 열이 캐리지 리턴-줄 바꿈 조합으로 구분됩니다.

{CR} . 열이 캐리지 리턴으로 구분됩니다.

{LF} . 열이 줄 바꿈으로 구분됩니다.

세미콜론{;} . 열이 세미콜론으로 구분됩니다.

콜론{:} . 열이 콜론으로 구분됩니다.

쉼표 {,} . 열이 쉼표로 구분됩니다.

탭 {t} . 열이 탭으로 구분됩니다.

세로 막대 {|}. 열이 세로 막대로 구분됩니다.
DataPrecision 숫자 데이터의 전체 자릿수를 지정합니다. 전체 자릿수란 숫자의 자릿수를 말합니다. 자세한 내용은 Integration Services Data Types을 참조하세요.
InputColumnWidth 저장할 값을 바이트 수로 지정합니다. 유니코드 파일의 경우 문자 수로 표시됩니다. 구분 기호로 분리된 열에 대해서는 이 값이 무시됩니다.

참고 개체 모델에서 이 속성의 이름은 ColumnWidth입니다.

새로 만들기
새로 만들기를 클릭하여 새 열을 추가합니다. 기본적으로 새로 만들기 단추는 목록 끝에 새 열을 추가합니다. 이 단추에는 드롭다운 목록에서 사용할 수 있는 다음 옵션도 있습니다.

값 Description
열 추가 목록 끝에 새 열을 추가합니다.
앞에 삽입 선택한 열 앞에 새 열을 삽입합니다.
뒤에 삽입 선택한 열 뒤에 새 열을 삽입합니다.

Delete
열을 선택한 다음 삭제를 클릭하여 제거합니다.

유형 제안
열 유형 제안 대화 상자를 사용하여 파일에 있는 샘플 데이터를 평가하고 각 열의 데이터 형식과 길이에 대한 제안을 가져올 수 있습니다. 자세한 내용은 열 유형 제안 대화 상자 UI 참조를 참조하세요.

플랫 파일 연결 관리자 편집기(미리 보기 페이지)

플랫 파일 연결 관리자 편집기 대화 상자의 미리 보기 노드를 사용하여 원본 파일의 내용을 테이블 형식으로 볼 수 있습니다.

플랫 파일 연결 관리자에 대한 자세한 내용은 Flat File Connection Manager를 참조하십시오.

옵션

연결 관리자 이름
워크플로의 플랫 파일 연결에 고유한 이름을 지정합니다. 제공한 이름은 SSIS 디자이너에 표시됩니다.

설명
연결에 대한 설명을 입력합니다. 해당 연결의 용도를 설명하여 패키지를 이해하기 쉽고 유지 관리하기 편하도록 만드는 것이 가장 좋습니다.

건너뛸 데이터 행
플랫 파일의 시작 부분에서 건너뛸 행 수를 지정합니다.

새로 고침
새로 고침을 클릭하여 건너뛸 행 수의 변경 결과를 검토합니다. 이 단추는 다른 연결 옵션을 변경한 후에만 표시됩니다.

행 미리 보기
선택한 옵션을 사용하여 열과 행으로 구분된 플랫 파일로 샘플 데이터를 표시합니다.