Aktuella begränsningar för graf i Microsoft Fabric

Graf i Microsoft Fabric har vissa funktionella begränsningar. Den här artikeln belyser några viktiga begränsningar men är inte en fullständig lista. Kom tillbaka regelbundet för uppdateringar.

Hjälp med vanliga problem finns i Felsökningsdiagram.

Skapa grafmodeller

Datakällor

OneLake och Mirrored Databases är de stödda datakällorna för grafer.

Datatyper

Grafmodeller stöder följande egenskapsvärdestyper.

GQL-värdetyp Beskrivning
BOOLEAN Värden är true och false.
INT (eller INT64) Värdena är 64-bitars signerade heltal.
DOUBLE (eller FLOAT64) Värdena är 64-bitars IEEE-754 flyttalstal.
FLOAT (eller FLOAT32) Värdena är 32-bitars flyttalstal.
STRING Värdena är UTF-8-kodade Unicode-teckensträngar. Den maximala egenskapsstorleken är 65 535 byte.
ZONED DATETIME Värden är tidsstämplar tillsammans med en tidszonsförskjutning, med millisekundprecision.

Följande kolumntyper i OneLake och Delta Lake stöds för inmatning i grafer.

OneLake-typ Avbildar till GQL-egenskapsvärdestyp
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

Komplexa eller nästlade Delta Lake-typer (MapType och StructType) stöds inte. Du kan tolka JSON-kodade strängkolumner vid frågetid genom att använda PARSE_JSON_STRING.

Grafbearbetning och skala

Grafladdnings- och uppdateringsoperationer kan kräva förlängd bearbetningstid beroende på grafens storlek, antalet grafelement (noder och kanter) och storleken på egenskapspayloads kopplade till dessa element. Stora grafer kan ta flera timmar att bearbeta. Om en grafinläsning eller uppdatering inte har slutförts efter 24 timmar, skicka in en supportförfrågan för vidare undersökning.

Nuvarande grafbearbetningsmöjligheter stödjer grafer som innehåller upp till cirka 2 miljarder grafelement (noder och kanter). Effektiv kapacitet kan variera beroende på grafstruktur och egendomens laststorlek. Om din arbetsbelastning förväntas överstiga dessa gränser, kontakta Microsoft Support för vägledning.

Partitionskolumner

Delta Lake-partitionskolumner har begränsat stöd som grafegenskaper:

  • Partitionskolumner som används som enda primärnyckel avvisas alltid.
  • Genererade partitionskolumner stöds inte.
  • Komplexa och decimala partitionskolumntyper (Decimal, Binary, , MapArray, och Struct) tas bort med en varning.

Schemaändringar

Schemaändringar utlöser en omladdning av grafen.

Querying

Banor med variabel längd

Explore UI-path buildern stödjer upp till åtta hopp för mönster med variabel längd. Denna användargränssnittsbegränsning gäller inte för GQL-frågor som matas in i kodredigeraren.

Graph stöder ALL och ANY SHORTEST path search-prefixen. ALL SHORTEST och ANY stöds inte.

Följande tabell sammanfattar stöd för variabel längd GQL:

Vägsökning och vägläge Fast eller begränsad kvantifier Obegränsad kvantifikator
ALL WALK (standardinställning) Supported Inte stödd eftersom upprepade element kan producera oändligt många vägar.
ALL TRAIL, ALL SIMPLE eller ALL ACYCLIC Supported Stöds, men antalet vägar kan fortfarande vara stort.
ANY SHORTEST WALK Supported Stöds för enkel endpoint-nådbarhet med en anonym kvantifierad kant mellan två noder. En väg begränsad av denna obegränsade form kan endast användas med PATH_LENGTH(path) och, tillsammans med den, path IS NULL; den fullständiga vägen materialiseras inte. Se obegränsade mönster med variabel längd.
ANY SHORTEST TRAIL, ANY SHORTEST SIMPLE eller ANY SHORTEST ACYCLIC Supported Stöds.

Fasta och begränsade kvantifikatorer är {n}, {m,n}, och {,n}. Obundna kvantifikatorer är {m,}, *, och +. För mer information, se GQL-grafmönster.

Placering av banpredikat

GQL skiljer på predikat som begränsar berättigade vägar från predikat som filtrerar vägar efter att ett sökprefix för vägsökning valt dem. För vissa ANY SHORTEST frågeformer kan Graph för närvarande tillämpa ett satsnivåvillkor MATCH ... WHERE innan valet av väg.

För att göra det avsedda steget tydligt, placera behörighetspredikater i linje med nod- eller kantmönster. För filtrering efter urval, använd en separat FILTER sats efter MATCH. För exempel, se Platspredikat före eller efter vägval.

