XML 연결 형식(SSRS)XML Connection Type (SSRS)

보고서에 XML 데이터 원본의 데이터를 포함하려면 XML 유형의 보고서 데이터 원본에 기초하는 데이터 집합이 있어야 합니다.To include data from an XML data source in your report, you must have a dataset that is based on a report data source of type XML. 이 기본 제공 데이터 원본 유형은 XML 데이터 확장 프로그램을 기반으로 합니다.This built-in data source type is based on the XML data extension. 이 데이터 원본 유형을 사용하여 쿼리에 포함된 XML 문서, 웹 서비스 또는 XML에서 데이터에 연결하여 검색합니다.Use this data source type to connect to and retrieve data from XML documents, Web services, or XML that is embedded in the query.

이 데이터 확장 프로그램은 연결 문자열과 별개로 관리되는 자격 증명 및 매개 변수를 지원합니다.This data extension supports parameters and credentials managed separately from the connection string.

이 항목의 정보를 사용하여 데이터 원본을 작성할 수 있습니다.Use the information in this topic to build a data source. 단계별 지침은 데이터 연결 추가 및 확인(보고서 작성기 및 SSRS)을 참조하세요.For step-by-step instructions, see Add and Verify a Data Connection (Report Builder and SSRS).

연결 문자열Connection String

연결 문자열은 HTTP를 통해 사용할 수 있는 웹 서비스, 웹 기반 응용 프로그램 또는 XML 문서를 가리키는 URL이어야 합니다.The connection string must be a URL that points to the Web service, Web-based application, or XML document available through HTTP. XML 문서에는 XML 확장명을 사용해야 합니다.XML documents must have the XML extension. 데이터 집합 쿼리에 포함된 XML 데이터의 경우 빈 연결 문자열을 사용할 수도 있습니다.You can also use an empty connection string for XML data embedded in the dataset query.

다음 예에서는 웹 서비스 및 XML 문서에 대한 각각의 연결 문자열 구문을 보여 줍니다.The following examples illustrate the connection string syntax for a Web service and XML document, respectively. file:// 프로토콜은 지원되지 않습니다.The file:// protocol is not supported.

XML 문서 유형XML document type 연결 문자열 예Connection String Example
웹 서비스Web service http://adventure-works.com/results.aspx
XML 문서XML document http://localhost/XML/Customers.xml
포함 XML 문서Embedded XML document 비어 있음Empty

연결 문자열 예제는 보고서 작성기의 데이터 연결, 데이터 원본 및 연결 문자열을 참조하세요.For more connection string examples, see Data Connections, Data Sources, and Connection Strings in Report Builder.

자격 증명Credentials

쿼리를 실행하거나 보고서를 로컬로 미리 보거나 보고서 서버의 보고서를 미리 보려면 자격 증명이 필요합니다.Credentials are required to run queries, to preview the report locally, and to preview the report from the report server.

보고서를 게시한 후 보고서를 보고서 서버에서 실행할 때 데이터를 검색할 수 있는 권한이 유효하도록 데이터 원본에 대한 자격 증명을 변경해야 할 수도 있습니다.After you publish your report, you may need to change the credentials for the data source so that when the report runs on the report server, the permissions to retrieve the data are valid.

