OData v4 -tietojen tarjoajan määritys, vaatimukset ja parhaat käytännöt

Tässä ohjeaiheessa kerrotaan, miten OData v4 -tietojen tarjoaja ja OData v4 -tietojen tarjoajan vaatimukset ja parhaat käytännöt määritetään, kun OData v4 -tietojen tarjoajaa käytetään muodostettaessa yhteys OData v4 -verkkopalveluun.

OData v4 -tietojen tarjoajan parhaat käytännöt

• Microsoft Dataverse edellyttää, että kaikilla taulukoilla on ID-määrite. ID on sama kuin yksilöivä tunnus. Arvon on oltava guid. Voit yhdistää ID-sarakkeet vain sellaisiin ulkoisiin sarakkeisiin, joiden tietotyyppi on Edm.Guid. Et voi liittää tietotyyppiä Edm.Int32 yksilöllisen tunnuksen tietotyypin sarakkeeseen Dataversessa.
• OData-taulukot, joilla on tyhjä arvo -ominaisuuksia, on määritettävä vastaamaan virtuaalisen taulukon yhdistettyä saraketta. Esimerkiksi OData-taulukon ominaisuuden, jonka tyhjä arvo = epätosi, Dataverseen yhdistetyn sarakkeen Kenttävaatimus-määritteen arvoksi on annettava Pakollinen.
• Voit hakea useita kyselyjä esimerkiksi ladatessasi tietoja ruudukkoon, jos ohjaat ulkoisesta tietolähteestä palautettavan tietojoukon kokoa käyttämällä kyselyparametrien valintaa ja suodatusta.
• Jos tämä ei ole käytössä, järjestelmänvalvoja voi ottaa laajennuksen seurannan käyttöön. Kun tämä on käytössä, kaikki OData-päätepisteen virheet kerätään laajennuksen seurantalokiin. Lisätietoja: Järjestelmänvalvojan opas: Järjestelmäasetukset-valintaikkuna – Mukauttaminen-välilehti
• OData v4 -tietopalvelua ei voi käyttää yhteyden muodostamiseen toiseen ympäristöön.

Tietotyyppien yhdistämismääritys

Seuraavassa taulukossa ovat OData-taulukon Data Model (EDM) -tietotyyppien yhdistämismääritykset ja Dataverse -tietotyypit.

OData-tietotyyppi	Dataverse:n tietotyyppi
Edm.Boolean	Kaksi asetusta
Edm.DateTime	Päivämäärä ja aika
Edm.DateTimeOffset	Päivämäärä ja aika
Edm.Decimal	Desimaaliluku tai valuutta
Edm.Double	Liukuluku
Edm.Guid	Yksilöllinen tunnus
Edm.Int32	Kokonaisluku
Edm.Int64	Kokonaisluku
Edm.String	Yksi tekstirivi tai useita tekstirivejä

OData EDM -tietotyypit, joita ei tueta virtuaalisten taulukkojen vastaavuusmäärityksissä

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

Tietolähteen lisääminen OData v4 -tietojen tarjoajan avulla

Tässä toimintosarjassa on esitetty, miten voit käyttää virtuaalisen taulukon tietolähteenä valmista OData-tietojen tarjoajaa.

1. Siirry kohtaan Asetukset > Administration > Virtuaalisten entiteettien tietolähteet.

2. Valitse Toiminnot-työkaluriviltä Uusi.

3. Valitse seuraavista tietolähteistä Valitse tietojen tarjoaja -valintaikkunassa ja valitse sitten OK.

   • OData v4 -tietojen tarjoaja. Dataverse sisältää Odata-v4 -tietojen toimittajan, jonka avulla voidaan muodostaa yhteys tietolähteiden tietoihin, jotka tukevat OData v4 avoin standardia.
   • Mukautettujen tietojen tarjoaja. Jos olet tuonut tietopalvelulaajennuksen, tietopalvelu tulee näkyviin tähän. Lisätietoja: Sovelluskehittäjän dokumentaatio: Virtuaalitaulukoiden käytön aloittaminen

4. Täytä seuraavat sarakkeet Uusi tietolähde ominaisuudet -sivulla ja tallenna rivi.

   • Nimi. Kirjoita tietolähteen kuvaava nimi.
   • Uri. Jos käytössäsi on OData-tietojen tarjoaja, kirjoita OData-verkkopalvelun uri-arvo. Esimerkiksi käytettäessä OData-palvelua muodostamaan yhteyden azuren isännöimään WWW-palveluun, URI-osoite voi näyttää tällaiselta https://contosodataservice.azurewebsites.net/odata/.
   • Aikakatkaisu sekunteina. Anna verkkopalvelun vastauksen odotusaika sekunteina. Tämän jälkeen tietopyyntö aikakatkaistaan. Voit esimerkiksi antaa arvoksi 30, jolloin odotusaika on enintään 30 sekuntia ennen aikakatkaisua.
   • Sivutustila. Määritä, käytetäänkö kyselyn tulosten sivutuksessa asiakas- vai palvelinpuolen sivutusta. Oletusarvo on asiakaspuolen sivutus. Palvelinpuolen sivutuksessa palvelin ohjaa tulosten sivutusta $skiptoken-parametrin avulla. Parametri lisätään kyselymerkkijonoon. Lisätietoja: Tunnusjärjestelmän kyselyvaihtoehdon ohittaminen ($skiptoken)
     • Palauta sidottu määrä. Palauttaa tulosjoukon rivien kokonaismäärän. Tätä asetusta käytetään, kun seuraava sivu -toiminto otetaan käyttöön palautettaessa tietoja ruudukkoon. Käytä epätosi-arvoa, jos OData-päätepiste ei tue ODatan $inlinecount-parametria. Oletusarvo on epätosi.
   • Pyyntöparametrit. Vaihtoehtoisesti voit lisätä oman otsikon tai kyselyn kyselymerkkijonon parametrit, joiden avulla voidaan muodostaa yhteys OData verkkopalveluun, kuten todennusparametrit ulkoisen palveluun. Valitse että kyselymerkkijonon avulla tila voidaan vaihdella ylätunniste- ja kyselyn kyselymerkkijonon parametrin ja arvo välillä. Enintään 10 ylätunniste- tai kyselymerkkijonoa voidaan lisätä.

     

Katso myös

Ulkoisen tietolähteen tietoja sisältävien virtuaalitaulukoiden luominen ja muokkaaminen

Huomautus

Voitko kertoa meille dokumentaatiota koskevan kielimäärityksesi? Vastaa lyhyeen kyselyyn. (Huomaa, että tämä kysely on englanninkielinen.)

Kyselyyn vastaaminen kestää noin seitsemän minuuttia. Henkilökohtaisia tietoja ei kerätä (tietosuojatiedot).