복사 작업에서 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 |