복사 작업에서 SharePoint Online 목록을 구성하는 방법

이 문서에서는 데이터 파이프라인의 복사 작업을 사용하여 SharePoint Online 목록에서 데이터를 복사하는 방법을 간략하게 설명합니다.

중요

Microsoft Fabric은 현재 미리 보기로 제공됩니다. 이 정보는 릴리스되기 전에 상당히 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보와 관련하여 명시적이거나 묵시적인 어떠한 보증도 하지 않습니다. Azure의 서비스에 대한 Azure Data Factory 설명서를 참조하세요.

사전 요구 사항

1. SharePoint Online 목록 커넥터는 서비스 주체 인증을 사용하여 SharePoint에 연결합니다. 다음 단계에 따라 설정합니다.

2. Microsoft ID 플랫폼에 애플리케이션을 등록합니다. 방법을 알아보려면 빠른 시작: Microsoft ID 플랫폼 애플리케이션 등록으로 이동합니다. 연결을 정의하는 데 사용하는 다음 값을 기록해 둡다.

   • 애플리케이션 UI
   • 애플리케이션 키
   • 테넌트 ID

3. 다음 단계를 사용하여 등록된 애플리케이션에 SharePoint Online 사이트 권한을 부여합니다. 권한을 부여하려면 사이트 관리자 역할이 필요합니다.

   1. 예를 들어 SharePoint Online 사이트 링크를 엽니다(예 https://[your_site_url]/_layouts/15/appinv.aspx : 사이트 URL 바꾸기).

   2. 등록한 애플리케이션 ID를 검색하고 빈 필드를 채운 다음 만들기를 선택합니다.

      • 앱 도메인: contoso.com

      • 리디렉션 URL: https://www.contoso.com

      • 권한 요청 XML:

        <AppPermissionRequests AllowAppOnlyPolicy="true">
            <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read"/>
        </AppPermissionRequests>
        

      

      참고

      SharePoint 커넥터를 구성하는 컨텍스트에서 앱 도메인 및 리디렉션 URL은 Azure Active Directory(Azure AD)에 등록한 SharePoint 앱을 참조하여 SharePoint 데이터에 대한 액세스를 허용합니다. 앱 도메인은 SharePoint 사이트가 호스트되는 도메인입니다. 예를 들어 SharePoint 사이트가 에 https://contoso.sharepoint.com있는 경우 앱 도메인 은 입니다 contoso.sharepoint.com. 리디렉션 URL은 사용자가 앱에 대한 권한을 인증하고 부여한 후 SharePoint 앱이 리디렉션하는 URL입니다. 이 URL은 앱에 액세스할 수 있는 권한이 있는 SharePoint 사이트의 페이지여야 합니다. 예를 들어 라이브러리의 파일 목록을 표시하는 페이지의 URL 또는 문서의 콘텐츠를 표시하는 페이지를 사용할 수 있습니다.

   3. 이 앱 에 대해 신뢰 를 선택합니다.

지원되는 구성

복사 작업에서 각 탭의 구성에 대해 각각 다음 섹션으로 이동합니다.

• 일반
• 원본
• Mapping
• 설정

일반

일반 탭 구성의 경우 일반으로 이동합니다.

원본

복사 작업의 원본 탭에서 SharePoint Online 목록에 대해 지원되는 속성은 다음과 같습니다.

다음 속성이 필요합니다.

• 데이터 저장소 유형: 외부를 선택합니다.

• 연결: 연결 목록에서 SharePoint Online 목록 연결을 선택합니다. 연결이 없으면 새로 만들기를 선택하여 새 HTTP 연결을 만듭니다.

• 쿼리 사용: 사용 쿼리로 목록 이름 또는 쿼리 를 선택합니다. 각 설정의 구성은 다음과 같습니다.

  • 목록 이름: SharePoint Online 목록의 이름입니다.

    

  • 쿼리: SharePoint Online 목록에서 데이터를 필터링하는 OData 쿼리입니다. 예들 들어 "$top=1"입니다.

    

고급에서 다음 필드를 지정할 수 있습니다.

• 요청 시간 제한: SharePoint Online에서 응답을 받기 위한 대기 시간입니다. 기본값은 5분(00:05:00)입니다.

• 추가 열: 원본 파일의 상대 경로 또는 정적 값을 저장하는 추가 데이터 열을 추가합니다. 식은 후자에 대해 지원됩니다.

  

매핑

매핑 탭 구성의 경우 매핑 탭에서 매핑 구성으로 이동합니다.

설정

설정 탭 구성의 경우 설정 탭에서 다른 설정 구성으로 이동합니다.

테이블 요약

다음 표에는 SharePoint Online 목록의 복사 활동에 대한 자세한 정보가 포함되어 있습니다.

원본

이름	Description	값	필수	JSON 스크립트 속성
데이터 저장소 유형	데이터 저장소 형식입니다.	외부	예	/
연결	원본 데이터 저장소에 대한 연결입니다.	<연결>	예	connection
쿼리 사용	목록 이름 또는 쿼리를 사용 쿼리로 선택할 수 있습니다.	-목록 이름 -쿼리	예	type
목록 이름	SharePoint Online 목록의 이름입니다.	<연결>	예	listName
요청 시간 초과	SharePoint Online에서 응답을 받기 위한 대기 시간입니다. 기본값은 5분(00:05:00)입니다.	timespan	No	requestTimeout
추가 열	원본 파일의 상대 경로 또는 정적 값을 저장할 추가 데이터 열을 추가합니다. 식은 후자에 대해 지원됩니다.	• 이름 •값	예	additionalColumns: •이름 •값

다음 단계

• SharePoint Online 목록 연결을 만드는 방법
• 데이터 흐름의 SharePoint Online 목록에 연결