다음을 통해 공유


복사 작업에서 REST 구성

이 문서에서는 데이터 파이프라인에서 복사 작업을 사용하여 REST 엔드포인트에서 데이터를 복사하는 방법을 간략하게 설명합니다.

특히 이 일반 REST 커넥터는 다음을 지원합니다.

  • GET 또는 POST 메서드를 사용하여 데이터를 REST 엔드포인트로 복사하고 Post, PUT 또는 PATCH 메서드를 사용하여 데이터를 복사합니다.
  • REST API의 페이지 매김
  • 원본인 REST에 REST JSON 응답을 있는 그대로 복사하거나 스키마 매핑을 사용하여 구문 분석합니다. JSON의 응답 페이로드만 지원됩니다.

지원되는 구성

복사 작업 아래의 각 탭을 구성하려면 각각 다음 섹션으로 이동합니다.

일반

일반 탭을 구성하려면 일반으로 이동합니다.

원본

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

원본 탭 및 속성 목록을 보여주는 스크린샷.

다음 첫 3개의 속성은 필수입니다.

  • 데이터 저장소 유형: 외부를 선택합니다.
  • 연결: 연결 목록에서 REST 연결을 선택합니다. 연결이 없으면 새로 만들기를 선택하여 새 REST 연결을 만듭니다.
  • 연결 유형: REST를 선택합니다.
  • 상대 URL:데이터를 포함하는 리소스에 대한 상대 URL입니다. 이 속성을 지정하지 않으면 연결 정의에 지정된 URL만 사용됩니다. HTTP 커넥터가 결합된 URL([URL specified in connection]/[relative URL specified])에서 데이터를 복사합니다.

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

  • 요청 메서드: HTTP 메서드입니다. 허용되는 값은 GET(기본값) 또는 POST입니다.

    요청 메서드를 보여주는 스크린샷.

  • 요청 시간 제한: HTTP 요청이 응답을 받기 위한 시간 제한(시간 범위 값)입니다. 이 값은 응답 데이터를 읽는 시간 제한이 아니라, 응답을 받을 시간 제한입니다. 기본값은 00:01:40입니다.

  • 요청 간격(ms): 여러 페이지에 대한 서로 다른 요청 간의 간격 시간(밀리초)입니다. 요청 간격 값은 [10, 60000] 사이의 숫자여야 합니다.

  • 추가 헤더: 추가 HTTP 요청 헤더입니다.

    추가 헤더를 보여주는 스크린샷.

  • 페이지 매김 규칙: 페이지 매김 규칙: 다음 페이지 요청을 작성하기 위한 페이지 매김 규칙입니다. 자세한 내용은 페이지 매김 지원 섹션을 참조하세요.

    페이지 매김 컨트롤을 보여주는 스크린샷.

  • 추가 열: 원본 파일의 상대 경로 또는 정적 값을 저장할 데이터 열을 더 추가합니다. 정적 값을 사용하는 경우 사용자 지정 식을 사용하여 생성할 수 있습니다.

    추가 열을 보여주는 스크린샷.

대상

복사 작업의 대상 탭에서 REST에 대해 지원되는 속성은 다음과 같습니다.

대상 탭 정보를 보여주는 스크린샷.

다음 첫 3개의 속성은 필수입니다.

  • 데이터 저장소 유형: 외부를 선택합니다.
  • 연결: 연결 목록에서 REST 연결을 선택합니다. 연결이 없으면 새로 만들기를 선택하여 새 REST 연결을 만듭니다.
  • 연결 유형: REST를 선택합니다.
  • 상대 URL:데이터를 포함하는 리소스에 대한 상대 URL입니다. 이 속성을 지정하지 않으면 연결 정의에 지정된 URL만 사용됩니다. HTTP 커넥터가 결합된 URL([URL specified in connection]/[relative URL specified])에서 데이터를 복사합니다.

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

  • 요청 메서드: HTTP 메서드입니다. 허용되는 값은 POST(기본값), PUT, PATCH입니다.

  • 요청 시간 제한: HTTP 요청이 응답을 받기 위한 시간 제한(시간 범위 값)입니다. 이 값은 응답 데이터를 쓰는 시간 제한이 아니라, 응답을 받을 시간 제한입니다. 기본값은 00:01:40입니다.

  • 요청 간격(ms): 여러 페이지에 대한 서로 다른 요청 간의 간격 시간(밀리초)입니다. 요청 간격 값은 [10, 60000] 사이의 숫자여야 합니다.

  • 쓰기 일괄 처리 크기: 일괄 처리당 REST 대상에 쓸 레코드 수입니다. 기본값은 10000입니다.

  • Http 압축 형식: 최적의 압축 수준으로 데이터를 전송하는 동안 사용할 HTTP 압축 형식입니다. 허용되는 값은 없음GZip입니다.

  • 추가 헤더: 추가 HTTP 요청 헤더입니다.

    추가 헤더를 보여주는 스크린샷.

