XML 원본

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

XML 원본은 XML 데이터 파일을 읽고 원본 출력의 열을 데이터로 채웁니다.

XML 파일의 데이터에 계층 관계가 포함되어 있는 경우가 많습니다. 예를 들어 XML 데이터 파일은 카탈로그의 카탈로그 및 항목을 나타낼 수 있습니다. 데이터가 데이터 흐름을 입력하려면 먼저 XML 데이터 파일의 요소 관계를 결정해야 하며 파일의 각 요소에 대해 출력을 생성해야 합니다.

스키마

XML 원본은 스키마를 사용하여 XML 데이터를 해석합니다. XML 원본은 XSD(XML 스키마 정의) 파일 또는 인라인 스키마를 사용하여 XML 데이터를 테이블 형식으로 변환하도록 지원합니다. XML 원본 편집기 대화 상자를 사용하여 XML 원본을 구성하는 경우 사용자 인터페이스는 지정된 XML 데이터 파일에서 XSD를 생성할 수 있습니다.

참고 항목

DTD는 지원되지 않습니다.

스키마는 단일 네임스페이스만 지원할 수 있습니다. 스키마 컬렉션을 지원하지 않습니다.

참고 항목

XML 원본은 XSD에 대해 XML 파일의 데이터의 유효성을 검사하지 않습니다.

XML 원본 편집기

XML 파일의 데이터에는 계층적 관계가 자주 포함됩니다. XML 원본 편집기 대화 상자는 지정된 스키마를 사용하여 XML 원본 출력을 생성합니다. XSD 파일을 지정하거나, 인라인 스키마를 사용하거나, 지정된 XML 데이터 파일에서 XSD를 생성할 수 있습니다. 스키마는 디자인 타임에 사용할 수 있어야 합니다.

XML 원본은 XML 파일의 다른 요소를 포함하는 모든 요소에 대한 출력을 만들어 XML 데이터에서 테이블 형식 구조를 생성합니다. 예를 들어 XML 데이터가 카탈로그의 카탈로그 및 항목을 나타내는 경우 XML 원본은 카탈로그에 대한 출력과 카탈로그에 포함된 각 유형의 항목에 대한 출력을 만듭니다. 각 항목의 출력에는 해당 항목의 특성에 대한 출력 열이 포함됩니다.

출력에 있는 데이터의 계층적 관계에 대한 정보를 제공하기 위해 XML 원본은 각 자식 요소에 대한 부모 요소를 식별하는 열을 출력에 추가합니다. 다양한 유형의 항목이 있는 카탈로그의 예제를 사용하면 각 항목에 속한 카탈로그를 식별하는 열 값이 있습니다.

XML 원본은 모든 요소에 대한 출력을 만들지만 모든 출력을 사용할 필요는 없습니다. 사용하지 않으려는 출력을 삭제하거나 다운스트림 구성 요소에 연결하지 않을 수 있습니다.

또한 XML 원본은 출력 이름을 생성하여 이름이 명확하게 구분되게 합니다. 이러한 이름이 너무 길면 출력을 식별하는 데 도움이 되지 않을 수도 있습니다. 고유한 이름을 지정한다면 출력 이름을 바꿀 수 있습니다. 데이터 형식 및 출력 열의 길이를 수정할 수도 있습니다.

모든 출력에 대해 XML 원본은 오류 출력을 추가합니다. 기본적으로 오류 출력의 열에는 길이가 255인 유니코드 문자열 데이터 형식(DT_WSTR)이 있지만 데이터 형식과 길이를 수정하여 오류 출력의 열을 구성할 수 있습니다.

XSD에 없는 요소가 XML 데이터 파일에 포함되어 있으면 해당 요소는 무시되며 출력이 생성되지 않습니다. 반면 XML 데이터 파일에 XSD에 표시되는 요소가 누락된 경우 출력에는 null 값이 있는 열이 포함됩니다.

XML 데이터 파일에서 데이터를 추출하면 Integration Services 데이터 형식으로 변환됩니다. 그러나 원본이 이러한 데이터 형식을 지원하지 않으므로 XML 원본은 XML 데이터를 DT_TIME2 또는 DT_DBTIMESTAMP2 데이터 형식으로 변환할 수 없습니다. 자세한 내용은 Integration Services 데이터 형식을 참조 하세요.

XSD 또는 인라인 스키마에서 요소의 데이터 형식을 지정할 수도 있지만 그렇지 않을 경우 XML 원본 편집기 대화 상자는 요소가 포함된 출력 열에 유니코드 문자열 데이터 형식(DT_WSTR)을 할당하고 열 길이를 255자로 설정합니다.

스키마가 요소의 최대 길이를 지정하면 출력 열의 길이가 이 값으로 설정됩니다. 요소가 변환되는 Integration Services 데이터 형식에서 지원되는 길이보다 최대 길이가 큰 경우 해당 데이터 형식의 최대 길이로 데이터가 잘립니다. 예를 들어 문자열의 길이가 5000인 경우 DT_WSTR 데이터 형식의 최대 길이는 4000자이므로 4000자로 잘립니다. 마찬가지로 바이트 데이터는 DT_BYTES 데이터 형식의 최대 길이인 8000자로 잘립니다. 스키마가 최대 길이를 지정하지 않으면 두 데이터 형식이 있는 열의 기본 길이는 255로 설정됩니다. XML 원본의 데이터 잘림은 다른 데이터 흐름 구성 요소의 잘림과 동일한 방식으로 처리됩니다. 자세한 내용은 데이터 오류 처리를 참조 하세요.

