OData v4 datu nodrošinātāja konfigurēšana, prasības un paraugprakse

Šajā tēmā ir aprakstīts, kā konfigurēt OData v4 datu nodrošinātāju, kā arī ir aprakstītas OData v4 datu nodrošinātāja prasības un ieteicamā paraugprakse, kas ir jāievēro, lai izveidotu savienojumu ar OData v4 tīmekļa pakalpojumu.

OData v4 datu nodrošinātāja paraugprakse

• Microsoft Dataverse visām tabulām ir nepieciešams ID atribūts — ID tiek dēvēts par unikālo identifikatoru, un tā vērtībai ir jābūt jēgpilnai. ID kolonnas var kartēt tikai ar ārējām kolonnām, kuru datu tips ir Edm.Guid. Datu tipu Edm.Int32 nevar kartēt ar unikāla identifikatora datu tipa kolonnu pakalpojumā Dataverse.
• OData tabulas, kurām ir nullējami rekvizīti, ir jāiestata atbilstoši kartētajai kolonnai virtuālajā tabulā. Piemēram, OData tabulas rekvizītam ar iestatījumu Nullable=False ir nepieciešama kartētā kolonna pakalpojumā Dataverse Lauka vajadzība atribūts ir iestatīts uz Nepieciešams uzņēmumam.
• Izmantojot vairāku rezultātu izguves vaicājumus, piemēram, ielādējot datus režģī, kontrolējiet no ārējā datu avota atgrieztās datu kopas lielumu, izmantojot atlases un vaicājuma filtrēšanas atribūtus.
• Ja vēl nav iespējota spraudņa izsekošana, sistēmas administratoram tā ir jāiespējo. Kad tā ir iespējota, visas OData galapunkta kļūdas tiek reģistrētas spraudņa izsekošanas žurnālā. Papildinformācija: Administratora rokasgrāmata: sistēmas iestatījumu dialoglodziņš — pielāgošanas cilne
• Nevar izmantot OData v4 datu nodrošinātāju, lai izveidotu savienojumu ar citu vidi.

Datu tipu kartēšana

Tālāk esošajā tabulā ir norādīti OData tabulas datu modeļa (EDM) datu tipu kartējumi ar Dataverse datu tipiem.

OData datu tips	Dataverse datu tips
Edm.Boolean	Divas opcijas
Edm.DateTime	Datums un laiks
Edm.DateTimeOffset	Datums un laiks
Edm.Decimal	Decimāldaļskaitlis vai Valūta
Edm.Double	Skaitlis ar peldošo komatu
Edm.Guid	Unikāls identifikators
Edm.Int32	Vesels skaitlis
Edm.Int64	Vesels skaitlis
Edm.String	Viena teksta rindiņa vai Vairākas teksta rindiņas

OData EDM datu tipi, kuru kartēšana ar virtuālajām tabulām netiek atbalstīta

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

Datu avota pievienošana, izmantojot OData v4 datu nodrošinātāju

Šīs procedūras aprakstā ir sniegta informācija par to, kā izmantot standarta OData datu nodrošinātāju kā virtuālo tabulas datu nodrošinātāju.

1. Atveriet sadaļas Iestatījumi > Administrēšana > Virtuālo entītiju datu avoti.

2. Darbību rīkjoslā noklikšķiniet uz vienuma Jauns.

3. Dialoglodziņā Atlasīt datu nodrošinātāju atlasiet no tālāk norādītajiem datu avotiem un pēc tam noklikšķiniet uz Labi.

   • OData v4 datu nodrošinātājs. Dataverse ietver Odata v4 datu nodrošinātāju, ko var izmantot, lai izveidotu savienojumu ar datu avotiem, kas atbalsta OData v4 atvērto standartu.
   • Pielāgots datu nodrošinātājs. Ja esat importējis datu nodrošinātāja spraudni, datu nodrošinātājs parādīsies šeit. Papildinformācija: Izstrādātāja dokumentācija: darba sākšana ar virtuālajām tabulām.

4. Rekvizītu lapā Jauns datu avots aizpildiet tālāk norādītās kolonnas un pēc tam saglabājiet rindu.

   • Nosaukums. Ierakstiet datu avota aprakstošu nosaukumu.
   • URI. Ja izmantojat OData datu nodrošinātāju, ievadiet OData tīmekļa pakalpojuma URI. Piemēram, ja jūs izmantojat OData nodrošinātāju, lai izveidotu savienojumu ar pakalpojumā Azure viesotu tīmekļa pakalpojumu, URI var izskatīties līdzīgi šim: https://contosodataservice.azurewebsites.net/odata/.
   • Taimauts sekundēs. Ievadiet sekunžu skaitu, cik ilgi ir jāgaida atbilde no tīmekļa pakalpojuma, pirms iestājas datu pieprasījuma taimauts. Piemēram, ievadiet 30, lai pirms taimauta iestāšanās būtu jāgaida ne ilgāk kā trīsdesmit sekundes.
   • Lapdales režīms. Izvēlieties, vai izmantot lapošanu klienta pusē vai servera pusē, lai kontrolētu vaicājuma rezultātu lapošanas veidu. Noklusējuma vērtība ir Lapošana klienta pusē. Ja lietojat lapošanu servera pusē, serveris kontrolē rezultātu lapošana veidu, izmantojot parametru $skiptoken, kas tiek pievienots vaicājuma virknei. Papildinformācija: Marķiera izlaišanas sistēmas vaicājuma opcija ($skiptoken)
     • Atgriezt iekļauto ierakstu skaitu. Tiek atgriezts kopējais rezultātu kopā ietverto rindu skaits. Šis iestatījums tiek izmantots, lai iespējot nākamās lapas funkcionalitāti, atgriežot datus režģa formātā. Izmantojiet vērtību False, ja OData galapunkts neatbalsta OData parametru $inclinecount. Noklusējuma vērtība ir False.
   • Pieprasījuma parametri. Pēc izvēles varat pievienot pielāgotus galvenes vai vaicājuma virknes parametrus, kas tiek izmantoti, lai izveidotu savienojumu ar OData tīmekļa pakalpojumu, piemēram, ārējā pakalpojuma autentifikācijas parametrus. Noklikšķiniet uz Vaicājuma virkne, lai pārslēgtos starp galvenes un vaicājuma virknes parametru un vērtību. Var pievienot līdz 10 galvenes vai vaicājuma virknēm.

     

Skatiet arī

Izveidot un rediģēt virtuālās tabulas, kas satur datus no ārēja datu avota

Piezīme

Kādas ir jūsu dokumentācijas valodas preferences? Aizpildiet īsu aptauju. (ņemiet vērā, ka aptauja ir angļu valodā)

Aptaujai būs nepieciešamas aptuveni septiņas minūtes. Nekādi personas dati netiks vākti (paziņojums par konfidencialitāti).