Povratne informacije

Predogled funkcije: Zahteve ponudnika podatkov Azure Cosmos DB za SQL API

  • Članek
  • 3 min za branje

Ta tema opisuje zahteve ponudnika podatkov Azure Cosmos DB za SQL API, postopek konfiguracije ter priporočene najboljše prakse pri uporabi ponudnika podatkov Azure Cosmos DB za SQL API z navideznimi tabelami.

Pomembno

  • Poskusne funkcije niso za komercialno uporabo, njihovo delovanje je lahko omejeno. Te funkcije so na voljo še pred uradno izdajo, da lahko stranke predčasno dostopajo do njih in posredujejo povratne informacije.
  • Ta funkcija se bo še spremenila, zato ni namenjena komercialni uporabi. Uporabljajte jo samo v preskusnem okolju in okolju za razvoj.
  • Microsoft ne zagotavlja podpore za to funkcijo predogleda. Tehnična podpora za Microsoft Dynamics 365 vam v primeru težav ali vprašanj ne bo mogla pomagati. Funkcije predogleda niso za produkcijsko uporabo, zanje pa veljajo ločeni dodatni pogoji uporabe.

Kaj je Azure Cosmos DB?

Azure Cosmos DB je Microsoftova globalno distribuirana večmodelna storitev zbirke podatkov za ključne aplikacije. Zagotavlja bogate in poznane poizvedbe zmogljivosti SQL z enotnimi manjšimi zakasnitvami podatkov brez sheme v obliki JSON. Več informacij: Uvod v Azure Cosmos DB: SQL API

Zahteve

  • Naročnina na Azure, ki vključuje Azure Cosmos DB.
  • Zbirka Azure Cosmos DB SQL API.
  • Vrsta zbirke podatkov Azure Cosmos DB mora biti SQL.

Preslikave podatkovnih tipov

Denimo, da imate dokument Azure Cosmos DB v zbirki z imenom Naročila s spodnjo strukturo JSON.

Primer JSON za dokument SQL API.

Ta tabela prikazuje preslikave podatkovnega tipa za dokument SQL API v zbirki Naročila s storitvijo Microsoft Dataverse.

Podatki SQL API Dataverse
id Primarni ključ
name Ena vrstica besedila
quantity Celo število
orderid Ena vrstica besedila
ordertype Izbira
amount Decimalno število ali valuta
delivered Da/ne
datetimeoffset Datum in ura

Opomba

  • Atribute s podčrtajem (_) kot predpono ustvari SQL API.
  • Atributi, ki so konfigurirani kot izbirni v dokumentu SQL API in so preslikani v storitev Dataverse kot Zahtevano za poslovanje, bodo povzročili napako pri izvajanju.
  • Vrednost atributa ID mora biti GUID.
  • Za več informacij o uporabi datumov v SQL API glejte Delo z datumi v Azure Cosmos DB.

Podprto filtriranje poizvedbe SQL

Filtriranje poizvedbe SQL podpira naslednje operatorje.

  • Operatorji primerjanja:<,>,<=, >=,!=
  • Logična operatorja: and, or
  • Nastavitvena operatorja: in, not in
  • Operatorji niza: like, contains, begins with, ends with

Opomba

Uporaba primerjalnega operatorja je prevedena v enakovredne operatorje contains/begins with/ends with. SQL API ne podpira vzorcev argumentov, kot je opisano v temi Kot (Transact-SQL). Ponudnik podatkov Azure Cosmos DB za SQL API lahko prevede poseben primer Like('[aA]%') v BeginsWith('a') ALI BeginsWith('A'). Upoštevajte, da primerjava nizov v SQL API razlikuje med velikimi in malimi črkami.

Dodajanje vira podatkov s ponudnikom podatkov Azure Cosmos DB za SQL API

  1. Odprite AppSource, izberite PRENESI in sledite navodilom za dodajanje aplikacije v okolje z različico v9x ali novejšo.

  2. Ko je rešitev nameščena, se vpišite v okolje in pojdite v Nastavitve > Skrbništvo > Viri podatkov navidezne entitete.

  3. V orodni vrstici za dejanja izberite NOVO, v pogovornem oknu Izbira ponudnika podatkov izberite Ponudnik podatkov Azure Cosmos DB za SQL API in nato kliknite V redu. Izbira ponudnika podatkov Azure Cosmos DB za SQL API.

  4. Vnesite naslednje podatke in nato izberite SHRANI IN ZAPRI.

    Stolpec Opis
    Ime Vnesite ime, ki opisuje vir podatkov.
    Ime zbirke Ime zbirke podatkov Azure Cosmos DB vsebuje zbirko, ki jo želite prikazati v navidezni tabeli.
    Avtorizacijski ključ Primarni ali sekundarni ključ za račun Azure Cosmos DB. Ključ skrbniškega portala Azure najdete pod nastavitvijo Ključi pod vašim računom Azure Cosmos DB.
    URI URI skupine virov, kjer se nahaja zbirka Azure Cosmos DB. URI je oblikovan podobno kot https://contoso/documents.azure.com:443. URI skrbniškega portala Azure najdete pod nastavitvijo Ključi za račun Azure Cosmos DB.
    Časovna omejitev v sekundah Vnesite število sekund čakanja na odgovor storitve Azure Cosmos DB pred potekom časovne omejitve. Vnesite na primer 30, če želite počakati največ trideset sekund, preden časovna omejitev poteče. Privzeta časovna omejitev je 120 sekund.

    Ustvarite vir podatkov z uporabo ponudnika podatkov SQL API.

Najboljše prakse in omejitve

  • Ko kot vir podatkov uporabljate Azure Cosmos DB, upoštevajte naslednje:
    • Vsak vir podatkov Azure Cosmos DB je mogoče povezati le z eno navidezno tabelo.
    • Z isto zbirko v Azure Cosmos DB lahko povežete več virov podatkov.
  • Podatkov v zbirki ne morete segmentirati z tabelami.
  • Zbirke podatkov Azure Cosmos DB ne potrebujejo sheme, vendar pa morajo biti podatki v Azure Cosmos DB strukturirani s predvidljivo shemo.
  • Čeprav ponudnik podatkov Azure Cosmos DB za SQL API uveljavlja prevod poizvedbe o projekciji, filtriranju in razvrščanju operatorjev, ne podpira operacij združevanja.
  • S SQL API lahko filtrirate samo po en stolpec.

Glejte tudi

Ustvarjanje in urejanje navideznih tabel, ki vsebujejo podatke iz zunanjega vira podatkov

Opomba

Ali nam lahko poveste, kateri je vaš prednostni jezik za dokumentacijo? Izpolnite kratko anketo. (upoštevajte, da je v angleščini)

Z anketo boste porabili približno sedem minut. Ne zbiramo nobenih osebnih podatkov (izjava o zasebnosti).