Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Microsoft Fabricin GraphQL-ohjelmointirajapinnan nykyiset yleiset tuoterajoitukset on lueteltu tässä artikkelissa. Parannamme jatkuvasti API:a GraphQL:lle uusilla ominaisuuksilla. Lisätietoja Microsoft Fabricin tulevaisuudesta on artikkelissa Fabric Roadmap.
Kenen täytyy ymmärtää rajoitukset
GraphQL API:n rajoitusten ymmärtäminen on ratkaisevan tärkeää:
- Sovelluskehittäjät suunnittelevat sovelluksia, jotka toimivat Fabric GraphQL API -rajoitteiden puitteissa
- Data-insinöörit suunnittelevat datan altistusstrategioita ja ymmärtävät alustan rajat
- Ratkaisuarkkitehdit määrittelevät Fabric-pohjaisia ratkaisuja ja asettavat asianmukaiset tekniset odotukset
- Fabric-työtilan tekijät selvittävät ongelmia ja toteuttavat kiertoteitä nykyisille rajoituksille
- Projektipäälliköt viestivät Fabric-alustan rajoituksista sidosryhmille projektin suunnittelun aikana
Tarkastele näitä rajoituksia suunnitellessasi GraphQL API -toteutuksia tai vianmäärittäessäsi odottamattoman API-käyttäytymisen vianetsintää.
Tietolähdeoperaatiot
SQL Analytics Endpoint -tietolähteet tukevat vain lukutoimintoja. SQL Analytics -päätelaitteiden kautta käytettävät tietolähteet (kuten Lakehouset ja peilitietokannat) eivät tue mutaatioita. Voit hakea tietoja, mutta et voi luoda, päivittää tai poistaa tietueita GraphQL API:n kautta.
Koko ja suorituskyvyn rajat
Seuraava taulukko tiivistää avaimen koon, sivuttamisen ja suorituskykyrajoitteet:
| Raja-arvotyyppi | Arvo | Kuvaus | Ratkaisu |
|---|---|---|---|
| Oletussivukoko | 100 esinettä | Maksimimäärä palautettuja kohteita pyynnön mukaan oletuksena | Käytä GraphQL-sivuttamista suurempien tulosjoukkojen läpikäymiseen |
| Suurin sivukoko | 100 000 tuotetta | Suurin määrä kohteita, jotka voidaan hakea sivuttamalla | Lähetä useita suodatettuja pyyntöjä, jos tarvitset yli 100 000 tuotetta (harvinainen kuvio GraphQL:ssä) |
| Maksimivastekoko | 64 Mt | API-vastekuorman maksimikoko | Lähetä useita suodatettuja pyyntöjä datan hakemiseen pienemmissä paloissa |
| Pyynnön aikakatkaisu | 100 sekuntia | Maksimisuoritusaika yhdelle pyynnölle | Optimoi kyselyt tai jaa monimutkaisia operaatioita pienempiin pyyntöihin |
| Maksimikyselysyvyys | 10 tasoa | Kenttien maksimisisäkkäisyystaso kyselyssä | Vähennä kyselyjen sisäkkäisyyttä välttääksesi suorituskykyongelmia liiallisesta datan hakemisesta |
Tallennetun menettelyn rajoitukset
Azure SQL:ssä, SQL Databasessa Fabricissa ja Data Warehouseissa tallennetuilla menettelyillä on erityisiä rajoituksia:
- Tulosjoukon käsittely: Käytetään vain ensimmäistä tallennetun proseduurin palauttamaa tulosjoukkoa. Useat tulosjoukot eivät ole tuettuja.
-
Metatietovaatimukset: Vain tallennetut proseduurit, joiden ensimmäinen tulosaineiston metadata voidaan kuvata
sys.dm_exec_describe_first_result_set, ovat tuettuja. - Parametrien etuoikeus: Kun tallennettu proseduuriparametri määritellään sekä konfiguraatiotiedostossa että URL-kyselymerkkijonossa, URL-kyselyjonon arvo menee etusijalle.
-
Rajoitetut GraphQL-ominaisuudet: Tallennettujen proseduurien tukemat entiteetit ovat vähemmän ominaisuuksia verrattuna taulukko- tai näkymäpohjaisiin entiteetteihin:
- Ei sivutustukea
- Ei tilausta tai suodatusta
- Ei ensisijaisia avaimiin perustuvia hakuja
Tunnetut ongelmat
Voit tutustua GraphQL-ohjelmointirajapinnan tunnettuihin ongelmiin Microsoft Fabricin tunnetut ongelmat.