OData v4 데이터 공급자 구성, 요구 사항 및 모범 사례
이 항목에서는 OData v4 데이터 공급자를 설정하는 방법과 OData v4 웹 서비스에 연결하기 위해 OData v4 데이터 공급자를 사용하는 요구 사항 및 권장되는 최선의 방법에 대해 설명합니다.
OData v4 데이터 공급자 모범 사례
- Microsoft Dataverse에서 모든 테이블은 ID 특성을 지녀야 하며 이 ID는 고유 식별자로 알려져 있으며 값은 guid여야 합니다.
Edm.Guid데이터 형식의 외부 열에만 ID 열을 매핑할 수 있습니다. Dataverse에서 고유 식별자 데이터 형식 열에Edm.Int32데이터 형식을 매핑할 수 없습니다. - null이 허용되는 속성의 OData 테이블은 가상 테이블의 매핑된 열과 일치하도록 설정해야 합니다. 예를 들어 Nullable=False인 OData 테이블 속성은 Dataverse 필드 요구 사항 특성에서 업무상 필수로 설정된 매핑된 열이 있어야 합니다.
- 표에 데이터를 로드할 때와 같이 여러 쿼리를 검색하려면 선택 및 필터 쿼리 매개 변수를 사용하여 외부 데이터 원본에서 반환되는 데이터 집합의 크기를 제어합니다.
- 아직 활성화하지 않았으면 시스템 관리자가 플러그 인 추적을 사용하도록 설정해야 합니다. 활성화되면 OData 끝점의 모든 오류가 플러그 인 추적 로그에 캡처됩니다. 추가 정보: 관리자 가이드: 시스템 설정 대화 상자 - 사용자 지정 탭
- OData v4 데이터 공급자를 사용하여 다른 환경에 연결할 수 없습니다.
데이터 형식 매핑
다음 표에는 Dataverse 데이터 형식이 포함된 OData 테이블 데이터 모델(EDM) 데이터 형식 매핑을 나열합니다.
| OData 데이터 형식 | Dataverse 데이터 형식 |
|---|---|
Edm.Boolean |
두 개의 옵션 |
Edm.DateTime |
날짜 및 시간 |
Edm.DateTimeOffset |
날짜 및 시간 |
Edm.Decimal |
10진수 또는 통화 |
Edm.Double |
부동 소수점 수 |
Edm.Guid |
고유 식별자 |
Edm.Int32 |
정수 |
Edm.Int64 |
정수 |
Edm.String |
한 줄 텍스트 또는 여러 줄 텍스트 |
가상 테이블과의 매핑에 지원되지 않는 OData EDM 데이터 형식
Edm.BinaryEdm.TimeEdm.FloatEdm.SingleEdm.Int16Edm.ByteEdm.SByte
OData v4 데이터 공급자를 사용하여 데이터 원본 추가
이 절차에서는 가상 테이블 데이터 원본으로 사용하기 위해 기본 제공 OData 데이터 공급자를 사용하는 방법을 보여 줍니다.
설정 > 관리 > 가상 엔터티 데이터 원본으로 이동합니다.
작업에서 새로 만들기를 클릭합니다.
데이터 공급자 선택 대화 상자에서 다음 데이터 원본에서 선택하고 확인을 클릭합니다.
- OData v4 데이터 공급자. Dataverse은 OData v4 개방형 표준을 지원하는 데이터 원본에 연결하는 데 사용할 수 있는 OData v4 데이터 공급자를 포함합니다.
- 사용자 지정 데이터 공급자. 데이터 공급자 플러그 인을 가져온 경우 데이터 공급자가 여기에 표시됩니다. 추가 정보: 개발자 설명서: 가상 테이블 시작
새 데이터 원본 속성 페이지에서 다음 열을 입력한 다음 행을 저장합니다.
- 이름: 데이터 원본을 설명하는 이름을 입력합니다.
- URI. OData 데이터 공급자를 사용하는 경우 OData 웹 서비스에 대한 URI를 입력합니다. 예를 들어 OData 공급자를 사용하여 Azure에서 호스팅되는 웹 서비스에 연결하는 경우 URI는
https://contosodataservice.azurewebsites.net/odata/와 비슷하게 보일 수 있습니다. - 시간 제한(초). 데이터 요청 제한 시간 이전에 웹 서비스의 응답을 기다리는 시간(초)을 입력 합니다. 예를 들어, 30을 입력하면 제한 시간이 발생하기 전에 최대 30초를 기다립니다.
- 페이지 매김 모드. 쿼리 결과가 페이징되는 방식을 제어하기 위해 클라이언트 측 또는 서버 측 페이징을 사용할지 여부를 선택합니다. 기본값은 클라이언트 측 페이징입니다. 서버 쪽 페이징과 함께 서버는 쿼리 문자열에 추가되는 $skiptoken 매개 변수를 사용하여 결과를 페이징하는 방법을 제어합니다. 추가 정보: 토큰 시스템 쿼리 건너뛰기 옵션($skiptoken)
- 인라인 개수 반환. 결과 집합의 총 행 수를 반환합니다. 이 설정은 표에 데이터를 반환할 때 다음 페이지 기능을 사용하도록 설정하는 데 사용됩니다. OData 끝점이 OData $inlinecount 매개 변수를 지원하지 않으면 false 값을 사용합니다. 기본값은 false입니다.
- 요청 매개 변수. 필요에 따라 외부 서비스에 인증 매개 변수와 같이 OData 웹 서비스에 연결하는 데 사용되는 사용자 지정 머리글 또는 쿼리 문자열 매개 변수를 추가할 수 있습니다. 쿼리 문자열을 클릭하여 머리글 및 쿼리 문자열 매개 변수 및 값을 전환합니다. 최대 10개의 머리글 또는 쿼리 문자열을 추가할 수 있습니다.
참조
외부 데이터 원본에서 데이터를 포함하는 가상 테이블 만들기 및 편집
참고
귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)
이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).