SharePoint 목록 연결 형식(SSRS)SharePoint List Connection Type (SSRS)

이 항목은 다음에 적용됩니다.예SQL Server 2016예Power BI 보고서 서버THIS TOPIC APPLIES TO:yesSQL Server 2016yesPower BI Report Server 예SharePointSharePoint 예SharePointSharePoint

Microsoft SharePoint 목록의 데이터를 보고서에 포함하려면 Microsoft SharePoint 목록 유형의 보고서 데이터 원본을 기반으로 하는 데이터 집합을 추가하거나 만들어야 합니다.To include data from a Microsoft SharePoint list in your report, you must add or create a dataset that is based on a report data source of type Microsoft SharePoint List. 이는 Microsoft SQL Server Reporting Services SharePoint 목록 데이터 확장 프로그램을 기반으로 하는 기본 제공 데이터 원본 유형입니다.This is a built-in data source type based on the Microsoft SQL Server Reporting Services SharePoint List data extension. 이 데이터 원본 유형을 사용 하 여 연결 하 고 SharePoint 2013에서 이상과 목록 데이터를 검색 합니다.Use this data source type to connect to and retrieve list data from SharePoint 2013 and later.

이 항목의 정보를 사용하여 데이터 원본을 작성할 수 있습니다.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

SharePoint 목록에 대한 연결 문자열은 SharePoint 사이트 또는 하위 사이트에 대한 URL입니다(예: http://MySharePointWeb/MySharePointSite 또는 http://MySharePointWeb/MySharePointSite/Subsite).The connection string to a SharePoint list is the URL to the SharePoint site or subsite, for example, http://MySharePointWeb/MySharePointSite or http://MySharePointWeb/MySharePointSite/Subsite.

쿼리 디자이너는 사용자가 액세스할 수 있는 권한이 있는 SharePoint 목록을 자동으로 표시합니다.The query designer automatically displays the SharePoint lists that you have sufficient permissions to access.

연결 문자열 예제는 보고서 작성기의 데이터 연결, 데이터 원본 및 연결 문자열을 참조하세요.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. 이 데이터 확장 프로그램과 함께 사용할 수 있는 자격 증명의 유형은 데이터 원본으로 사용 중인 SharePoint 목록에 대한 SharePoint 기술 구성에 따라 다릅니다.The types of credentials that can be used with this data extension depend on the SharePoint technology configuration for the SharePoint list that you are using as a data source.

다음 표에서는 로컬 팜 SharePoint 목록 및 원격 SharePoint 목록에 연결할 때 SharePoint 목록 확장에 대한 자격 증명 검색 동작을 보여 줍니다.The following tables outline credential retrieval behavior for the SharePoint list extension, when connecting to a local farm SharePoint list and to a remote SharePoint list.

표 1 은 레거시 Windows SharePoint 사이트에 배포되는 보고서에 대한 것입니다.Table 1 is for reports deployed to a legacy Windows SharePoint Site. 레거시 Windows 사이트는 Kerberos, NTLM 및 FBA(Forms Based Authentication)만 지원합니다.A legacy Windows site supports only Kerberos, NTLM, and Forms Based Authentication (FBA). 표 2 는 클레임 기반 SharePoint 사이트에 배포되는 보고서에 대한 것입니다.Table 2 is for reports deployed to a Claims-based SharePoint site.

표 1Table 1

지원되는 자격 증명Supported Credentials 클래식 모드 Windows 인증Classic Mode Windows Authentication 클레임 인증Claims Authentication
로컬 팜 SharePoint 팜 목록Local farm SharePoint List Windows 인증(통합) 또는 SharePoint 사용자 토큰Windows Authentication (integrated) or SharePoint User Token Yes Yes
저장됨, 프롬프트, 없음(Windows 자격 증명 사용)Stored, Prompt, None (with Windows credentials)

Windows 자격 증명이 아닌 다른 자격 증명이 포함된 저장된 자격 증명 및 프롬프트 자격 증명은 지원되지 않습니다.Stored and prompt credentials with non-Windows credentials is not supported.
Yes 아니오No
원격 SharePoint 목록Remote SharePoint List Windows 인증(통합) 또는 SharePoint 사용자 토큰Windows Authentication (integrated) or SharePoint User Token Yes 아니오No

폼 기반 인증 및 클레임 인증은 원격 SharePoint 목록에 지원되지 않습니다.Forms-based authentication and Claims authentication are not supported for remote SharePoint lists.
저장됨, 프롬프트, 없음(Windows 자격 증명 사용)Stored, Prompt, None (with Windows credentials)

Windows 자격 증명이 아닌 다른 자격 증명이 포함된 저장된 자격 증명 및 프롬프트 자격 증명은 지원되지 않습니다.Stored and prompt credentials with non-Windows credentials is not supported.
Yes 아니오No

폼 기반 인증 및 클레임 인증은 원격 SharePoint 목록에 지원되지 않습니다.Forms-based authentication and Claims authentication are not supported for remote SharePoint lists.

Windows 인증, FBA(폼 기반 인증), SAML(Secure Application Markup Language) 토큰, 기타 ID 공급자 또는 위에 명시된 인증 공급자 중 둘 이상의 조합입니다.Windows authentication, Forms Based authentication (FBA), Secure Application Markup Language (SAML) tokens, other identity providers or a combination of more than one of the above mentioned authentication providers.

표 2Table 2

지원되는 자격 증명Supported Credentials 클래식 모드 Windows 인증Classic Mode Windows Authentication 클레임 인증Claims Authentication
로컬 팜 SharePoint 팜 목록Local Farm SharePoint List Windows 인증(통합) 또는 SharePoint 사용자 토큰Windows Authentication (integrated) or SharePoint User Token Yes Yes
저장됨, 프롬프트, 없음(Windows 자격 증명 사용)Stored, Prompt, None (with Windows credentials)

Windows 자격 증명이 아닌 다른 자격 증명이 포함된 저장된 자격 증명 및 프롬프트 자격 증명은 지원되지 않습니다.Stored and prompt credentials with non-Windows credentials is not supported.
아니오No 아니오No
원격 SharePoint 목록Remote SharePoint List Windows 인증(통합) 또는 SharePoint 사용자 토큰Windows Authentication (integrated) or SharePoint User Token Yes 아니오No

폼 기반 인증 및 클레임 인증은 원격 SharePoint 목록에 지원되지 않습니다.Forms-based authentication and Claims authentication are not supported for remote SharePoint lists.
저장됨, 프롬프트, 없음(Windows 자격 증명 사용)Stored, Prompt, None (with Windows credentials)

Windows 자격 증명이 아닌 다른 자격 증명이 포함된 저장된 자격 증명 및 프롬프트 자격 증명은 지원되지 않습니다.Stored and prompt credentials with non-Windows credentials is not supported.
아니오No 아니오No

폼 기반 인증 및 클레임 인증은 원격 SharePoint 목록에 지원되지 않습니다.Forms-based authentication and Claims authentication are not supported for remote SharePoint lists.

Windows 인증, FBA(폼 기반 인증), SAML(Secure Application Markup Language) 토큰, 기타 ID 공급자 또는 위에 명시된 인증 공급자 중 둘 이상의 조합입니다.Windows authentication, Forms Based authentication (FBA), Secure Application Markup Language (SAML) tokens, other identity providers or a combination of more than one of the above mentioned authentication providers.

Windows 인증Windows Authentication
트러스트된 계정 모드에서 보고서 서버와 함께 작동하도록 구성된 SharePoint 기술의 경우 이 옵션은 지원되지 않습니다.For a SharePoint technology that is configured to work with a report server in Trusted Account mode, this option is not supported. 이 옵션은 SQL Server 2012 Reporting Services 이전 릴리스에만 적용됩니다.This applies only to releases prior to SQL Server 2012 Reporting Services.

Windows 통합 모드에서 보고서 서버와 함께 작동하도록 구성된 SharePoint 기술의 경우 이 옵션은 현재 Windows 사용자 및 현재 SharePoint 사용자 둘 다에 적용됩니다.For a SharePoint technology that is configured to work with a report server in Windows Integrated mode, this option applies to both the current Windows user and the current SharePoint user.

보고서 서버(로컬 모드) 없이 작동하도록 구성된 SharePoint 기술의 경우 이 옵션은 지원되지 않습니다.For a SharePoint technology that is configured to work without a Report Server (local mode), this option is not supported. 로컬 모드에 대한 자세한 내용은 보고서 뷰어의 로컬 모드와 보고서 뷰어의 연결 모드 보고서(SharePoint 모드의 Reporting Services)를 참조하세요.For more information on local mode, see Local Mode vs. Connected Mode Reports in the Report Viewer (Reporting Services in SharePoint Mode).

자격 증명 필요 없음(자격 증명 사용 안 함):Credentials are not required (Do not use credentials):
이 옵션을 사용하려면 보고서 서버에서 무인 실행 계정을 구성해야 합니다.To use this option, the unattended execution account must be configured on the report server. 자세한 내용은 무인 실행 계정 구성(SSRS 구성 관리자)을 참조하세요.For more information, see Configure the Unattended Execution Account (SSRS Configuration Manager).

Microsoft BI 스택 간 클레임 인증 지원에 대한 자세한 내용은 Microsoft BI 스택 간 클레임 인증 사용을 참조하십시오.For information about Claims authentication support across the Microsoft BI stack, see Using Claims Authentication across the Microsoft BI Stack.

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

쿼리 Queries

쿼리를 디자인하려면 데이터 원본을 기준으로 새 데이터 집합을 만든 다음 연결된 쿼리 디자이너를 엽니다.To design a query, create a new dataset based on the data source, and then open the associated query designer. 자세한 내용은 공유 데이터 집합 또는 포함된 데이터 집합 만들기(보고서 작성기 및 SSRS)을 참조하세요.For more information, see Create a Shared Dataset or Embedded Dataset (Report Builder and SSRS).

SharePoint 목록 그래픽 쿼리 디자이너에는 4개의 창이 표시됩니다.The SharePoint List graphical query designer displays four panes:

SharePoint 목록 이 데이터 원본에 대해 사이트의 모든 SharePoint 목록이 포함된 목록을 표시합니다.SharePoint Lists Displays a list of all the SharePoint lists on the site for this data source. 목록을 선택한 다음 쿼리에 포함할 필드를 선택합니다.Select a list and then select the fields that you want in your query. 이 창의 필드 이름은 SharePoint 이름(표시 이름)입니다.The names of fields in this pane are the SharePoint friendly names, also known as display names. 항목 위로 마우스를 이동하면 도구 설명에 다음 속성이 표시됩니다.Hover over an item to display the following properties in the tooltip:

  • 이름 필드의 고유 이름입니다.Name The unique name of the field.

  • 식별자 필드의 고유 식별자입니다.Identifier The unique identifier of the field.

  • 필드 형식 필드의 데이터 형식입니다.Field Type The data type of the field.

  • 숨김 필드가 SharePoint 목록 보기에 표시되는지 여부입니다.Hidden Whether the field displays in the SharePoint list view.

    여러 목록에서 필드를 선택할 수는 없습니다.Selecting fields from multiple lists is not supported. 각 목록에 대해 데이터 집합을 만들고 각 데이터 집합에서 필드를 선택할 수 있습니다.You can create a dataset for each list and select fields from each dataset. 목록에 공용 필드가 있는 경우, 한 데이터 집합에 바인딩된 테이블릭스 데이터 영역에서 Lookup 함수를 사용하여 데이터 영역에 바인딩되지 않는 다른 데이터 집합의 값을 검색할 수 있습니다.If the lists have a common field, you can use the Lookup function in a tablix data region that is bound to one dataset to retrieve a value from the other dataset that is not bound to the data region. 자세한 내용은 조회 함수(보고서 작성기 및 SSRS)를 참조하세요.For more information, see Lookup Function (Report Builder and SSRS).

  • 선택한 필드 선택한 필드를 표시합니다.Selected Fields Displays the fields that you have selected. 이 창의 필드 이름은 SharePoint 사용자가 지정한 이름입니다.The names of fields in this pane are friendly names that a SharePoint user has specified. 쿼리 디자이너를 닫으면 이 이름이 보고서 데이터 창의 데이터 집합 필드 모음에 표시됩니다.When you close the query designer, you see these names in the dataset field collection in the Report Data pane. 고유 이름과 이름 간의 관계는 데이터 집합 속성 대화 상자, 필드(보고서 작성기) 페이지에 나와 있습니다.The relationship between unique names and friendly names is available in the Dataset Properties Dialog Box, Fields (Report Builder) page.

  • 적용된 필터 SharePoint 목록에서 반환되는 데이터를 보고서로 반환하기 전에 제한합니다.Applied Filters Limits the data that is returned from the SharePoint list, before the data is returned to the report. 사용할 필드 이름, 연산자 및 값을 선택하여 목록에서 검색되는 데이터를 제한합니다.Select the field name, operator, and value to use to limit the data that is retrieved in the list. 연산자는 선택한 값의 데이터 형식에 따라 달라집니다.The operators vary depending on the data type of the value that you select.

    그래픽 쿼리 디자이너에서는 정렬 순서를 변경하거나 그룹을 지정할 수 없습니다.You cannot change the sort order or specify groups in the graphical query designer. 이렇게 하려면 보고서 데이터 집합에 대해 정렬 식을 설정하고 보고서의 데이터 영역에서 식을 그룹화합니다.To do that, set sort expressions on the report dataset, and group expressions on the data regions in the report. 쿼리 매개 변수는 지원되지 않습니다.Query parameters are not supported. 보고서의 데이터를 필터링하려면 보고서 필터 또는 보고서 매개 변수를 만들어서 사용하십시오.To filter data in the report, use report filters or report parameters that you create. 자세한 내용은 데이터 필터링, 그룹화 및 정렬(보고서 작성기 및 SSRS)보고서 매개 변수(보고서 작성기 및 보고서 디자이너)을 참조하세요.For more information, see Filter, Group, and Sort Data (Report Builder and SSRS) and Report Parameters (Report Builder and Report Designer).

  • 쿼리 결과 쿼리 실행 시 반환되는 예제 행을 표시합니다.Query Results Displays example rows that are returned when the query runs. SharePoint 사이트에서 SharePoint 목록 값이 자주 변경되는 경우 쿼리 결과 창에 표시되는 값과 보고서에 표시되는 값이 다를 수 있습니다.If the SharePoint list values change frequently on the SharePoint site, the values that you see in the query results pane might differ from the values that you see in the report.

  • 선택한 필드 선택한 필드를 표시합니다.Selected Fields Displays the fields that you have selected. 이 창의 필드 이름은 SharePoint 사용자가 지정한 이름입니다.The names of fields in this pane are friendly names that a SharePoint user has specified. 쿼리 디자이너를 닫으면 이 이름이 보고서 데이터 창의 데이터 집합 필드 모음에 표시됩니다.When you close the query designer, you see these names in the dataset field collection in the Report Data pane. 고유 이름과 이름 간의 관계는 데이터 집합 속성 대화 상자, 필드(보고서 작성기) 페이지에 나와 있습니다.The relationship between unique names and friendly names is available in the Dataset Properties Dialog Box, Fields (Report Builder) page.

  • 적용된 필터 SharePoint 목록에서 반환되는 데이터를 보고서로 반환하기 전에 제한합니다.Applied Filters Limits the data that is returned from the SharePoint list, before the data is returned to the report. 사용할 필드 이름, 연산자 및 값을 선택하여 목록에서 검색되는 데이터를 제한합니다.Select the field name, operator, and value to use to limit the data that is retrieved in the list. 연산자는 선택한 값의 데이터 형식에 따라 달라집니다.The operators vary depending on the data type of the value that you select.

    그래픽 쿼리 디자이너에서는 정렬 순서를 변경하거나 그룹을 지정할 수 없습니다.You cannot change the sort order or specify groups in the graphical query designer. 이렇게 하려면 보고서 데이터 집합에 대해 정렬 식을 설정하고 보고서의 데이터 영역에서 식을 그룹화합니다.To do that, set sort expressions on the report dataset, and group expressions on the data regions in the report. 쿼리 매개 변수는 지원되지 않습니다.Query parameters are not supported. 보고서의 데이터를 필터링하려면 보고서 필터 또는 보고서 매개 변수를 만들어서 사용하십시오.To filter data in the report, use report filters or report parameters that you create. 자세한 내용은 데이터 필터링, 그룹화 및 정렬(보고서 작성기 및 SSRS)보고서 매개 변수(보고서 작성기 및 보고서 디자이너)을 참조하세요.For more information, see Filter, Group, and Sort Data (Report Builder and SSRS) and Report Parameters (Report Builder and Report Designer).

  • 쿼리 결과 쿼리 실행 시 반환되는 예제 행을 표시합니다.Query Results Displays example rows that are returned when the query runs. SharePoint 사이트에서 SharePoint 목록 값이 자주 변경되는 경우 쿼리 결과 창에 표시되는 값과 보고서에 표시되는 값이 다를 수 있습니다.If the SharePoint list values change frequently on the SharePoint site, the values that you see in the query results pane might differ from the values that you see in the report.

    자세한 내용은 SharePoint 목록 쿼리 디자이너(보고서 작성기)를 참조하세요.For more information, see SharePoint List Query Designer (Report Builder).

쿼리 텍스트Query Text

그래픽 쿼리 디자이너에서 생성한 쿼리를 보려면 텍스트 기반 쿼리 디자이너로 전환합니다.To view the query that is generated by the graphical query designer, switch to the text-based query designer. 이 보기에서 그래픽 쿼리 디자이너가 만든 XML을 볼 수 있습니다.In this view, you can see the XML that is created by the graphical query designer. XML에는 목록 이름, 필드, 모음 및 필터 요소가 포함되어 있습니다.The XML includes elements for the list name, the field collection, and the filter.

예 1.Example 1. 목록의 지정된 필드Specified fields for a list

다음 예제에서는 올바른 형식의 SharePoint 쿼리를 보여 줍니다.The following example shows a well-formed SharePoint query:

<RSSharePointList>  
<listName>MyList</listName>  
<viewFields>  
  <FieldRef Name="Field1"/>  
  <FieldRef Name="Field4"/>  
</viewFields>  
<Query>  
  <Where>  
    <And>  
      <Gt>  
        <FieldRef Name="Field1"/>  
        <Value Type="Integer">1</Value>  
      </Gt>  
      <IsNotNull>  
        <FieldRef Name="Field2"/>  
        <Value Type="string"/>  
      </IsNotNull>   
    </And>  
  </Where>  
</Query>  
</RSSharePointList>  

올바른 형식의 XML 텍스트를 유지하면서 이 쿼리 보기를 편집할 수 있습니다.You can edit this view of the query as long as it remains well-formed XML text.

예 2.Example 2. 목록의 모든 필드All fields for a list

목록의 이름만 지정할 수도 있습니다. 그러면 숨겨진 필드를 비롯해 모든 필드가 반환됩니다.You can also specify only the name of a list, and all fields, including hidden fields, are returned. 다음 예에서는 Tasks라는 목록의 모든 필드를 검색합니다.The following example retrieves all the fields from a list that is named Tasks:

<RSSharePointList>  
<listName>Tasks</listName>  
</RSSharePointList>  

Tasks 목록의 모든 필드가 쿼리 결과에 반환됩니다.All fields for the list Tasks are returned in the query results.

매개 변수 Parameters

이 데이터 확장 프로그램은 매개 변수를 지원하지 않습니다.Parameters are not supported by this data extension.

방법 도움말 항목 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
필터, 그룹 및 데이터 정렬 Filter, Group, and Sort Data
식(보고서 작성기 및 SSRS)Expressions (Report Builder and SSRS)

문의:More questions? Reporting Services 포럼에서 질문Try asking the Reporting Services forum