보고서 작성 클라이언트에서는 다음 옵션을 사용하여 자격 증명을 지정할 수 있습니다.From a report authoring client, the following options are available to specify credentials:

  • 현재 Windows 사용자(통합 보안).Current Windows user (also known as integrated security).

  • 자격 증명 필요 없음.No credentials are required. 자격 증명을 사용하지 않도록 선택하는 경우 익명 액세스가 사용됩니다.If you select no credentials, Anonymous access is used. 보고서 서버에서 외부 데이터 원본에 연결할 수 있도록 무인 실행 계정을 정의했는지 확인합니다.Make sure that you have defined the unattended execution account for the report server to connect to an external data source. XML 데이터 처리 확장 프로그램에서는 자격 증명을 대상 URL이나 웹 서비스로 전달하지 않으므로 무인 실행 계정을 정의하지 않은 경우에는 연결이 실패합니다.The XML data processing extension does not pass credentials to the target URL or the Web service; the connection will be unsuccessful unless you have defined the unattended execution account. 자세한 내용은 msdn.microsoft.com의 SQL ServerSQL Server 온라인 설명서에서 Reporting ServicesReporting Services 설명서의 무인 실행 계정 구성(SSRS 구성 관리자)을 참조하세요.For more information, see Configure the Unattended Execution Account (SSRS Configuration Manager) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online on msdn.microsoft.com.

    저장된 자격 증명 및 입력 정보를 요청하는 자격 증명은 지원되지 않습니다.Stored and prompted credentials are not supported. Windows 통합 보안을 사용하지 않도록 설정한 경우 이를 사용하여 데이터를 검색할 수 없습니다.Remember that if you disable Windows integrated security, you cannot use it to retrieve data. 저장된 자격 증명 및 입력 정보를 요청하는 자격 증명을 지정할 경우 런타임에 오류가 발생합니다.If you specify stored or prompted credentials, an error will occur at run time.

    자세한 내용은 데이터 연결, 데이터 원본 및 연결 문자열(보고서 작성기 및 SSRS) 또는 보고서 작성기에 자격 증명 지정을 참조하세요.For more information, see Data Connections, Data Sources, and Connection Strings (Report Builder and SSRS) or Specify Credentials in Report Builder.

쿼리Queries

쿼리는 보고서 데이터 집합에 대해 검색할 데이터를 지정합니다.A query specifies which data to retrieve for a report dataset. 쿼리 결과 집합의 열은 데이터 집합의 필드 컬렉션을 채웁니다.The columns in the result set for a query populate the field collection for a dataset. 보고서는 쿼리에서 검색된 첫 번째 결과 집합만 처리합니다.A report processes only the first result set retrieved by a query.

쿼리를 만들려면 텍스트 기반 쿼리 디자이너를 사용해야 합니다.You must use the text-based query designer to create the query. 쿼리는 XML 데이터를 반환해야 합니다.The query must return XML data.

텍스트 기반 쿼리 디자이너에 대한 자세한 내용은 텍스트 기반 쿼리 디자이너 사용자 인터페이스(보고서 작성기)를 참조하세요.For more information about the text-based query designer, see Text-based Query Designer User Interface (Report Builder).

