XML 원본XML Source

XML 원본은 XML 데이터 파일을 읽고 원본 출력의 열을 해당 데이터로 채웁니다.The XML source reads an XML data file and populates the columns in the source output with the data.

XML 파일의 데이터에 계층 관계가 포함되어 있는 경우가 많습니다.The data in XML files frequently includes hierarchical relationships. 예를 들어 XML 데이터 파일은 카탈로그 및 카탈로그의 항목을 나타낼 수 있습니다.For example, an XML data file can represent catalogs and items in catalogs. 데이터가 데이터 흐름을 시작할 수 있으려면 먼저 XML 데이터 파일에 있는 각 요소의 관계를 결정하고 파일의 각 요소에 대해 출력을 생성해야 합니다.Before the data can enter the data flow, the relationship of the elements in XML data file must be determined, and an output must be generated for each element in the file.

스키마Schemas

XML 원본은 스키마를 사용하여 XML 데이터를 해석합니다.The XML source uses a schema to interpret the XML data. XML 원본은 XML 데이터를 테이블 형식으로 변환하는 인라인 스키마 또는 XML 스키마 정의(XSD) 파일 사용을 지원합니다.The XML source supports use of a XML Schema Definition (XSD) file or inline schemas to translate the XML data into a tabular format. XML 원본 편집기 대화 상자를 사용하여 XML 원본을 구성하면 사용자 인터페이스가 지정한 XML 데이터 파일에서 XSD를 생성할 수 있습니다.If you configure the XML source by using the XML Source Editor dialog box, the user interface can generate an XSD from the specified XML data file.

참고

DTD는 지원되지 않습니다.DTDs are not supported.

스키마는 하나의 네임스페이스만 지원할 수 있으며 스키마 컬렉션을 지원하지 않습니다.The schemas can support a single namespace only; they do not support schema collections.

참고

XML 원본은 XSD와 비교하여 XML 파일 데이터의 유효성을 검사하지 않습니다.The XML source does not validate the data in the XML file against the XSD.

XML 원본 편집기XML Source Editor

XML 파일의 데이터에 계층 관계가 포함되어 있는 경우가 많습니다.The data in the XML files frequently includes hierarchical relationships. XML 원본 편집기 대화 상자는 지정한 스키마를 사용하여 XML 원본 출력을 생성합니다.The XML Source Editor dialog box uses the specified schema to generate the XML source outputs. XSD 파일을 지정하거나 인라인 스키마를 사용하거나 지정한 XML 데이터 파일에서 XSD를 생성할 수 있습니다.You can specify an XSD file, use an inline schema, or generate an XSD from the specified XML data file. 디자인 타임에 해당 스키마를 사용할 수 있어야 합니다.The schema must be available at design time.

XML 원본은 XML 파일의 다른 요소가 포함된 모든 요소에 대해 출력을 만들어 XML 데이터에서 테이블 구조를 생성합니다.The XML source generates tabular structures from the XML data by creating an output for every element that contains other elements in the XML files. 예를 들어 XML 데이터가 카탈로그 및 카탈로그의 항목을 나타내는 경우 XML 원본은 카탈로그에 대한 출력과 카탈로그에 포함된 각 항목 유형에 대한 출력을 만듭니다.For example, if the XML data represents catalogs and items in catalogs, the XML source creates an output for catalogs and an output for each type of item that the catalogs contain. 각 항목의 출력에는 해당 항목의 속성에 대한 출력 열이 포함됩니다.The output of each item will contain output columns for the attributes of that item.

출력에서 데이터 계층 관계에 대한 정보를 제공하기 위해 XML 원본은 각 자식 요소의 부모 요소를 식별하는 열을 출력에 추가합니다.To provide information about the hierarchical relationship of the data in the outputs, the XML source adds a column in the outputs that identifies the parent element for each child element. 여러 유형의 항목이 포함된 카탈로그를 예로 들면 각 항목은 해당 항목이 속해 있는 카탈로그를 식별하는 열 값을 갖습니다.Using the example of catalogs with different types of items, each item would have a column value that identifies the catalog to which it belongs.

