Gjeldende begrensninger for graf i Microsoft Fabric

Graf i Microsoft Fabric har visse funksjonelle begrensninger. Denne artikkelen fremhever noen viktige begrensninger, men er ikke en uttømmende liste. Kom regelmessig tilbake for oppdateringer.

Hvis du vil ha hjelp med vanlige problemer, kan du se Feilsøkingsgraf.

Opprette grafmodeller

Datakilder

OneLake og speilede databaser er de støttede datakildene for grafer.

Datatyper

Grafmodeller støtter følgende egenskapsverdityper.

GQL-verditype Beskrivelse
BOOLEAN Verdiene er true og false.
INT (eller INT64) Verdiene er 64-bits signerte heltall.
DOUBLE (eller FLOAT64) Verdiene er 64-bits IEEE-754 flyttall.
FLOAT (eller FLOAT32) Verdiene er 32-bits flyttall.
STRING Verdiene er UTF-8-kodede Unicode-tegnstrenger. Maksimal egenskapsstørrelse er 65 535 byte.
ZONED DATETIME Verdier er tidsstempler sammen med tidssoneforskyvning, med millisekundpresisjon.

Følgende OneLake- og Delta Lake-kolonnetyper støttes for inntasting i grafer.

OneLake-typen Karter til GQL egenskapsverditype
BooleanType BOOLEAN
ByteType INT (eller INT64)
IntegerType INT (eller INT64)
LongType INT (eller INT64)
FloatType DOUBLE (eller FLOAT64)
DoubleType DOUBLE (eller FLOAT64)
StringType STRING
DateType ZONED DATETIME
TimestampType ZONED DATETIME
TimestampNtzType ZONED DATETIME

Note

Komplekse eller nestede Delta Lake-typer (MapType og StructType) støttes ikke. Du kan parse JSON-kodede strengkolonner ved spørring ved å bruke PARSE_JSON_STRING.

Grafbehandling og skalering

Graflasting og oppdateringsoperasjoner kan kreve forlenget prosesseringstid avhengig av grafstørrelse, antall grafelementer (noder og kanter) og størrelsen på egenskapsnyttelastene knyttet til disse elementene. Store grafer kan ta flere timer å behandle. Hvis en graflasting eller oppdatering ikke er fullført etter 24 timer, send inn en supportforespørsel for videre undersøkelse.

Dagens grafbehandlingsmuligheter støtter grafer som inneholder opptil omtrent 2 milliarder grafelementer (noder og kanter). Effektiv kapasitet kan variere basert på grafstruktur og egenskaps nyttelaststørrelse. Hvis arbeidsmengden din forventes å overstige disse grensene, kontakt Microsoft Kundestøtte for veiledning.

Partisjonskolonner

Delta Lake-partisjonskolonner har begrenset støtte som grafegenskaper:

  • Partisjonskolonner som brukes som eneste primærnøkkel blir alltid avvist.
  • Genererte partisjonskolonner støttes ikke.
  • Komplekse og desimale partisjonskolonnetyper (Decimal, Binary, , MapArray, og Struct) fjernes med en advarsel.

Skjemaendringer

Skjemaendringer utløser en grafomlading.

Spørring

Baner med variabel lengde

Utforsk UI-stibyggeren støtter opptil åtte hopp for mønstre med variabel lengde. Denne brukergrensesnittbegrensningen gjelder ikke for GQL-spørringer som legges inn i kodeeditoren.

Graph støtter ALL og ANY SHORTEST path search-prefiksene. ALL SHORTEST og ANY ikke støttes.

Følgende tabell oppsummerer støtte for variabel lengde GQL:

Stisøk og stimodus Fast eller begrenset kvantifikator Ubegrenset kvantifikator
ALL WALK (standard) Støttes Ikke støttet fordi gjentatte elementer kan produsere uendelig mange stier.
ALL TRAIL, ALL SIMPLEeller ALL ACYCLIC Støttes Støttet, men antallet stier kan fortsatt være stort.
ANY SHORTEST WALK Støttes Støttes for enkel endepunktstilgjengelighet med én anonym kvantifisert kant mellom to noder. En sti bundet av denne ubegrensede formen kan kun brukes med PATH_LENGTH(path) og, ved siden av den, path IS NULL; den komplette stien materialiseres ikke. Se ubegrensede mønstre med variabel lengde.
ANY SHORTEST TRAIL, ANY SHORTEST SIMPLEeller ANY SHORTEST ACYCLIC Støttes Støttes.

Faste og begrensede kvantorer er {n}, {m,n}, og {,n}. Ubundne kvantorer er {m,}, *, og +. For mer informasjon, se GQL-grafmønstre.

Plassering av stipredikat

GQL skiller predikater som begrenser kvalifiserte stier fra predikater som filtrerer stier etter at et stisøk-prefiks har valgt dem. For noen ANY SHORTEST spørringsformer kan Graph for øyeblikket anvende en setningsnivåbetingelse MATCH ... WHERE før valg av sti.

