OData v4 деректер жеткізушісінің конфигурациясы, талаптар және үздік тәжірибелер

Бұл тақырыпта OData v4 деректер жеткізушісін конфигурациялау әдісі, сонымен бірге OData v4 деректер жеткізушісін OData v4 қызметіне қосылу үшін пайдаланудың талаптары және ұсынылған үздік тәжірибелері сипатталған.

OData v4 деректер жеткізушісінің үздік тәжірибелері

• Microsoft Dataverse жүйесі барлық кестелерде идентификатор төлсипатының болуын қажет етеді, бұл идентификатор бір мәнді идентификатор ретінде белгілі және мән guid болуы керек. Идентификатор бағандарын тек Edm.Guid деректер түрі бар сыртқы бағандармен салыстыруға болады. Dataverse жүйесінде Edm.Int32 деректер түрін бір мәнді идентификатор деректер түрі бағанымен салыстыру мүмкін емес.
• Нөлденетін сипаттары бар OData кестелерін виртуалды кестедегі салыстырылған бағанға сәйкес болатындай орнату керек. Мысалы, Nullable=False мәні бар OData кесте сипатында Dataverse Өріс талабы төлсипатында Іскери қажет мәніне орнатылған салыстырылатын баған болуы керек.
• Бірнеше сұрауды шығарып алу үшін (мысалы деректерді торға жүктегенде) select және filter параметрлерін пайдалана отырып сыртқы деректер көзінен қайтарылатын деректер жиынының өлшемін басқарыңыз.
• Қосылып қойылмаған болса, жүйе әкімшілері қосылатын модульді трассирлеуді қосулары керек. Қосқаннан кейін қосылатын модульді трассирлеу журналында OData соңғы нүктесінен алынған барлық қателер жазылады. Қосымша ақпарат: Әкімші нұсқаулығы: Жүйелік параметрлер диалогтік терезесі - Теңшеу қойыншасы
• OData v4 деректер провайдерін басқа ортаға қосылу үшін пайдалану мүмкін емес.

Деректер түрін салыстыру

Келесі кестеде Dataverse деректер түрлерімен OData кестесінің деректер үлгісі (EDM) деректер түрін салыстырулар тізілген.

OData деректер түрі	Dataverse деректер түрі
Edm.Boolean	Екі параметр
Edm.DateTime	Күн және уақыт
Edm.DateTimeOffset	Күн және уақыт
Edm.Decimal	Ондық сан немесе валюта
Edm.Double	Қалқымалы үтірі бар сан
Edm.Guid	Бір мәнді идентификатор
Edm.Int32	Бүтін сан
Edm.Int64	Бүтін сан
Edm.String	Мәтіннің бір жолы немесе мәтіннің бірнеше жолы

Виртуалды кестелермен салыстыруға қолдау көрсетілмейтін OData EDM деректер түрлері

• Edm.Binary
• Edm.Time
• Edm.Float
• Edm.Single
• Edm.Int16
• Edm.Byte
• Edm.SByte

OData v4 деректер жеткізушісін пайдаланып деректер көзін қосу

Бұл процедура кірістірілген OData деректер жеткізушісін виртуалды кестенің деректер көзі ретінде пайдалану жолын көрсетеді.

1. Параметрлер > Басқару > Виртуалды нысанның деректер көздері тармағына өтіңіз.

2. Әрекеттер құралдар тақтасында Жаңа пәрменін басыңыз.

3. Деректер жеткізушісін таңдау диалогтік терезесінде келесі деректер көздерінен таңдаңыз, содан кейін OK түймешігін басыңыз.

   • OData v4 деректер жеткізушісі. Dataverse жүйесі OData v4 ашық стандартын қолдайтын деректер көзіне қосылу үішн пайдалануға болатын Odata v4 деректер жеткізушісін қамтиды.
   • Теңшелетін деректер жеткізушісі. Сіз деректер жеткізушісі қосылатын модулін импорттасаңыз, осы жерде деректер жеткізушісі көрінеді. Қосымша ақпарат: Әзірлеуші құжаттамасы: виртуалды кестелермен жұмысқа кірісу

4. Жаңа деректер көзі сипаттар бетінде келесі бағандарды толтырыңыз, содан кейін жолды сақтаңыз.

   • Аты. Деректер көзін сипаттайтын атауды теріңіз.
   • URI. OData деректер жеткізушісін пайдаланып жатсаңыз, OData веб-қызметінің URI мекенжайын енгізіңіз. Мысалы, Azure ішінде орналастырылған веб-қызметке қосылу үшін OData жеткізушісін пайдаланып жатсаңыз, URI мекенжайы https://contosodataservice.azurewebsites.net/odata/ сияқты көрінуі мүмкін.
   • Секундтар түріндегі күту уақыты. Деректерді сұрауды күту уақыты бітуі алдында веб-қызметтер жауапты күтудің секундтар санын енгізіңіз. Мысалы, күту уақыты бітуі орын алуы алдында ең көбі отыз секунд күту үшін 30 санын енгізіңіз.
   • Беттеу режимі. Сұрау нәтижелері қалай реттелетінін басқару үшін клиент тарапында немесе сервер тарапында беттеуді пайдалануды таңдаңыз. Әдепкі мән — клиент тарапында беттеу. Сервер тарапыда беттеуде сервер нәтижелер қалай беттелетінін сұрау жолына қосылатын $skiptoken параметрін пайдалана отырып басқарады. Қосымша ақпарат: Таңбалауышты өткізіп жіберу жүйелік сұрауының параметрі ($skiptoken)
     • Кірістірілген санды қайтару. Сұрау нәтижесінде жолдардың жалпы санын қайтарады. Бұл параметр торға деректерді қайтарғанда келесі бет функциясын қосу үшін пайдаланылады. OData соңғы нүктесі OData $inlinecount параметрін қолдамаса, "жалған" мәнін пайдаланыңыз. Әдепкі мән — жалған.
   • Сұрау параметрлері. Таңдау бойынша, сыртқы қызметтегі түпнұсқалық растамасының параметрлері сияқты OData веб-қызметіне қосылу үшін пайдаланылатын теңшелетін тақырып немесе сұрау жолының параметрлерін қосуға болады. Тақырып пен сұрау жолы параметрі мен мәні арасында ажырата қосу үшін Сұрау жолы пәрменін басыңыз. 10-ға дейін тақырып немесе сұрау жолын қосуға болады.

     

Сондай-ақ, келесіні қараңыз

Сыртқы деректер көзінен алынған деректерді қамтитын виртуалды кестелерді жасау және өңдеу

Ескерім

Сіз құжат тіліңіздің артықшылықтары туралы айта аласыз ба? Қысқа сауалнамаға қатысыңыз. (бұл сауалнама ағылшын тілінде екеніне назар аударыңыз)

Сауалнама шамамен жеті минут уақытыңызды алады. Жеке деректер жиналмайды (құпиялылық туралы мәлімдеме).