XML 원본은 모든 요소에 대해 출력을 만들지만 모든 출력을 사용할 필요는 없습니다.The XML source creates an output for every element, but it is not required that you use all the outputs. 사용하지 않을 출력을 삭제하거나 다운스트림 구성 요소에 연결하지 않을 수 있습니다.You can delete any output that you do not want to use, or just not connect it to a downstream component.

또한 XML 원본은 출력 이름을 생성하여 이름이 명확하게 구분되게 합니다.The XML source also generates the output names, to ensure that the names are unambiguous. 이러한 이름이 너무 길면 출력을 식별하는 데 도움이 되지 않을 수도 있습니다.These names may be long and may not identify the outputs in a way that is useful to you. 고유한 이름을 지정한다면 출력 이름을 바꿀 수 있습니다.You can rename the outputs, as long as their names remain unique. 출력 열의 길이와 데이터 형식도 수정할 수 있습니다.You can also modify the data type and the length of output columns.

XML 원본은 모든 출력에 대해 오류 출력을 추가합니다.For every output, the XML source adds an error output. 기본적으로 오류 출력의 열은 길이가 255인 유니코드 문자열 데이터 형식(DT_WSTR)이지만 데이터 형식과 길이를 수정하여 오류 출력의 열을 구성할 수 있습니다.By default the columns in error outputs have Unicode string data type (DT_WSTR) with a length of 255, but you can configure the columns in the error outputs by modifying their data type and length.

XSD에 없는 요소가 XML 데이터 파일에 포함되어 있으면 해당 요소는 무시되며 출력이 생성되지 않습니다.If the XML data file contains elements that are not in the XSD, these elements are ignored and no output is generated for them. 반면 XSD에 표시된 요소가 XML 데이터 파일에 없을 경우 Null 값을 가진 열이 출력에 포함됩니다.On the other hand, if the XML data file is missing elements that are represented in the XSD, the output will contain columns with null values.

XML 데이터 파일에서 데이터를 추출하면 Integration ServicesIntegration Services 데이터 형식으로 변환됩니다.When the data is extracted from the XML data file, it is converted to an Integration ServicesIntegration Services data type. 그러나 XML 원본은 DT_TIME2 또는 DT_DBTIMESTAMP2 데이터 형식을 지원하지 않기 때문에 XML 데이터를 이러한 데이터 형식으로 변환할 수 없습니다.However, the XML source cannot convert the XML data to the DT_TIME2 or DT_DBTIMESTAMP2 data types because the source does not support these data types. 자세한 내용은 Integration Services Data Types을 참조하세요.For more information, see Integration Services Data Types.

XSD 또는 인라인 스키마에서 요소의 데이터 형식을 지정할 수도 있지만 그렇지 않을 경우 XML 원본 편집기 대화 상자는 요소가 포함된 출력 열에 유니코드 문자열 데이터 형식(DT_WSTR)을 할당하고 열 길이를 255자로 설정합니다.The XSD or inline schema may specify the data type for elements, but if it does not, the XML Source Editor dialog box assigns the Unicode string data type (DT_WSTR) to the column in the output that contains the element, and sets the column length to 255 characters.

스키마에서 요소의 최대 길이를 지정하는 경우 출력 열의 길이는 이 값으로 설정됩니다.If the schema specifies the maximum length of an element, the length of output column is set to this value. 요소가 변환되는 Integration ServicesIntegration Services 데이터 형식에서 지원되는 길이보다 최대 길이가 큰 경우 해당 데이터 형식의 최대 길이로 데이터가 잘립니다.If the maximum length is greater than the length supported by the Integration ServicesIntegration Services data type to which the element is converted, then the data is truncated to the maximum length of the data type. 예를 들어 문자열의 길이가 5,000자인 경우 DT_WSTR 데이터 형식의 최대 길이는 4,000자이므로 4,000자로 잘리며 BYTE 데이터는 DT_BYTES 데이터 형식의 최대 길이인 8,000자로 잘립니다.For example, if a string has a length of 5000, it is truncated to 4000 characters because the maximum length of the DT_WSTR data type is 4000 characters; likewise, byte data is truncated to 8000 characters, the maximum length of the DT_BYTES data type. 스키마에서 최대 길이를 지정하지 않는 경우 두 데이터 형식의 열 기본 길이는 255자로 설정됩니다.If the schema specifies no maximum length, the default length of columns with either data type is set to 255. XML 원본에서의 데이터 잘림은 다른 데이터 흐름 구성 요소에서의 잘림과 동일하게 처리됩니다.Data truncation in the XML source is handled the same way as truncation in other data flow components. 자세한 내용은 데이터 오류 처리를 참조하세요.For more information, see Error Handling in Data.

