Kaavion nykyiset rajoitukset Microsoft Fabric

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, , ja Struct) 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:

  • EXISTS alikyselyt.
  • 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, ja MAX
  • COLLECT_LIST, COLLECT_ONE, ja COLLECT_ELEMENTS
  • DISTINCT kaikkien edeltävien funktioiden variantit
  • Vaakasuorat (rivikohtaiset, ryhmämuuttujien/listojen yli) muunnelmat kaikista edellä mainituista

Seuraavat aggregaatiofunktiot eivät ole vielä tuettuja:

  • PERCENTILE_CONT Ja PERCENTILE_DISC
  • STDDEV_POP Ja STDDEV_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:

  • MATCH Ja OPTIONAL MATCH
  • WHERE Suodattimet
  • LET Muuttuvat sidokset
  • FOR ... IN listan avaaminen valinnaisella ORDINALITY indeksoinnilla
  • NEXT, mukaan lukien kyselyvaiheet, jotka sisältävät UNION, UNION DISTINCT, tai UNION ALL
  • RETURN Ja RETURN DISTINCT
  • GROUP BY
  • ORDER BY joilla NULLS FIRST tai NULLS LAST
  • LIMIT Ja OFFSET
  • UNION ALL Ja UNION DISTINCT
  • CALL, OPTIONAL CALL, ja EXISTS
  • CAST laajalla 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 ALL ja EXCEPT DISTINCT lausekkeet
  • INTERSECT ALL ja INTERSECT DISTINCT lausekkeet
  • OTHERWISE lausunto

Polun haku ja kuvioiden yhdistäminen

  • ALL SHORTEST Polun haku (ei tuettu)
  • ANY Polun haku
  • Muut kuin lokaliset mallipredikaatit
  • Rento topologinen yhdenmukaisuus
  • Yleismerkit

Predikaatit

  • Etikettitestipredikaatti (IS LABELED)
  • IS DIRECTED Predikaatti
  • Normalisoitu predikaatti
  • Lähde/kohde-predikaatti
  • ALL_DIFFERENT Predikaatti
  • IS DISTINCT Predikaatti
  • SAME Predikaatti
  • REGEXP_CONTAINS Predikaatti

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, ja INT32 arvotyypit (INT64 on tuettu)
  • FLOAT16 ja FLOAT32 arvotyypit (FLOAT64 on tuettu)
  • UINT8, UINT16, ja UINT32 arvotyypit (UINT64 on tuettu)
  • ZONED TIME Arvotyyppi
  • DATE arvotyyppi itsenäisenä tyyppinä. Vastaanotetut päivämäärät vastaavat vyöhykkeellä olevaa päivämääräaikaa.
  • LOCAL DATETIME Arvotyyppi
  • LOCAL TIME Arvotyyppi
  • DURATION(YEAR TO MONTH) Arvotyyppi
  • BYTES arvotyyppi. Vastaanotto on tuettu, mutta tyyppiä ei voi kysyä tallennettuna ominaisuutena.
  • VECTOR Arvotyyppi

Funktiot ja lausekkeet

  • PROPERTIES funktio
  • NORMALIZEmuodossa ja NFKCNFKD
  • DURATION_BETWEEN funktio
  • Haetut CASE WHEN ilmaukset
  • Skalaarien alikyselyt
  • Polkuarvon yhdistäminen
  • Tavumerkkijonojen yhdistäminen, TRIM, ja pituusfunktiot
  • Yksinkertainen TRIM funktio spesifikaatiolla TRIM
  • Monimerkkifunktio TRIM
  • CARDINALITY

Yhdistäminen

  • PERCENTILE_CONT Aggregaattifunktio
  • PERCENTILE_DISC Aggregaattifunktio
  • PRODUCT Aggregaattifunktio
  • STDDEV_POP Aggregaattifunktio
  • STDDEV_SAMP Aggregaattifunktio

Muu

  • Parametrien siirto ($param dynaaminen parametrien määrittely)
  • Istunnon käyttäjä (SESSION_USER)
  • CALL Nimetty proseduurin lause
  • CALL alikyselyt, 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ä