Pregled značajke: Preduvjeti davatelja podataka API-ja SQL-a usluge Azure Cosmos DB
Napomena
Na snazi od studenog 2020.:
- Common Data Service preimenovan je u Microsoft Dataverse. Saznajte više
- Neka je terminologija u usluzi Microsoft Dataverse ažurirana. Na primjer, sada je entitet preimenovan u tablica, a polje u stupac. Saznajte više
Ovaj će se članak uskoro ažurirati kako bi sadržavao najnoviju terminologiju.
U ovoj temi opisuju se preduvjeti za značajku Azure Cosmos DB za davatelja podataka SQL API i načini konfiguracije te preporučena najbolja praksa kada koristite Azure Cosmos DB DB za davatelja podataka SQL API uz virtualne tablice.
Važno
- Značajke pretpregleda nisu namijenjene u proizvodne svrhe i mogu imati ograničene funkcije. Te su značajke dostupne prije službenog izdavanja da bi se klijentima omogućio prijevremeni pristup i slanje povratnih informacija.
- Očekujemo promjene ove značajke, stoga je ne biste trebali koristiti u proizvodne svrhe. Koristite je samo u testnim i razvojnim okruženjima.
- Microsoft ne pruža podršku za ovu značajku pretpregleda. Tehnička podrška za Microsoft Dynamics 365 neće vam moći pomoći u vezi s problemima ili pitanjima. Značajke pretpregleda nisu namijenjene u proizvodne svrhe i na njih se primjenjuju zasebni dodatni uvjeti korištenja za značajke pretpregleda.
Što je Azure Cosmos DB?
Azure Cosmos DB je Microsoftov globalno distribuirani višemodelni servis baze podataka za ključne aplikacije. Pruža bogate i poznate mogućnosti SQL upita s dosljednim niskim latencijama zbog JSON podataka bez shema. Dodatne informacije: Uvod u uslugu Azure Cosmos DB: SQL API
Uvjeti
- Azure pretplata koja sadrži Azure Cosmos DB.
- Zbirka Azure Cosmos DB SQL API.
- Vrsta baze podataka usluge Azure Cosmos DB treba biti SQL.
Mapiranje vrste karte
Pretpostavimo da imate Azure Cosmos DB dokument u zbirci pod nazivom Narudžbe koji ima sljedeću strukturu JSON.

Ova tablica pokazuje mapiranja vrsta podataka za SQL API dokumenta u zbirci Narudžbe pomoću usluge Microsoft Dataverse.
| SQL API podaci | Dataverse |
|---|---|
id |
Primarni ključ |
name |
Jedan redak teksta |
quantity |
Cijeli broj |
orderid |
Jedan redak teksta |
ordertype |
Odabir |
amount |
Decimalni broj ili valuta |
delivered |
Da/Ne |
datetimeoffset |
Datum i vrijeme |
Napomena
- Atributi s prefiksom podcrta (_) generirao je SQL API .
- Atributi koji su konfigurirani kao neobavezni u SQL API dokumentu i koji su mapirani u usluzi Dataverse kao Obavezno za posao će uzrokovati pogreške prilikom izvođenja.
- vrijednosti id atributa moraju biti guid.
- Dodatne informacije o upotrebi datuma u rješenju SQL API potražite u članku Rad s datumima na usluzi Azure Cosmos DB.
Podržano SQL filtriranje upita
Filtriranje SQL upita podržava sljedeće operatore.
- Operatori usporedbe:
<,>,<=,>=,!= - Logički operatori:
and,or - Postavljeni operatori:
in,not in - Operatori niza:
like,contains,begins with,ends with
Napomena
Upotreba operatora like prevedena je u ekvivalentne operatore contains/begins with/ends with. SQL API ne podržava argumente uzoraka kako je opisano u temi Like (Transact SQL). Azure Cosmos DB za davatelja podataka SQL API može prevesti jedan poseban slučaj Like('[aA]%') u BeginsWith('a') ILI BeginsWith('A'). Uzmite u obzir da usporedba niza u SQL API-ju razlikuje velika i mala slova.
Dodavanje izvora podataka s pomoću usluge Azure Cosmos DB za davatelja podataka API-ja SQL-a
Otvorite AppSource, odaberite DOHVATI SAD i slijedite upute za dodavanje aplikacije u vaše okruženje pomoću verzije v9x ili novije verzije.
Nakon što je rješenje instalirano, prijavite se u okruženje i otvorite Postavke > Administracija > Virtualni izvori podataka entiteta.
Na alatnoj traci Akcije odaberite NOVO i u dijaloškom okviru Odabir davatelja podataka odaberite Azure Cosmos DB za davatelja podataka SQL-a API-ja te odaberite U redu.

Unesite sljedeće informacije, a zatim odaberite SPREMI & ZATVORI.
Column Opis Ime Upišite naziv koji opisuje izvor podataka. Naziv zbirke Naziv baze podataka usluge Azure Cosmos DB sadrži zbirku koju želite otkriti u virtualnoj tablici. Autorizacijski ključ Primarni ili sekundarni ključ za Azure Cosmos DB račun. Ključ možete pronaći u portalu Azure admin pod postavkom Tipke pod vašim Azure Cosmos DB računom. URI URI grupe resursa gdje se zbirka Azure Cosmos DB nalazi. URI je oblikovan slično sljedećem: https://contoso/documents.azure.com:443. URI možete pronaći u portalu Azure admin pod postavkom Ključevi za vaš Azure Cosmos DB račun.Vremensko ograničenje u sekundama Unesite broj sekundi čekanja na odgovor Azure Cosmos DB servisa prije isteka zahtjeva za podatke. Na primjer, unesite 30 za čekanje najviše trideset sekundi prije isteka. Zadano vremensko ograničenje je 120 sekundi. 
Najbolje prakse i ograničenja
- Uzmite u obzir sljedeće kada koristite Azure Cosmos DB kao izvor podataka:
- Svaki izvor podataka usluge Azure Cosmos DB može se pridružiti samo s jednom virtualnom tablicom.
- Možete povezati više izvora podataka iste zbirke u Azure Cosmos DB.
- Podatke u zbirci ne možete segmentirati prema tablici.
- Azure Cosmos DB baze podataka ne zahtijevaju sheme, međutim podaci unutar Azure Cosmos DB moraju biti strukturiran pomoću predvidljive sheme.
- Iako Azure Cosmos DB za davatelja podataka SQL API primjenjuje prijevod upita projekcija, filtriranje i sortiranje operatora, ne podržava zajedničke operacije.
- Možete filtrirati samo po jedan stupac uz SQL API.
Pogledajte također
Stvaranje i uređivanje virtualnih tablica koje sadrže podatke iz vanjskog izvora podataka