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 Fabric -graafilla on tiettyjä toiminnallisia rajoituksia. Tässä artikkelissa kerrotaan joistakin tärkeimmistä rajoituksista, mutta se ei ole tyhjentävä luettelo. Palaa säännöllisesti tarkistamaan päivitykset.
Jos haluat lisätietoja yleisistä ongelmista, katso Kaavion vianmääritys.
Kaaviomallien luominen
Tietolähteet
OneLake ja peilatut tietokannat ovat tuetut tietolähteet graafille.
Tietotyypit
Graafimallit tukevat seuraavia ominaisuusarvotyyppejä.
| GQL-arvotyyppi | Description |
|---|---|
BOOLEAN |
Arvot ovat true ja false. |
INT (tai INT64) |
Arvot ovat 64-bittisiä allekirjoitettuja kokonaislukuja. |
DOUBLE (tai FLOAT64) |
Arvot ovat 64-bittisiä IEEE-754 liukulukulukuja. |
FLOAT (tai FLOAT32) |
Arvot ovat 32-bittisiä liukulukulukuja. |
STRING |
Arvot ovat UTF-8-koodattuja Unicode-merkkijonoja. Suurin omaisuuden koko on 65 535 tavua. |
ZONED DATETIME |
Arvot ovat aikaleimoja yhdessä aikavyöhykesiirtymän kanssa, millisekunnin tarkkuudella. |
Seuraavat OneLake- ja Delta Lake -sarakityypit ovat tuettuja syötettäväksi graafeihin.
| OneLake-tyyppi | Kuvaukset GQL-ominaisuuden arvotyyppiin |
|---|---|
BooleanType |
BOOLEAN |
ByteType |
INT (tai INT64) |
IntegerType |
INT (tai INT64) |
LongType |
INT (tai INT64) |
FloatType |
DOUBLE (tai FLOAT64) |
DoubleType |
DOUBLE (tai FLOAT64) |
StringType |
STRING |
DateType |
ZONED DATETIME |
TimestampType |
ZONED DATETIME |
TimestampNtzType |
ZONED DATETIME |
Note
Monimutkaisia tai sisäkkäisiä Delta Lake -tyyppejä (MapType ja StructType) ei tueta. Voit jäsentää JSON-koodattuja merkkijonosarakkeita kyselyhetkellä käyttämällä PARSE_JSON_STRING.
Graafin käsittely ja mittakaava
Graafien lataus- ja päivitystoiminnot voivat vaatia pidennettyä käsittelyaikaa riippuen graafin koosta, graafielementtien (solmujen ja reunojen) määrästä sekä näihin elementteihin liittyvien ominaisuuskuormien koosta. Suurten käyrien käsittely voi kestää useita tunteja. Jos graafin lataus- tai päivitystoimintoa ei ole suoritettu 24 tunnin kuluessa, lähetä tukipyyntö jatkotutkimuksia varten.
Nykyiset graafien käsittelykyvyt tukevat jopa noin 2 miljardia graafielementtiä (solmuja ja särmiä) sisältäviä graafeja. Tehokas kapasiteetti voi vaihdella graafin rakenteen ja kiinteistön hyötykuorman koon mukaan. Jos työkuormasi odotetaan ylittävän nämä rajat, ota yhteyttä Microsoft-tuki -palveluun saadaksesi ohjeita.
Jakosarakkeet
Delta Lake -osiosarakkeilla on rajallinen tuki graafiominaisuuksina:
- Ainoana ensisijaisena avaimena käytetyt osiosarakkeet hylätään aina.
- Generoidut osiosarakkeet eivät ole tuettuja.
- Monimutkaiset ja desimaaliset osiosarakkeetyypit (
Decimal,Binary,MapArray, , jaStruct) pudotetaan varoituksella.
Skeemamuutokset
Skeeman muutokset laukaisevat graafin uudelleenlatauksen.
Kyseltäessä
Muuttuvan pituiset polut
Explore UI -polkurakentaja tukee jopa kahdeksaa hyppyä muuttuvan pituisille kuvioille. Tämä käyttöliittymärajoitus ei koske GQL-kyselyitä, jotka on syötetty koodieditoriin.
Graafi tukee ALL ja ANY SHORTEST polkuhakuetuliitteitä.
ALL SHORTEST eikä ANY niitä tueta.
Seuraava taulukko tiivistää muuttuvan pituisen GQL-tuen:
| Polun haku ja polkutila | Kiinteä tai rajoitettu kvanttori | Rajoittamaton kvanttori |
|---|---|---|
ALL WALK (oletus) |
Tuettu | Ei tuettu, koska toistuvat elementit voivat tuottaa äärettömän monta polkua. |
ALL TRAIL, ALL SIMPLE tai ALL ACYCLIC |
Tuettu | Tuettu, mutta polkujen määrä voi silti olla suuri. |
ANY SHORTEST WALK |
Tuettu | Tuettu yksinkertaiseen päätepisteen saavutettavuuteen, jossa on yksi anonyymi kvantifioitu reuna kahden solmun välissä. Polkua, joka on sidottu tähän rajoittamattomaan muotoon, voidaan käyttää vain ja PATH_LENGTH(path) sen path IS NULLrinnalla ; täydellistä polkua ei materialisoidu. Katso Rajoittamattomat muuttuvan pituuden kuviot. |
ANY SHORTEST TRAIL, ANY SHORTEST SIMPLE tai ANY SHORTEST ACYCLIC |
Tuettu | Tukivat. |
Kiinteät ja rajoitetut kvanttorit ovat {n}, {m,n}, ja {,n}. Rajoittamattomat kvanttorit ovat {m,}, *, ja +. Lisätietoja löytyy GQL-graafikuvioista.
Polkupredikaatin sijoittelu
GQL erottaa predikaatit, jotka rajoittavat kelpoisia polkuja, predikaateista, jotka suodattavat polkuja sen jälkeen, kun polkuhakuetuliite valitsee ne. Joillekin ANY SHORTEST kyselymuodoille Graph voi tällä hetkellä soveltaa lausetason MATCH ... WHERE ehtoa ennen polun valintaa.
Jotta suunniteltu vaihe olisi selkeä, sijoita kelpoisuuspredikaatit solmu- tai reunakuvioihin. Jälkivalintasuodatukseen käytetään erillistä FILTER lausetta .MATCH Esimerkkeinä katso Paikkapredikaatit ennen tai jälkeen polun valinnan.
Listapredikaattisuodattimet
Listapredikaattisuodattimet eivät tällä hetkellä tue seuraavia:
-
EXISTSalikyselyt. - Aggregaattifunktiot paikallisesti sidotun alkion yli. Vaakasuora aggregaatio ympäröivän ryhmälistan yli on tuettu.
Tuetusta syntaksista ja tulossemantiikasta katso Lista predikaattifunktiot.
Tulosten koko
Graafi katkaisee kyselyvastauksen, kun sen sisäinen binääriesitys ylittää 64 MB. Graafi palauttaa sopivat rivit ja raportoi lisävaroituksen julkisella tilakoodilla 01000 ja kanonisella GQLSTATUSilla 01M11. Välitulokset on rajattu 128 MB:iin.
Vastaus ei sisällä jatkotokenia riveille, jotka on jätetty pois trunkauksesta. Rajaa tulos suodattimilla, tietyillä projektioilla tai LIMIT, ja suorita kysely uudelleen.
Timeout
Kyselyrajapinnan suorituksella on yhteensä 20 minuutin aikakatkaisu, mukaan lukien jatkopyynnöt. Jos suoritus ylittää tämän rajan, API palauttaa HTTP 408:n virhekoodilla QueryTimeout.
Alikyselyt
CALL, OPTIONAL CALL, ja proseduurimuodon EXISTS alikyselyt ovat tuettuja.
Inline-alikyselyt CALL voidaan sisäkkäistä ja ne voivat implisiittisesti tuoda muuttujia ympäröivistä scope-alueista. Nimettyjä proseduurikutsuja, eksplisiittisiä muuttujien tuontilistoja kuten CALL (p) { ... }, pelkästään graafikuvio EXISTS, ja skalaariset alikyselyt (VALUE { ... }) eivät ole tuettuja.
Koostefunktiot
Seuraavat aggregaatiofunktiot ovat tuettuja:
-
COUNT,COUNT(*),SUM,AVG,MIN, jaMAX -
COLLECT_LIST,COLLECT_ONE, jaCOLLECT_ELEMENTS -
DISTINCTkaikkien edeltävien funktioiden variantit - Vaakasuorat (rivikohtaiset, ryhmämuuttujien/listojen yli) muunnelmat kaikista edellä mainituista
Seuraavat aggregaatiofunktiot eivät ole vielä tuettuja:
-
PERCENTILE_CONTJaPERCENTILE_DISC -
STDDEV_POPJaSTDDEV_SAMP PRODUCT
Toimintojen määrittäminen
UNION ALL ja UNION DISTINCT ovat tuettuja.
INTERSECT, EXCEPT, ja OTHERWISE niitä ei vielä tueta.
Tuetut GQL:n väitteet ja lausekkeet
Seuraavat GQL:n ydinväitteet ja -lausekkeet ovat tuettuja:
-
MATCHJaOPTIONAL MATCH -
WHERESuodattimet -
LETMuuttuvat sidokset -
FOR ... INlistan avaaminen valinnaisellaORDINALITYindeksoinnilla -
NEXT, mukaan lukien kyselyvaiheet, jotka sisältävätUNION,UNION DISTINCT, taiUNION ALL -
RETURNJaRETURN DISTINCT GROUP BY-
ORDER BYjoillaNULLS FIRSTtaiNULLS LAST -
LIMITJaOFFSET -
UNION ALLJaUNION DISTINCT -
CALL,OPTIONAL CALL, jaEXISTS -
CASTlaajalla tyyppimuunnosmatriisilla - Tuetut skalaari- ja aggregaattifunktiot, jotka on listattu GQL-lausekkeissa, predikaateissa ja funktioissa
DML- ja DDL-toiminnot
Data Manipulation Language (DML) -toiminnot kuten INSERT, UPDATE, ja DELETE ei tueta GQL:n kautta. Data Definition Language (DDL) -toimintoja skeemamutaatiolle ei tueta.
Tietojen vienti ja visualisointi
Kaaviokyselyjen tulosten tai kaaviorakenteiden vientiä ei tällä hetkellä tueta.
Power BI yhdistämistä suoraan kaavioon visualisointiskenaarioita varten ei tueta tällä hetkellä.
GQL-vaatimustenmukaisuus
Jos haluat yksityiskohtaisen määrityksen tuetuista GQL-ominaisuuksista ISO/IEC 39075:2024 -standardin kanssa, mukaan lukien vähimmäisvaatimukset, valinnaiset ominaisuudet ryhmittäin ja ominaisuudet, joita ei vielä tueta, on artikkelissa GQL-standardin vaatimustenmukaisuus.
Seuraavien ominaisuuksien osalta GQL-standardien noudattaminen on edelleen käynnissä.
Ohjausvirta ja joukkojen operaatiot
-
EXCEPT ALLjaEXCEPT DISTINCTlausekkeet -
INTERSECT ALLjaINTERSECT DISTINCTlausekkeet -
OTHERWISElausunto
Polun haku ja kuvioiden yhdistäminen
-
ALL SHORTESTPolun haku (ei tuettu) -
ANYPolun haku - Muut kuin lokaliset mallipredikaatit
- Rento topologinen yhdenmukaisuus
- Yleismerkit
Predikaatit
- Etikettitestipredikaatti (
IS LABELED) -
IS DIRECTEDPredikaatti - Normalisoitu predikaatti
- Lähde/kohde-predikaatti
-
ALL_DIFFERENTPredikaatti -
IS DISTINCTPredikaatti -
SAMEPredikaatti -
REGEXP_CONTAINSPredikaatti
Tuetut ajonaikaiset arvotyypit
| Ajonaikainen arvotyyppi | Edustus/alue | Rajoitus |
|---|---|---|
BOOLEAN |
true Ja false |
|
INT (tai INT64) |
Allekirjoitettu 64-bittinen kokonaisluku | |
UINT (tai UINT64) |
Allekirjoittamaton 64-bittinen kokonaisluku | |
DOUBLE (tai FLOAT64) |
IEEE-754 binary64 |
Ei vain äärellisiä tarkistuksia; epääärelliset arvot hyväksytään |
STRING |
Unicode-merkkijono | 65 534 tavua (UINT16 levyn pituus) |
ZONED DATETIME |
Millisekunteja Unix-aikakaudesta plus int32 UTC-siirtymä | int64 millisekunnin alue |
DURATION(DAY TO SECOND) |
Millisekunnin tarkkuus | |
NODE |
UINT64 RAW | |
EDGE |
UINT64 RAW | |
LIST |
Homogeeninen tyypityslista | 65 534 elementtiä (UINT16 levyn pituus) |
RECORD |
Tyypitettyjen kenttien rakenne | |
PATH |
Vuorotteleva lista solmuista ja kaarista, joka aina alkaa ja päättyy solmuun | 65 534 elementtiä (UINT16 levyn pituus) |
Ajonaikaiset arvotyypit, joita ei vielä tueta
-
INT8,INT16, jaINT32arvotyypit (INT64on tuettu) -
FLOAT16jaFLOAT32arvotyypit (FLOAT64on tuettu) -
UINT8,UINT16, jaUINT32arvotyypit (UINT64on tuettu) -
ZONED TIMEArvotyyppi -
DATEarvotyyppi itsenäisenä tyyppinä. Vastaanotetut päivämäärät vastaavat vyöhykkeellä olevaa päivämääräaikaa. -
LOCAL DATETIMEArvotyyppi -
LOCAL TIMEArvotyyppi -
DURATION(YEAR TO MONTH)Arvotyyppi -
BYTESarvotyyppi. Vastaanotto on tuettu, mutta tyyppiä ei voi kysyä tallennettuna ominaisuutena. -
VECTORArvotyyppi
Funktiot ja lausekkeet
-
PROPERTIESfunktio -
NORMALIZEmuodossa jaNFKCNFKD -
DURATION_BETWEENfunktio - Haetut
CASE WHENilmaukset - Skalaarien alikyselyt
- Polkuarvon yhdistäminen
- Tavumerkkijonojen yhdistäminen,
TRIM, ja pituusfunktiot - Yksinkertainen
TRIMfunktio spesifikaatiollaTRIM - Monimerkkifunktio
TRIM CARDINALITY
Yhdistäminen
-
PERCENTILE_CONTAggregaattifunktio -
PERCENTILE_DISCAggregaattifunktio -
PRODUCTAggregaattifunktio -
STDDEV_POPAggregaattifunktio -
STDDEV_SAMPAggregaattifunktio
Muu
- Parametrien siirto (
$paramdynaaminen parametrien määrittely) - Istunnon käyttäjä (
SESSION_USER) -
CALLNimetty proseduurin lause -
CALLalikyselyt, joissa on eksplisiittisiä muuttujien tuontilistoja - Luettelon hallinta. Graafien ja rajoiteiden nimet generoidaan automaattisesti.
Luettelo
Note
Graafien nimet ja rajoitenimet generoidaan automaattisesti, eikä niitä voi määrittää käyttöliittymässä tai JSON-skeemassa.
| Katalogialue | Virran raja / käyttäytyminen | Suositus |
|---|---|---|
| Kaavion rakenne | Yksi graafityyppi per katalogi. | |
| Graafin nimi | On oltava ei-tyhjä; ei eksplisiittistä maksimipituutta. | 127 hahmoa |
| Solmutyypit | Enintään noin 2 miljardia (int32 ID -tila). | 64K |
| Reunatyypit | Enintään noin 2 miljardia (int32 ID -tila). | 64K |
| Uniikit solmumerkinnät | Enintään noin 2 miljardia; yhden tyypin sisällä olevat kopiot hylätään. | Johdettu solmutyypeistä |
| Uniikit reunamerkinnät | Enintään noin 2 miljardia; yhden tyypin sisällä olevat kopiot hylätään. | Johdettu reunatyypeistä |
| Ainutlaatuiset kiinteistönimet | Enintään noin 2 miljardia; tyhjät nimet ja kaksoiskappaleet yhdessä tyypissä hylätään. | 64K x 10 |
| Ominaisuudet solmutyypin mukaan | Ei eksplisiittistä maksimia; kaksoisominaisuusnimiä hylätään. | 256 |
| Ominaisuudet särmätyypin mukaan | Ei eksplisiittistä maksimia; kaksoisominaisuusnimiä hylätään. | 256 |
| Tarrat solmutyypin mukaan | Ei eksplisiittistä maksimia; päällekkäiset etiketit hylätään. | 64 |
| Etiketit särmätyypin mukaan | Ei eksplisiittistä maksimia; päällekkäiset etiketit hylätään. | 64 |
| Keskeiset ominaisuudet rajoitteen mukaan | Ei eksplisiittistä maksimia; ominaisuusnimien on oltava ei-tyhjiä. | 16 |
| Kiinteistön nimen pituus | Ei nimenomaisesti valvottu muuta kuin ei-tyhjää. | 127 hahmoa |
| Levymerkin nimen pituus | Ei nimenomaisesti valvottu muuta kuin ei-tyhjää. | 127 hahmoa |
| Reunaavaimen rajoitteet | Oletuksena poistettu käytöstä (allow_edge_key_constraints lippu). |
≤ reunatyyppien lukumäärä |