For å gjøre det tiltenkte stadiet eksplisitt, plasser kvalifiseringspredikater i linje i node- eller kantmønstre. For filtrering etter utvalget, bruk en separat FILTER setning etter MATCH. For eksempler, se Sted-predikater før eller etter stivalg.

List predikatfiltre

Listepredikatfiltre støtter for øyeblikket ikke:

  • EXISTS underforespørsler.
  • Aggregerte funksjoner over det lokalt bundne elementet. Horisontal aggregering over en omsluttende gruppeliste støttes.

For støttet syntaks og resultatsemantikk, se Liste predikatfunksjoner.

Størrelsen på resultatene

Grafen avkorter et spørringssvar når dens interne binære representasjon overstiger 64 MB. Grafen returnerer radene som passer og rapporterer en ekstra advarsel med offentlig statuskode 01000 og kanonisk GQLSTATUS 01M11. Intermediate-resultater er begrenset til 128 MB.

Svaret inkluderer ikke en fortsettelsestoken for rader som er utelatt ved trunkering. Begrens resultatet med filtre, spesifikke projeksjoner, eller LIMIT, og kjør deretter spørringen på nytt.

Timeout

Kjøringen av spørrings-API-et har en total tidsavbrudd på 20 minutter, inkludert fortsettelsesforespørsler. Hvis utførelsen overstiger denne grensen, returnerer API-et HTTP 408 med feilkode QueryTimeout.

Delspørringer

CALL, OPTIONAL CALL, og prosedyreform-underspørringer EXISTS støttes. Inline CALL underspørringer kan nestes og implisitt importere variabler fra omsluttende scopes. Navngitte prosedyrekall, eksplisitte variabelimportlister som CALL (p) { ... }, grafmønster-only EXISTS, og skalarunderspørringer (VALUE { ... }) støttes ikke.

Aggregasjonsfunksjoner

Følgende aggregeringsfunksjoner støttes:

  • COUNT, COUNT(*), SUM, AVG, MINog MAX
  • COLLECT_LIST, COLLECT_ONEog COLLECT_ELEMENTS
  • DISTINCT varianter av alle de foregående funksjonene
  • Horisontale (radvis, over gruppevariabler/lister) varianter av alle de ovennevnte

Følgende aggregeringsfunksjoner støttes ennå ikke:

  • PERCENTILE_CONT Og PERCENTILE_DISC
  • STDDEV_POP Og STDDEV_SAMP
  • PRODUCT

Angi operasjoner

UNION ALL og UNION DISTINCT støttes. INTERSECT, EXCEPT, og OTHERWISE støttes ennå ikke.

Støttede GQL-setninger og klausuler

Følgende kjerne-GQL-setninger og klausuler støttes:

  • MATCH Og OPTIONAL MATCH
  • WHERE Filtre
  • LET Variable bindinger
  • FOR ... IN listeutrulling med valgfri ORDINALITY indeksering
  • NEXT, inkludert spørringsstadier som inneholder UNION, UNION DISTINCT, eller UNION ALL
  • RETURN Og RETURN DISTINCT
  • GROUP BY
  • ORDER BY med NULLS FIRST eller NULLS LAST
  • LIMIT Og OFFSET
  • UNION ALL Og UNION DISTINCT
  • CALL, OPTIONAL CALLog EXISTS
  • CAST med en bred type-konverteringsmatrise
  • Støttede skalar- og aggregatfunksjoner listet i GQL-uttrykk, predikater og funksjoner

DML- og DDL-operasjoner

Data Manipulation Language (DML)-operasjoner som INSERT, UPDATE, og DELETE støttes ikke gjennom GQL. Data Definition Language (DDL)-operasjoner for skjemamutasjon støttes ikke.

Dataeksport og visualisering

Eksport av diagramspørringsresultater eller grafstrukturer støttes for øyeblikket ikke.

Tilkobling av Power BI direkte til en graf for visualiseringsscenarioer støttes for øyeblikket ikke.

GQL-samsvar

Hvis du vil ha en detaljert tilordning av støttede GQL-funksjoner mot ISO/IEC 39075:2024-standarden, inkludert minimum samsvar, valgfrie funksjoner etter gruppe og funksjoner som ennå ikke støttes, kan du se GQL-standard samsvar.

Overholdelse av GQL-standarder pågår fortsatt for følgende funksjoner.

Kontrollflyt og settoperasjoner

  • EXCEPT ALL og EXCEPT DISTINCT setninger
  • INTERSECT ALL og INTERSECT DISTINCT setninger
  • OTHERWISE uttalelse

Stisøk og mønstergjenkjenning

  • ALL SHORTEST Stisøk (ikke støttet)
  • ANY Stisøk
  • Predikater for ikke-lokal mønster
  • Avslappet topologisk konsistens
  • Jokertegn