데이터 형식 및 열 길이를 수정할 수 있습니다. 자세한 내용은 Integration Services 데이터 형식을 참조 하세요.

XML 원본 구성

XML 원본은 세 가지 데이터 액세스 모드를 지원합니다. XML 데이터 파일의 파일 위치, 파일 위치가 포함된 변수 또는 XML 데이터가 포함된 변수를 지정할 수 있습니다.

XML 원본에는 패키지가 로드될 때 속성 식에서 업데이트할 수 있는 XMLDataXMLSchemaDefinition 사용자 지정 속성이 포함됩니다. 자세한 내용은 Integration Services(SSIS) 식, 패키지에서 속성 식 사용XML 원본 사용자 지정 속성을 참조하세요.

XML 원본은 여러 개의 일반 출력과 여러 개의 오류 출력을 지원합니다.

SQL Server Integration Services에는 XML 원본 구성을 위한 XML 원본 편집기 대화 상자가 있습니다. 이 대화 상자는 SSIS 디자이너에서 사용할 수 있습니다.

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

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

속성 설정 방법을 보려면 다음 항목 중 하나를 클릭하십시오.

XML 원본 편집기(연결 관리자 페이지)

XML 원본 편집기연결 관리자 페이지를 사용하여 XML 데이터를 변환할 XML 파일 및 XSD를 지정할 수 있습니다.

정적 옵션

데이터 액세스 모드
원본에서 데이터를 선택하는 방법을 지정합니다.

설명
XML 파일 위치 XML 파일에서 데이터를 검색합니다.
변수의 XML 파일 변수에 XML 파일 이름을 지정합니다.

관련 정보: 패키지에서 변수 사용
변수의 XML 데이터 변수에서 XML 데이터를 검색합니다.

인라인 스키마 사용
XML 원본 데이터 자체에 해당 구조와 데이터를 정의하고 유효성을 검사하는 XSD 스키마가 포함되어 있는지 여부를 지정합니다.

XSD 위치
XSD 스키마 파일의 경로 및 파일 이름을 입력하거나 찾아보기를 클릭하여 파일을 찾습니다.

찾아보기
열기 대화 상자를 사용하여 XSD 스키마 파일을 찾습니다.

XSD 생성
다른 이름으로 저장 대화 상자를 사용하여 자동 생성된 XSD 스키마 파일의 위치를 선택할 수 있습니다. 편집기에서는 XML 데이터의 구조를 통해 스키마를 유추합니다.

데이터 액세스 모드 동적 옵션

데이터 액세스 모드 = XML 파일 위치

XML 위치
XML 데이터 파일의 경로 및 파일 이름을 입력하거나 찾아보기를 클릭하여 파일을 찾습니다.

찾아보기
열기 대화 상자를 사용하여 XML 데이터 파일을 찾습니다.

데이터 액세스 모드 = 변수의 XML 파일

변수 이름
XML 파일의 경로 및 파일 이름을 포함하는 변수를 선택합니다.

데이터 액세스 모드 = 변수의 XML 데이터

변수 이름
XML 데이터가 포함된 변수를 선택합니다.

XML 원본 편집기(열 페이지)

XML 원본 편집기 대화 상자의 열 노드를 사용하여 출력 열을 외부(원본) 열에 매핑합니다.

옵션

사용 가능한 외부 열
데이터 원본에서 사용 가능한 외부 열 목록을 봅니다. 이 테이블을 사용하여 열을 추가하거나 삭제할 수 없습니다.

외부 열
외부(원본) 열을 작업에서 읽는 순서대로 봅니다. 먼저 편집기에서 표시된 테이블에서 선택한 열을 지우고 목록에서 다른 순서로 외부 열을 선택하여 이 순서를 변경할 수 있습니다.

출력 열
각 출력 열에 고유한 이름을 제공합니다. 기본값은 선택한 외부(원본) 열의 이름입니다. 그러나 고유한 설명이 포함된 이름을 선택할 수 있습니다. 제공된 이름은 SSIS 디자이너 내에 표시됩니다.

XML 원본 편집기(오류 출력 페이지)

XML 원본 편집기 대화 상자의 오류 출력 페이지를 사용하여 오류 처리 옵션을 선택하고 오류 출력 열에 속성을 설정할 수 있습니다.

옵션

입/출력
데이터 원본의 이름을 표시합니다.


XML 원본 편집기 대화 상자의 연결 관리자페이지에서 선택한 외부(원본) 열을 표시합니다.

오류
오류가 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.

관련 항목:데이터 오류 처리

잘림
잘림이 발생할 때 발생하는 작업을 지정합니다. 오류를 무시하거나 행을 리디렉션하거나 구성 요소를 실패합니다.

설명
오류에 대한 설명을 표시합니다.

이 값을 선택한 셀로 설정
오류나 잘림 발생 시 선택한 모든 셀에 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.

적용
선택한 셀에 오류 처리 옵션을 적용합니다.

XML 원본을 사용하여 데이터 추출