데이터 형식과 열 길이는 수정할 수 있습니다.You can modify the data type and the column length. 자세한 내용은 Integration Services Data Types을 참조하세요.For more information, see Integration Services Data Types.

XML 원본 구성Configuration of the XML Source

XML 원본은 3가지 데이터 액세스 모드를 지원합니다.The XML source supports three different data access modes. XML 데이터 파일의 파일 위치, 이 파일 위치가 포함된 변수 또는 XML 데이터가 포함된 변수를 지정할 수 있습니다.You can specify the file location of the XML data file, the variable that contains the file location, or the variable that contains the XML data.

XML 원본은 패키지 로드 시 속성 식을 사용하여 업데이트할 수 있는 XMLDataXMLSchemaDefinition 사용자 지정 속성을 포함합니다.The XML source includes the XMLData and XMLSchemaDefinition custom properties that can be updated by property expressions when the package is loaded. 자세한 내용은 Integration Services(SSIS) 식, 패키지에서 속성 식 사용XML 원본 사용자 지정 속성을 참조하세요.For more information, see Integration Services (SSIS) Expressions, Use Property Expressions in Packages, and XML Source Custom Properties.

XML 원본은 여러 개의 일반 출력과 여러 개의 오류 출력을 지원합니다.The XML source supports multiple regular outputs and multiple error outputs.

SQL ServerSQL Server Integration ServicesIntegration Services 에는 XML 원본 구성을 위한 XML 원본 편집기대화 상자가 있습니다. Integration ServicesIntegration Services includes the XML Source Editor dialog box for configuring the XML source. 이 대화 상자는 SSISSSIS 디자이너에서 사용할 수 있습니다.This dialog box is available in SSISSSIS Designer.

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:

XML 원본 편집기(연결 관리자 페이지)XML Source Editor (Connection Manager Page)

XML 원본 편집기연결 관리자 페이지를 사용하여 XML 데이터를 변환할 XML 파일 및 XSD를 지정할 수 있습니다.Use the Connection Manager page of the XML Source Editor to specify an XML file and the XSD that transforms the XML data.

정적 옵션Static Options

데이터 액세스 모드Data access mode
원본에서 데이터를 선택하는 방법을 지정합니다.Specify the method for selecting data from the source.

ValueValue DescriptionDescription
XML 파일 위치XML file location XML 파일에서 데이터를 검색합니다.Retrieve data from an XML file.
변수를 사용한 XML 파일XML file from variable 변수에 XML 파일 이름을 지정합니다.Specify the XML file name in a variable.

관련 정보: 패키지에서 변수 사용Related information: Use Variables in Packages
변수를 사용한 XML 데이터XML data from variable 변수에서 XML 데이터를 검색합니다.Retrieve XML data from a variable.

인라인 스키마 사용Use inline schema
XML 원본 데이터에 구조 및 데이터를 정의하고 유효성을 검사하는 XSD 스키마를 포함할지 여부를 지정합니다.Specify whether the XML source data itself contains the XSD schema that defines and validates its structure and data.

XSD 위치XSD location
XSD 스키마 파일의 경로 및 파일 이름을 입력하거나 찾아보기를 클릭하여 파일을 찾습니다.Type the path and file name of the XSD schema file, or locate the file by clicking Browse.

찾아보기Browse
열기 대화 상자를 사용하여 XSD 스키마 파일을 찾을 수 있습니다.Use the Open dialog box to locate the XSD schema file.

XSD 생성Generate XSD
다른 이름으로 저장 대화 상자를 사용하여 자동 생성된 XSD 스키마 파일의 위치를 선택할 수 있습니다.Use the Save As dialog box to select a location for the auto-generated XSD schema file. 편집기에서는 XML 데이터의 구조를 통해 스키마를 유추합니다.The editor infers the schema from the structure of the XML data.

