다음을 통해 공유

OData 원본

  • 아티클

적용 대상: SQL Server Azure Data Factory의 SSIS Integration Runtime

SSIS 패키지의 OData 원본 구성 요소를 사용하여 OData(Open Data Protocol) 서비스의 데이터를 사용합니다.

지원되는 프로토콜 및 데이터 형식

구성 요소는 OData v3 및 v4 프로토콜을 지원합니다.

  • OData V3 프로토콜의 경우 구성 요소는 ATOM 및 JSON 데이터 형식을 지원합니다.

  • OData V4 프로토콜의 경우 구성 요소는 JSON 데이터 형식을 지원합니다.

지원되는 데이터 원본

OData 원본에는 다음 데이터 원본에 대한 지원이 포함됩니다.

  • Microsoft Dynamics AX Online 및 Microsoft Dynamics CRM Online
  • SharePoint 목록 SharePoint 서버의 모든 목록을 보려면 https://<server>/_vti_bin/ListData.svc URL을 사용합니다. SharePoint URL 규칙에 대한 자세한 내용은 SharePoint Foundation REST 인터페이스를 참조하세요.

지원되는 데이터 유형

OData 원본은 int, byte[], bool, byte, DateTime, DateTimeOffset, decimal, double, Guid, Int16, Int32, Int64, sbyte, float, string 및 TimeSpan과 같은 간단한 데이터 형식을 지원합니다.

데이터 원본에서 열의 데이터 형식을 검색하려면 https://<OData feed endpoint>/$metadata 페이지를 확인합니다.

10진수 데이터 형식의 경우 전체 자릿수와 소수 자릿수는 원본 메타데이터에 의해 결정됩니다. 원본 메타데이터가 Precision 및 Scale 속성을 지정하지 않으면 데이터가 잘려질 수 있습니다.

Important

OData 원본 구성 요소는 SharePoint 목록의 객관식 항목과 같은 복잡한 형식을 지원하지 않습니다.

참고 항목

원본에서 TLS 1.2 연결만 허용하는 경우 레지스트리 설정을 통해 컴퓨터에 TLS 1.2를 적용해야 합니다. 관리자 권한 명령 프롬프트에서 다음 명령을 실행합니다.

reg add HKLM\SOFTWARE\Microsoft.NETFramework\v4.0.30319 /v SchUseStrongCrypto /t REG_DWORD /d 1 /reg:64

reg add HKLM\SOFTWARE\Microsoft.NETFramework\v4.0.30319 /v SchUseStrongCrypto /t REG_DWORD /d 1 /reg:32

OData 형식 및 성능

대부분의 OData 서비스는 결과를 여러 형식으로 반환할 수 있습니다. $format 쿼리 옵션을 사용하여 결과 집합의 형식을 지정할 수 있습니다. JSON 및 JSON Light와 같은 형식은 ATOM 또는 XML보다 더 효율적이며 많은 양의 데이터를 전송할 때 더 나은 성능을 제공할 수 있습니다. 다음 표에는 샘플 테스트 결과가 나와 있습니다. 알 수 있듯이 ATOM에서 JSON으로 전환할 때 성능이 30~53% 향상되었고 ATOM에서 새 JSON 라이트 형식으로 전환할 때 67%의 성능 향상이 있었습니다(WCF Data Services 5.1에서 사용 가능).

행 ATOM JSON JSON (Light)
10000 113초 74초 68초
1000000 1110초 853초 665초

OData 원본 편집기(연결 페이지)

OData 원본 편집기 대화 상자의 연결 페이지를 사용하여 OData 원본에 대한 OData 연결 관리자를 선택할 수 있습니다. 또한 이 페이지에서는 컬렉션 또는 리소스 경로 및 쿼리 옵션을 지정하여 OData 원본에서 검색해야 하는 데이터를 나타낼 수 있습니다.

정적 옵션

OData 연결 관리자
목록에서 기존 연결 관리자를 선택하거나 새로 만들기를 클릭하여 새 연결을 만듭니다.

연결 관리자를 선택하거나 만든 후 대화 상자는 연결 관리자가 사용하는 OData 프로토콜 버전을 표시합니다.

New
OData 연결 관리자 편집기 대화 상자를 사용하여 새 연결 관리자를 만듭니다.

컬렉션 또는 리소스 경로 사용
원본에서 데이터를 선택하는 방법을 지정합니다.

옵션 설명
컬렉션 컬렉션 이름을 사용하여 OData 원본에서 데이터를 검색합니다.
원본 경로 리소스 경로를 사용하여 OData 원본에서 데이터를 검색합니다.

쿼리 옵션
쿼리에 대한 옵션을 지정합니다. 예: $top=5

피드 URL
이 대화 상자에서 선택한 옵션에 따라 읽기 전용 피드 URL을 표시합니다.

미리 보기
미리 보기 대화 상자를 사용하여 결과를 미리 봅니다. 미리 보기에는 최대 20개의 행이 표시될 수 있습니다.

동적 옵션

컬렉션 또는 리소스 경로 사용 = 컬렉션

컬렉션
드롭다운 목록에서 컬렉션을 선택합니다.

컬렉션 또는 리소스 경로 사용 = 원본 경로

원본 경로
원본 경로를 입렵합니다. 예: 직원

OData 원본 편집기(열 페이지)

OData 원본 편집기 대화 상자의 열 페이지를 사용하여 출력에 포함될 외부(원본) 열을 선택하고 출력 열에 매핑할 수 있습니다.

옵션

사용 가능한 외부 열
데이터 원본에서 사용 가능한 원본 열의 목록을 표시합니다. 목록의 확인란을 사용하여 페이지 맨 아래에 있는 테이블에 열을 추가하거나 제거할 수 있습니다. 선택한 열이 출력에 추가됩니다.

외부 열
출력에 포함되도록 선택한 원본 열을 표시합니다.

출력 열
각 출력 열의 고유 이름을 제공합니다. 기본값은 선택된 외부(원본) 열의 이름이지만 설명이 포함된 고유 이름을 임의로 선택할 수 있습니다.

OData 원본 편집기(오류 출력 페이지)

OData 원본 편집기 대화 상자의 오류 출력 페이지를 사용하여 오류 처리 옵션을 선택하고 오류 출력 열에 속성을 설정할 수 있습니다.

옵션

입/출력
데이터 원본의 이름을 표시합니다.

열
OData 원본 편집기 대화 상자의 연결 관리자 페이지에서 선택한 외부(원본) 열을 표시합니다.

오류
오류가 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.

관련 항목: 데이터에서 오류 처리

잘림
잘림이 발생할 경우 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.

설명
오류에 대한 설명을 표시합니다.

이 값을 선택한 셀로 설정
오류나 잘림 발생 시 선택한 모든 셀에 수행할 동작을 지정합니다. 오류 무시, 행 리디렉션 또는 구성 요소 실패를 지정할 수 있습니다.

적용
선택된 셀에 오류 처리 옵션을 적용합니다.

참고 항목

OData 연결 관리자