XML 형식의 데이터 원본에 대한 데이터 집합 쿼리에서 사용할 수 있는 값이 아래에 나와 있습니다.The possible values for a dataset query for a data source that is type XML are shown below.

  • 비어 있음Empty

    기본 결과 집합을 만들려면 빈 쿼리를 사용합니다.Use an empty query to create a default result set. 기본 쿼리는 데이터 원본을 읽고 XML 노드 계층에서 첫 번째 리프 컬렉션까지 탐색하도록 만들어집니다.The default query is created by reading the data source and traversing the XML node hierarchy to the first leaf collection. 결과 집합에는 텍스트 값이 있는 모든 노드와 해당 경로의 모든 노드 특성이 포함됩니다.The result set includes all nodes with text values and all node attributes along that path. 결과 집합의 열은 데이터 집합의 필드에 매핑됩니다.Columns in the result set are mapped to fields for the dataset.

  • 요소 경로An element path

    데이터 원본에서 XML 데이터를 검색할 때 사용할 노드 시퀀스를 지정합니다.Specifies the sequence of nodes to use when retrieving XML data from the data source.

  • XML 쿼리 요소An XML Query element

    다음과 같은 선택적 요소를 포함하는 XML 쿼리 사양입니다.An XML query specification with the following optional elements:

    • XML 데이터 원본은 웹 서비스입니다.XML data source is a Web service

      필수 XML 요소:Required XML elements:

      <Method Namespace= "namespace" Name="MethodName" /><Method Namespace= "namespace" Name="MethodName" />

      -- or --

      <SoapAction> soap action </SoapAction><SoapAction> soap action </SoapAction>

      선택적 XML 요소:Optional XML Elements:

      <ElementPath> element path </ElementPath><ElementPath> element path </ElementPath>

      <Method Namespace= "namespace" Name="MethodName" /><Method Namespace= "namespace" Name="MethodName" />

      -- or --

      <SoapAction> soap action </SoapAction><SoapAction> soap action </SoapAction>

    • XML 데이터 원본은 XML 문서입니다.XML data source is an XML document

      필수 XML 요소: 없음Required XML elements: None

      선택적 XML 요소:Optional XML Elements:

      <ElementPath> element path </ElementPath><ElementPath> element path </ElementPath>

    • XML 데이터 원본은 포함된 XML 문서입니다.XML data source is an embedded XML document

      필수 XML 요소:Required XML elements:

      <XmlData> inner XML </XmlData><XmlData> inner XML </XmlData>

      선택적 XML 요소:Optional XML Elements:

      <ElementPath> element path </ElementPath><ElementPath> element path </ElementPath>

      -- or --

      <ElementPath IgnoreNamespaces="true"> element path </ElementPath><ElementPath IgnoreNamespaces="true"> element path </ElementPath>

    쿼리 구문에 대한 자세한 내용은 msdn.microsoft.com의 SQL ServerSQL Server 온라인 설명서에서 Reporting ServicesReporting Services 설명서의 XML 보고서 데이터를 위한 XML 쿼리 구문(SSRS)을 참조하세요.For more information about query syntax, see XML Query Syntax for XML Report Data (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online on msdn.microsoft.com.

    예를 보려면 Reporting Services: XML 및 웹 서비스 데이터 원본 사용(Reporting Services: Using XML and Web Service Data Sources)을 참조하십시오.For examples, see Reporting Services: Using XML and Web Service Data Sources.

XML 웹 서비스 데이터 검색을 위한 요구 사항Requirements for Retrieving XML Web Service Data

XML 데이터 처리 확장 프로그램은 스키마를 검색하지 않습니다.The XML data processing extension does not detect the schema for you. 따라서 다른 방법으로 원하는 데이터를 검색할 SOAP 메서드를 찾아야 합니다.Therefore, you must have some way of discovering which SOAP methods will retrieve the data that you want. 또한 웹 서비스에서 해당 데이터에 사용하는 주소 지정 스키마나 네임스페이스에 대해 이해하고 있어야 합니다.You must also understand the addressing scheme or namespace that the Web service uses for its data.

웹 서비스의 경우 호출할 메서드나 SOAP 동작을 지정하는 <Query> 요소를 지정할 수 있습니다.For a Web service, you can provide a <Query> element that specifies a method to call or SOAP action. XML 데이터 원본에 보고서에 사용할 데이터를 생성하는 계층 구조가 있는 경우 쿼리를 비워 두고 기본 쿼리를 사용할 수 있습니다.You can leave the query empty and use the default query if the XML data source has a hierarchical structure that produces the data that you want to use for your report. 쿼리가 실행될 때 검색되는 XML 요소 노드 값 및 특성은 보고서에서 사용하는 데이터 집합 필드에 매핑됩니다.XML element node values and attributes retrieved when the query runs map to the dataset fields you use in your report.

XML 문서 데이터 검색을 위한 요구 사항Requirements for Retrieving XML Document Data

http 프로토콜을 사용할 경우 서버에서 XML 데이터를 반환하거나 XML 데이터가 XML Query 요소에 포함되어 있어야 합니다.Using the http protocol, the server must return XML data or the XML data must be embedded in the XML Query element. http 프로토콜을 사용하여 XML 문서를 직접 참조하려면 해당 문서의 확장명이 .xml이어야 합니다.If you refer to an XML document directly using the http protocol, the extension must be .xml.

필요한 모든 데이터를 검색하는 XML 쿼리를 만드는 방법을 알고 있어야 합니다.You must know how to create an XML query that retrieves all the data you need. 요소 경로를 지정하지 않으면 XML 문서를 구문 분석하는 기본 동작에 따라 XML 문서의 리프 노드 컬렉션에 대한 첫 번째 사용 가능 경로가 선택됩니다.If you do not specify an element path, the default behavior for parsing an XML document is to select the first available path to a leaf-node collection in the XML document. XML 문서에 다른 형제 리프 노드 컬렉션에 대한 추가 경로가 포함되어 있는 경우 쿼리에 경로를 지정하지 않으면 해당 노드는 무시됩니다.If the XML document includes additional paths to other sibling leaf-node collections, those nodes will be ignored unless you specify a path in your query.

XQuery와 유사한 XML 구문을 사용하여 요소 경로를 지정할 수 있습니다.You can provide an element path using XML syntax similar to XQuery.

자세한 내용은 msdn.microsoft.com의 SQL ServerSQL Server 온라인 설명서에서 Reporting ServicesReporting Services 설명서의 XML 보고서 데이터를 위한 요소 경로 구문(SSRS)을 참조하세요.For more information, see Element Path Syntax for XML Report Data (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online on msdn.microsoft.com.

매개 변수Parameters

쿼리는 매개 변수 식별을 위해 분석되지 않습니다.The query is not analyzed to identify parameters.

매개 변수를 추가하려면 데이터 집합 속성 대화 상자의 매개 변수 페이지를 통해 직접 만들어야 합니다.To add parameters, you must create them manually through the Parameter page on the Dataset Properties dialog box.

주의Remarks

XML 데이터 확장 프로그램은 계층 구조가 아닌 테이블 형식 XML 데이터의 보고를 지원합니다.The XML data extension supports reporting from XML data that is tabular and not hierarchical. 자세한 내용은 외부 데이터 원본의 데이터 추가(SSRS)를 참조하세요.For more information, see Add Data from External Data Sources (SSRS).

SQL ServerSQL Server 데이터베이스에서 XML 문서를 검색하는 작업은 기본적으로 지원되지 않습니다.There is no built-in support for retrieving XML documents from a SQL ServerSQL Server database.

방법 도움말 항목How-To Topics

이 섹션에서는 데이터 연결, 데이터 원본 및 데이터 집합을 사용하는 방법을 단계별로 설명합니다.This section contains step-by-step instructions for working with data connections, data sources, and datasets.

데이터 연결 추가 및 확인(보고서 작성기 및 SSRS)Add and Verify a Data Connection (Report Builder and SSRS)

공유 데이터 집합 또는 포함된 데이터 집합 만들기(보고서 작성기 및 SSRS)Create a Shared Dataset or Embedded Dataset (Report Builder and SSRS)

데이터 집합에 필터 추가(보고서 작성기 및 SSRS)Add a Filter to a Dataset (Report Builder and SSRS)

설명서의 다음 섹션에서는 보고서 데이터에 대한 깊이 있는 개념 정보를 제공하며, 데이터와 관련된 보고서 부분을 정의, 사용자 지정 및 사용하는 방법을 절차적인 측면에서 소개합니다.These sections of the documentation provide in-depth conceptual information about report data, as well as procedural information about how to define, customize, and use parts of a report that are related to data.

보고서 데이터 집합(SSRS)Report Datasets (SSRS)
보고서의 데이터 액세스에 대한 개요를 제공합니다.Provides an overview of accessing data for your report.

보고서 작성기의 데이터 연결, 데이터 원본 및 연결 문자열Data Connections, Data Sources, and Connection Strings in Report Builder
데이터 연결 및 데이터 원본에 대한 정보를 제공합니다.Provides information about data connections and data sources.

보고서 포함된 데이터 집합 및 공유 데이터 집합(보고서 작성기 및 SSRS)Report Embedded Datasets and Shared Datasets (Report Builder and SSRS)
포함된 데이터 집합 및 공유 데이터 집합에 대한 정보를 제공합니다.Provides information about embedded and shared datasets.

데이터 집합 필드 컬렉션(보고서 작성기 및 SSRS)Dataset Fields Collection (Report Builder and SSRS)
쿼리에 의해 생성되는 데이터 집합 필드 컬렉션에 대한 정보를 제공합니다.Provides information about the dataset field collection generated by the query.

SQL ServerSQL Server 온라인 설명서에 있는 Reporting ServicesReporting Services 설명서의 Reporting Services(SSRS)에서 지원하는 데이터 원본.Data Sources Supported by Reporting Services (SSRS) in the Reporting ServicesReporting Services documentation in SQL ServerSQL Server Books Online.
각 데이터 확장 프로그램의 플랫폼 및 버전 지원에 대한 자세한 정보를 제공합니다.Provides in-depth information about platform and version support for each data extension.

관련 항목:See Also

보고서 매개 변수(보고서 작성기 및 보고서 디자이너) Report Parameters (Report Builder and Report Designer)
데이터 필터링, 그룹화 및 정렬(보고서 작성기 및 SSRS) Filter, Group, and Sort Data (Report Builder and SSRS)
식(보고서 작성기 및 SSRS)Expressions (Report Builder and SSRS)