Lista predikatfilter

Listpredikatfilter stöder för närvarande inte:

  • EXISTS underfrågor.
  • Aggregera funktioner över det lokalt bundna elementet. Horisontell aggregering över en omslutande grupplista stöds.

För stödd syntax och resultatsemantik, se Lista predikatfunktioner.

Resultatstorlek

Grafen förkortar ett frågesvar när dess interna binära representation överstiger 64 MB. Graph returnerar raderna som passar och rapporterar en ytterligare varning med offentlig statuskod 01000 och kanonisk GQLSTATUS 01M11. Mellanresultat är begränsade till 128 MB.

Svaret inkluderar ingen fortsättningstoken för rader som utelämnas av trunkering. Begränsa resultatet med filter, specifika projektioner eller LIMIT, och kör sedan frågan igen.

Tidsavbrott

Query API-exekveringen har en total timeout på 20 minuter, inklusive fortsättningsförfrågningar. Om exekveringen överskrider denna gräns returnerar API:et HTTP 408 med felkod QueryTimeout.

Subqueries

CALL, OPTIONAL CALL, och procedurformulärsunderfrågor EXISTS stöds. Inline-subförfrågningar CALL kan nästlade och implicit importera variabler från omslutande scopes. Namngivna proceduranrop, explicita variabelimportlistor såsom CALL (p) { ... }, grafmönster-endast EXISTS, och skalära underförfrågningar (VALUE { ... }) stöds inte.

Sammansättningsfunktioner

Följande sammansättningsfunktioner stöds:

  • COUNT, COUNT(*), SUM, AVG, MIN, och MAX
  • COLLECT_LIST, COLLECT_ONE och COLLECT_ELEMENTS
  • DISTINCT varianter av alla föregående funktioner
  • Horisontella (radvis, över gruppvariabler/listor) varianter av alla ovanstående

Följande aggregeringsfunktioner stöds ännu inte:

  • PERCENTILE_CONT och PERCENTILE_DISC
  • STDDEV_POP och STDDEV_SAMP
  • PRODUCT

Ange åtgärder

UNION ALL och UNION DISTINCT stöds. INTERSECT, EXCEPT, och OTHERWISE stöds ännu inte.

Stödda GQL-satser och satser

Följande kärn-GQL-satser och klausuler stöds:

  • MATCH och OPTIONAL MATCH
  • WHERE Filter
  • LET Variabelbindningar
  • FOR ... IN listutrullning med valfri ORDINALITY indexering
  • NEXT, inklusive frågesteg som innehåller UNION, UNION DISTINCT, eller UNION ALL
  • RETURN och RETURN DISTINCT
  • GROUP BY
  • ORDER BY med NULLS FIRST eller NULLS LAST
  • LIMIT och OFFSET
  • UNION ALL och UNION DISTINCT
  • CALL, OPTIONAL CALL och EXISTS
  • CAST med en bredtyp-konverteringsmatris
  • Stödda skalära och aggregerade funktioner listade i GQL-uttryck, predikat och funktioner

DML- och DDL-operationer

Data Manipulation Language (DML)-operationer såsom INSERT, UPDATE, och DELETE stöds inte av GQL. Data Definition Language (DDL)-operationer för schemamutation stöds inte.

Dataexport och visualisering

Export av diagramfrågeresultat eller grafstrukturer stöds inte för närvarande.

Det finns för närvarande inte stöd för att ansluta Power BI direkt till ett diagram för visualiseringsscenarier.

GQL-överensstämmelse

En detaljerad mappning av GQL-funktioner som stöds mot STANDARDEN ISO/IEC 39075:2024, inklusive minsta överensstämmelse, valfria funktioner efter grupp och funktioner som ännu inte stöds, finns i GQL-standardöverensstämmelse.

Efterlevnad av GQL-standarder pågår fortfarande för följande funktioner.

Styrflöde och setoperationer

  • EXCEPT ALL- och EXCEPT DISTINCT-satser
  • INTERSECT ALL- och INTERSECT DISTINCT-satser
  • OTHERWISE uttalande

Vägsökning och mönsterigenkänning

  • ALL SHORTEST Vägsökning (ej stödd)
  • ANY Vägsökning
  • Predikat för icke-lokaliserade mönster
  • Avslappnad topologisk konsekvens
  • Jokertecken

Predicates

  • Etiketttestpredikat (IS LABELED)
  • IS DIRECTED predikat
  • Normaliserat predikat
  • Käll-/målpredikat
  • ALL_DIFFERENT predikat
  • IS DISTINCT predikat
  • SAME predikat
  • REGEXP_CONTAINS predikat

