복사 작업에서 SharePoint Online 목록 구성

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

필수 조건

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

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

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

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

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

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

      • App Do기본:contoso.com

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

      • 권한 요청 XML:

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

      

      참고 항목

      SharePoint 커넥터를 구성하는 컨텍스트에서 App Do기본 및 리디렉션 URL은 Microsoft Entra ID에 등록한 SharePoint 앱을 참조하여 SharePoint 데이터에 대한 액세스를 허용합니다. App Do기본는 SharePoint 사이트가 호스트되는 기본. 예를 들어 SharePoint 사이트가 있는 https://contoso.sharepoint.com경우 App Do기본 됩니다contoso.sharepoint.com. 리디렉션 URL은 사용자가 앱에 대한 권한을 인증하고 부여한 후 SharePoint 앱이 리디렉션하는 URL입니다. 이 URL은 앱에 액세스할 수 있는 권한이 있는 SharePoint 사이트의 페이지여야 합니다. 예를 들어 라이브러리의 파일 목록을 표시하는 페이지의 URL이나 문서의 내용을 표시하는 페이지를 사용할 수 있습니다.

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

지원되는 구성

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

• 일반
• Source
• 매핑
• 설정

일반

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

원본

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

다음 속성이 필요합니다.

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

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

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

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

    

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

    

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

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

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

  

매핑

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

설정

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

테이블 요약

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

원본

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

관련 콘텐츠

• SharePoint Online 목록 연결 설정