다음을 통해 공유

플랫 파일 연결 관리자

  • 아티클

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

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

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

열 길이

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

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

플릿 파일 연결 관리자 구성

패키지에 플랫 파일 연결 관리자를 추가하면 SQL Server 통합 서비스에서 런타임에 플랫 파일 연결로 확인되는 연결 관리자를 만들고, 플랫 파일 연결 속성을 설정하며, 플랫 파일 연결 관리자를 패키지의 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 및 프로그래밍 방식으로 연결 추가를 참조하세요.

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

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

플랫 파일 연결 관리자에 대한 자세한 내용은 플랫 파일 연결 관리자를 참조하세요.

옵션

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

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

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

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

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

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

코드 페이지
유니코드가 아닌 텍스트의 코드 페이지를 지정합니다.

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

값 설명
구분 기호로 분리됨 열 페이지에 지정된 구분 기호로 열을 구분합니다.
고정 폭 열에 고정 폭이 지정됩니다.
왼쪽 정렬 왼쪽 정렬 파일은 마지막 열을 제외하고 모든 열의 너비가 고정된 파일입니다. 행 구분 기호로 구분됩니다.

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

참고 항목

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

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

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

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

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

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

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

플랫 파일 연결 관리자에 대한 자세한 내용은 플랫 파일 연결 관리자를 참조하세요.

정적 옵션

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

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

플랫 파일 형식 동적 옵션

형식 = 구분됨

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

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

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

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

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

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

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

형식 = 고정 너비

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

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

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

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

형식 = 불규칙한 오른쪽

참고 항목

왼쪽 정렬 파일은 마지막 열을 제외하고 모든 열의 너비가 고정된 파일입니다. 행 구분 기호로 구분됩니다.

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

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

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

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

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

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

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

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

플랫 파일 연결 관리자에 대한 자세한 내용은 플랫 파일 연결 관리자를 참조하세요.

옵션

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

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

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

속성 설명
ColumnType 열이 구분되어 있는지, 너비가 고정되었는지, 또는 불규칙한 오른쪽인지 표시합니다. 이 속성은 읽기 전용입니다. 왼쪽 정렬 파일은 마지막 열을 제외하고 모든 열의 너비가 고정된 파일입니다. 행 구분 기호로 구분됩니다.
OutputColumnWidth 바이트 수로 저장할 값을 지정합니다. 유니코드 파일의 경우 이 값은 문자 수에 해당합니다. 데이터 흐름 태스크에서 이 값은 플랫 파일 원본의 출력 열 너비를 설정하는 데 사용됩니다. 개체 모델에서 이 속성의 이름은 MaximumWidth입니다.
DataType 사용 가능한 데이터 형식 목록에서 선택합니다. 자세한 내용은 Integration Services 데이터 형식을 참조하세요.
TextQualified 텍스트 데이터가 따옴표 문자와 같은 텍스트 한정자 문자로 둘러싸여 있는지 여부를 나타냅니다.

True: 플랫 파일의 텍스트 데이터가 한정됩니다. False: 플랫 파일의 텍스트 데이터가 한정되지 않았습니다.
이름 설명이 포함된 열 이름을 제공합니다. 이름을 입력하지 않으면 Integration Services는 열 0, 열 1 등의 형식으로 이름을 자동으로 만듭니다.
DataScale 숫자 데이터의 배율을 지정합니다. 배율은 소수점 이하 자릿수를 나타냅니다. 자세한 내용은 Integration Services 데이터 형식을 참조하세요.
ColumnDelimiter 사용 가능한 열 구분 기호의 목록에서 선택합니다. 텍스트에서 발생할 가능성이 없는 구분 기호를 선택합니다. 고정 너비 열의 경우 이 값은 무시됩니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

플랫 파일 연결 관리자에 대한 자세한 내용은 플랫 파일 연결 관리자를 참조하세요.

옵션

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

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

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

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

행 미리 보기
선택한 옵션에 따라 열과 행으로 구분하여 플랫 파일의 샘플 데이터를 봅니다.