Microsoft Fabric -ohjelmointirajapinnan rajoitukset GraphQL:lle
Tässä artikkelissa kerrotaan GraphQL:n Microsoft Fabric -ohjelmointirajapinnan tämänhetkiset rajoitukset.
Rajoitukset
Microsoft Fabricin GraphQL-ohjelmointirajapinnan nykyiset yleiset tuoterajoitukset on lueteltu tässä artikkelissa. Parannamme GraphQL:n ohjelmointirajapintaa jatkuvasti uusilla ominaisuuksilla. Lisätietoja Microsoft Fabricin tulevaisuudesta on artikkelissa Fabric Roadmap.
- Kaikki tietolähteet, jotka hyödyntävät SQL Analytics -päätepistettä käyttöä varten, tukevat vain sitä koskevia lukutoimintoja. Esimerkiksi mutaatiot eivät ole käytettävissä Lakehouse-tietokannassa tai peilatuissa tietokannoissa.
- Nykyinen oletussivun koko on 100, mikä tarkoittaa sitä, että jokainen pyyntö palauttaa vastauksessa enintään 100 elementtiä. Jos tulosjoukkosi on suurempi kuin 100, iteroi tulokset käyttämällä GraphQL -sivutusta.
- Sivutuksen enimmäiskoko on 100 000. Tämä tarkoittaa sitä, että on olemassa kiinteä enimmäismäärä elementtejä, jotka pyyntö palauttaa ja jotka voit iteroida läpi. Jos haluat palauttaa yli 100 000 elementtiä sovelluksellesi, julkaise useita pyyntöjä. Huomaa, että tämä malli ei ole yleinen GraphQL:ssä.
- Vastauksen enimmäiskoko on 64 Mt. Tämä tarkoittaa sitä, että mikä tahansa ohjelmointirajapinnan pyyntö, jonka vastauskoko on yli 64 Mt, palauttaa virheen. Voit kiertää tämän rajoituksen joko esittämällä useita suodattuja pyyntöjä.
- Tallennetut toimintosarjat (koskee Azure SQL:ää, Fabricin SQL-tietokantaa ja tietovarastoja):
- Ohjelmointirajapinta käyttää GraphQL:lle vain ensimmäistä tallennettua toimintosarjaa.
- Vain tallennettuja toimintosarjoja, joiden metatietoja sys.dm_exec_describe_first_result_set kuvaamalle ensimmäiselle tulokselle tuetaan.
- Kun tallennettu toimintosarjaparametri määritetään sekä määritystiedostossa että URL-kyselymerkkijonossa, URL-kyselymerkkijonon parametri on etusijalla.
- Tallennetun toimintosarjan tukemat entiteetit eivät sisällä automaattisesti kaikkia ominaisuuksia, joita taulukoiden tai näkymien tukemat entiteetit saavat.
- Tallennettujen toimintosarjojen tukemat entiteetit eivät tue sivutusta, järjestystä tai suodatusta. Tällaiset entiteetit eivät myöskään tue perusavainarvojen määrittämien kohteiden palauttamista.
- Pyynnön aikakatkaisu on tällä hetkellä 100 sekuntia. Tämä tarkoittaa sitä, että jos teet pyynnön, joka luo tietolähdekyselyn, jonka suorittaminen kestää yli 100 sekuntia, pyyntösi saattaa epäonnistua ja ilmetä virhe.
Tunnetut ongelmat
Voit tutustua GraphQL-ohjelmointirajapinnan tunnettuihin ongelmiin Microsoft Fabricin tunnetut ongelmat.