매핑

매핑 탭 구성에 대해서는 매핑 탭에서 매핑 구성으로 이동합니다. 데이터 원본과 대상이 모두 계층적 데이터인 경우에는 매핑이 지원되지 않습니다.

설정

설정 탭을 구성하려면 설정 탭에서 기타 설정 구성으로 이동합니다.

표 요약

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

원본 정보

이름 설명 필수 JSON 스크립트 속성
데이터 저장소 유형 데이터 저장소 유형입니다. 작업 영역
외부
샘플 데이터 세트
유형
연결 원본 데이터 저장소에 대한 연결입니다. <연결> 연결
연결 유형 연결 유형입니다. REST를 선택합니다. REST (영문) 유형:
RestResource
상대 URL 데이터를 포함하는 리소스에 대한 상대 URL입니다. 이 속성을 지정하지 않으면 연결 정의에 지정된 URL만 사용됩니다. HTTP 커넥터가 결합된 URL([URL specified in connection]/[relative URL specified])에서 데이터를 복사합니다. <상대 URL> 아니요 relativeUrl
요청 메서드 HTTP 메서드입니다. 허용되는 값은 GET(기본값) 또는 POST입니다. GET
POST
아니요 requestMethod
요청 시간 초과 HTTP 요청이 응답을 받을 시간 제한(TimeSpan 값)입니다. 이 값은 응답 데이터를 읽는 시간 제한이 아니라, 응답을 받을 시간 제한입니다. 기본값은 00:01:40입니다. 시간 범위 아니요 httpRequestTimeout
요청 간격(ms) 여러 페이지에 대한 서로 다른 요청 간의 간격 시간(밀리초)입니다. 요청 간격 값은 [10, 60000] 사이의 숫자여야 합니다. [10, 60000] 아니요 requestInterval
추가 헤더 추가 HTTP 요청 헤더입니다. <추가 헤더> 아니요 additionalHeaders
페이지 매김 규칙 다음 페이지 요청을 작성하기 위한 페이지 매김 규칙입니다. 자세한 내용은 페이지 매김 지원 섹션을 참조하세요. 페이지 매김으로 이동 아니요 paginationRules
추가 열 저장소 원본 파일의 상대 경로 또는 정적 값에 데이터 열을 더 추가합니다. 식은 정적 값에 대해 지원됩니다. • 이름
• 값
아니요 additionalColumns:
• 이름
• 값

대상 정보

이름 설명 필수 JSON 스크립트 속성
데이터 저장소 유형 데이터 저장소 유형입니다. 작업 영역
외부
유형
연결 원본 데이터 저장소에 대한 연결입니다. <연결> 연결
연결 유형 연결 유형입니다. REST를 선택합니다. REST (영문) 유형:
RestResource
상대 URL 데이터를 포함하는 리소스에 대한 상대 URL입니다. 이 속성을 지정하지 않으면 연결 정의에 지정된 URL만 사용됩니다. HTTP 커넥터가 결합된 URL([URL specified in connection]/[relative URL specified])에서 데이터를 복사합니다. <상대 URL> 아니요 relativeUrl
요청 메서드 HTTP 메서드입니다. 허용되는 값은 POST(기본값), PUT, PATCH입니다. POST
GET
PATCH
아니요 requestMethod
요청 시간 초과 HTTP 요청이 응답을 받을 시간 제한(TimeSpan 값)입니다. 이 값은 응답 데이터를 읽는 시간 제한이 아니라, 응답을 받을 시간 제한입니다. 기본값은 00:01:40입니다. 시간 범위 아니요 httpRequestTimeout
요청 간격(ms) 여러 페이지에 대한 서로 다른 요청 간의 간격 시간(밀리초)입니다. 요청 간격 값은 [10, 60000] 사이의 숫자여야 합니다. [10, 60000] 아니요 requestInterval
쓰기 일괄 처리 크기 일괄 처리당 REST 대상에 쓸 레코드 수입니다. 기본값은 10000입니다. <행 개수>
(정수)
아니요 writeBatchSize
Http 압축 유형 최적의 압축 수준으로 데이터를 전송하는 동안 사용할 HTTP 압축 형식. 허용되는 값은 없음GZip입니다. 없음
GZip
아니요 httpCompressionType
추가 헤더 추가 HTTP 요청 헤더입니다. <추가 헤더> 아니요 additionalHeaders