데이터 액세스 모드 동적 옵션Data Access Mode Dynamic Options

데이터 액세스 모드 = XML 파일 위치Data access mode = XML file location

XML 위치XML location
XML 데이터 파일의 경로 및 파일 이름을 입력하거나 찾아보기를 클릭하여 파일을 찾습니다.Type the path and file name of the XML data file, or locate the file by clicking Browse.

찾아보기Browse
열기 대화 상자를 사용하여 XML 데이터 파일을 찾을 수 있습니다.Use the Open dialog box to locate the XML data file.

데이터 액세스 모드 = 변수를 사용한 XML 파일Data access mode = XML file from variable

변수 이름Variable name
XML 파일의 경로 및 파일 이름을 포함하는 변수를 선택합니다.Select the variable that contains the path and file name of the XML file.

데이터 액세스 모드 = 변수를 사용한 XML 데이터Data access mode = XML data from variable

변수 이름Variable name
XML 데이터를 포함하는 변수를 선택합니다.Select the variable that contains the XML data.

XML 원본 편집기(열 페이지)XML Source Editor (Columns Page)

XML 원본 편집기 대화 상자의 노드를 사용하여 출력 열을 외부(원본) 열에 매핑할 수 있습니다.Use the Columns node of the XML Source Editor dialog box to map an output column to an external (source) column.

옵션Options

사용 가능한 외부 열Available External Columns
데이터 원본에서 사용 가능한 외부 열의 목록을 표시합니다.View the list of available external columns in the data source. 이 테이블을 사용하여 열을 추가하거나 삭제할 수 없습니다.You cannot use this table to add or delete columns.

외부 열External Column
태스크에서 읽는 순서대로 외부(원본) 열을 표시합니다.View external (source) columns in the order in which the task will read them. 이 순서는 먼저 편집기에 표시된 테이블에서 선택한 열을 지운 다음 목록에서 다른 순서로 외부 열을 선택하여 변경할 수 있습니다.You can change this order by first clearing the selected columns in the table displayed in the editor, and then selecting external columns from the list in a different order.

출력 열Output Column
각 출력 열에 고유한 이름을 지정합니다.Provide a unique name for each output column. 기본값은 선택한 외부(원본) 열의 이름이지만 설명이 포함된 고유 이름을 임의로 선택할 수 있습니다.The default is the name of the selected external (source) column; however, you can choose any unique, descriptive name. 제공한 이름은 SSISSSIS 디자이너에 표시됩니다.The name provided will be displayed within SSISSSIS Designer.

XML 원본 편집기(오류 출력 페이지)XML Source Editor (Error Output Page)

XML 원본 편집기 대화 상자의 오류 출력 페이지를 사용하여 오류 처리 옵션을 선택하고 오류 출력 열에 속성을 설정할 수 있습니다.Use the Error Output page of the XML Source Editor dialog box to select error handling options and to set properties on error output columns.

옵션Options

입/출력Input/Output
데이터 원본의 이름을 표시합니다.View the name of the data source.

Column
XML 원본 편집기 대화 상자의 연결 관리자페이지에서 선택한 외부(원본) 열을 표시합니다.View the external (source) columns that you selected on the Connection Manager page of the XML Source Editordialog box.

오류Error
오류가 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Specify what should happen when an error occurs: ignore the failure, redirect the row, or fail the component.

관련 항목: 데이터 오류 처리Related Topics: Error Handling in Data

잘림Truncation
잘림이 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Specify what should happen when a truncation occurs: ignore the failure, redirect the row, or fail the component.

DescriptionDescription
오류에 대한 설명을 표시합니다.View the description of the error.

이 값을 선택한 셀에 설정Set this value to selected cells
오류나 잘림 발생 시 선택한 모든 셀에 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.Specify what should happen to all the selected cells when an error or truncation occurs: ignore the failure, redirect the row, or fail the component.

적용Apply
선택한 셀에 오류 처리 옵션을 적용합니다.Apply the error handling option to the selected cells.

XML 원본을 사용하여 데이터 추출Extract Data by Using the XML Source