Predikater

  • Etikettetestpredikat (IS LABELED)
  • IS DIRECTED Predikat
  • Normalisert predikat
  • Kilde/målpredikat
  • ALL_DIFFERENT Predikat
  • IS DISTINCT Predikat
  • SAME Predikat
  • REGEXP_CONTAINS Predikat

Støttet runtime-verdityper

Kjøretidsverditype Representasjon/utbredelse Grense
BOOLEAN true Og false
INT (eller INT64) Signert 64-bits heltall
UINT (eller UINT64) Usignert 64-bits heltall
DOUBLE (eller FLOAT64) IEEE-754 binary64 Ingen kun endelig sjekk; ikke-endelige verdier aksepteres
STRING Unicode-streng 65 534 byte (uint16 på disken)
ZONED DATETIME Millisekunder siden Unix-epoken pluss int32 UTC-forskyvning int64 millisekund rekkevidde
DURATION(DAY TO SECOND) Millisekundpresisjon
NODE uint64 raw
EDGE uint64 raw
LIST Homogen typet liste 65 534 elementer (uint16 på disken)
RECORD Struktur av typede felt
PATH Vekslende liste over noder og kanter som alltid starter og slutter med en node 65 534 elementer (uint16 på disken)

Kjøretidsverdityper som ennå ikke støttes

  • INT8, INT16, og INT32 verdityper (INT64 støttes)
  • FLOAT16 og FLOAT32 verdityper (FLOAT64 støttes)
  • UINT8, UINT16, og UINT32 verdityper (UINT64 støttes)
  • ZONED TIME Verditype
  • DATE Verditype som en frittstående type. Inntastede datoer kartlegger til SoneDatoTid.
  • LOCAL DATETIME Verditype
  • LOCAL TIME Verditype
  • DURATION(YEAR TO MONTH) Verditype
  • BYTES Verditype. Inntak støttes, men typen kan ikke spørres som en lagret egenskap.
  • VECTOR Verditype

Funksjoner og uttrykk

  • PROPERTIES (funksjon)
  • NORMALIZEmed og NFKD danner NFKC
  • DURATION_BETWEEN (funksjon)
  • Søkte CASE WHEN uttrykk
  • Skalarunderspørringer
  • Sammenkobling av baneverdi
  • Byte-streng-sammenkobling, TRIM, og lengdefunksjoner
  • Enkel TRIM funksjon med en TRIM spesifikasjon
  • Flertegnsfunksjon TRIM
  • CARDINALITY

Aggregasjon

  • PERCENTILE_CONT Aggregert funksjon
  • PERCENTILE_DISC Aggregert funksjon
  • PRODUCT Aggregert funksjon
  • STDDEV_POP Aggregert funksjon
  • STDDEV_SAMP Aggregert funksjon

Annet

  • Parameteroverføring ($param dynamisk parameterspesifikasjon)
  • Sesjonsbruker (SESSION_USER)
  • CALL Navngitt prosedyreutsagn
  • CALL Underspørringer med eksplisitte variabelimportlister
  • Kataloghåndtering. Graf- og begrensningsnavn genereres automatisk.

Katalog

Note

Grafnavn og constraint-navn genereres automatisk og kan ikke spesifiseres i UI eller i JSON-skjemaet.

Katalogområde Strømgrense / oppførsel Anbefaling
Graph-skjema Én graftype per katalog.
Grafnavn Må være ikke-tom; ingen eksplisitt maksimal lengde. 127 karakterer
Nodetyper Maksimalt omtrent 2 milliarder (int32 ID-plass). 64K
Kanttyper Maksimalt omtrent 2 milliarder (int32 ID-plass). 64K
Unike nodeetiketter Maksimalt omtrent 2 milliarder; duplikater innen én type avvises. Avledet fra nodetyper
Unike kantetiketter Maksimalt omtrent 2 milliarder; duplikater innen én type avvises. Avledet fra kanttyper
Unike eiendomsnavn Maksimalt omtrent 2 milliarder; tomme navn og duplikater innenfor én type avvises. 64K x 10
Egenskaper per nodetype Ingen eksplisitt maksimum; dupliserte egenskapsnavn avvises. 256
Egenskaper per kanttype Ingen eksplisitt maksimum; dupliserte egenskapsnavn avvises. 256
Etiketter per nodetype Ingen eksplisitt maksimum; dupliserte etiketter avvises. 64
Etiketter per kanttype Ingen eksplisitt maksimum; dupliserte etiketter avvises. 64
Nøkkelegenskaper per begrensning Ingen eksplisitt maksimum; egenskapsnavn må være ikke-tomme. 16
Eiendomsnavnets lengde Ikke eksplisitt håndhevet utover ikke-tom. 127 karakterer
Etikettens navnelengde Ikke eksplisitt håndhevet utover ikke-tom. 127 karakterer
Kantnøkkelbegrensninger Deaktivert som standard (allow_edge_key_constraints flagg). ≤ antall kanttyper