Stödda körtidsvärdetyper

Körtidsvärdetyp Representation/utbredning Limit
BOOLEAN true och false
INT (eller INT64) Signerat 64-bitars heltal
UINT (eller UINT64) Osignerat heltal med 64 bitar
DOUBLE (eller FLOAT64) IEEE-754 binary64 Ingen ändlig kontroll endast är tillåten; icke-ändliga värden accepteras
STRING Unicode-sträng 65 534 byte (uint16 på diskens längd)
ZONED DATETIME Millisekunder sedan Unix-epoken plus int32 UTC-förskjutning int64 millisekundintervall
DURATION(DAY TO SECOND) Millisekundprecision
NODE uint64 raw
EDGE uint64 raw
LIST Homogen typad lista 65 534 element (uint16 på skivlängd)
RECORD Struktur av typade fält
PATH Alternerande lista av noder och kanter som alltid börjar och slutar med en nod 65 534 element (uint16 på skivlängd)

Versionsvärdetyper som ännu inte stöds

  • INT8, INT16, och INT32 värdetyper (INT64 stöds)
  • FLOAT16 och FLOAT32 värdetyper (FLOAT64 stöds)
  • UINT8, UINT16, och UINT32 värdetyper (UINT64 stöds)
  • ZONED TIME Värdetyp
  • DATE Värdetyp som en fristående typ. Inskrivna datum mappar till zoninerad DatumTid.
  • LOCAL DATETIME Värdetyp
  • LOCAL TIME Värdetyp
  • DURATION(YEAR TO MONTH) Värdetyp
  • BYTES Värdetyp. Intagning stöds, men typen kan inte frågas som en lagrad egenskap.
  • VECTOR Värdetyp

Funktioner och uttryck

  • funktion PROPERTIES
  • NORMALIZEmed och NFKD formerna NFKC
  • funktion DURATION_BETWEEN
  • Sökta CASE WHEN uttryck
  • Skalära underfrågor
  • Sammanfogning av sökvägsvärde
  • Bytesträngssammansättning, TRIM, och längdfunktioner
  • Enkel TRIM funktion med en TRIM specifikation
  • Multiteckensfunktion TRIM
  • CARDINALITY

Aggregation

  • PERCENTILE_CONT aggregatfunktion
  • PERCENTILE_DISC aggregatfunktion
  • PRODUCT aggregatfunktion
  • STDDEV_POP aggregatfunktion
  • STDDEV_SAMP aggregatfunktion

Other

  • Parameteröverföring ($param dynamisk parameterspecifikation)
  • Sessionsanvändare (SESSION_USER)
  • CALL Namngiven procedursats
  • CALL delfrågor med explicita variabelimportlistor
  • Kataloghantering. Graf- och begränsningsnamn genereras automatiskt.

Catalog

Note

Grafnamn och begränsningsnamn genereras automatiskt och kan inte specificeras i UI:t eller i JSON-schemat.

Katalogområde Strömgräns / beteende Recommendation
Diagramschema En graftyp per katalog.
Grafens namn Måste vara icke-tom; ingen explicit maximal längd. 127 karaktärer
Nodtyper Maximalt cirka 2 miljarder (int32 ID-utrymme). 64 kB
Kanttyper Maximalt cirka 2 miljarder (int32 ID-utrymme). 64 kB
Unika nodetiketter Högst cirka 2 miljarder; dubbletter inom en typ avvisas. Härledd från nodtyper
Unika kantetiketter Högst cirka 2 miljarder; dubbletter inom en typ avvisas. Härledd från kanttyper
Unika egendomsnamn Högst cirka 2 miljarder; tomma namn och dubbletter inom en typ avvisas. 64K x 10
Egenskaper per nodtyp Ingen explicit maxgräns; dubbletter av egenskapsnamn avvisas. 256
Egenskaper per kanttyp Ingen explicit maxgräns; dubbletter av egenskapsnamn avvisas. 256
Etiketter per nodtyp Ingen explicit maxgräns; dubblettetiketter avvisas. 64
Etiketter per kanttyp Ingen explicit maxgräns; dubblettetiketter avvisas. 64
Nyckelegenskaper per begränsning Inget explicit maximum; egenskapsnamn måste vara icke-tomma. 16
Namnets längd Inte uttryckligen upprätthållet utöver icke-tom. 127 karaktärer
Namnlängd för etikett Inte uttryckligen upprätthållet utöver icke-tom. 127 karaktärer
Kantnyckelbegränsningar Avaktiverad som standard (allow_edge_key_constraints flagga). ≤ antalet kanttyper