Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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, ochStruct) 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:
-
EXISTSunderfrå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, ochMAX -
COLLECT_LIST,COLLECT_ONEochCOLLECT_ELEMENTS -
DISTINCTvarianter av alla föregående funktioner - Horisontella (radvis, över gruppvariabler/listor) varianter av alla ovanstående
Följande aggregeringsfunktioner stöds ännu inte:
-
PERCENTILE_CONTochPERCENTILE_DISC -
STDDEV_POPochSTDDEV_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:
-
MATCHochOPTIONAL MATCH -
WHEREFilter -
LETVariabelbindningar -
FOR ... INlistutrullning med valfriORDINALITYindexering -
NEXT, inklusive frågesteg som innehållerUNION,UNION DISTINCT, ellerUNION ALL -
RETURNochRETURN DISTINCT GROUP BY-
ORDER BYmedNULLS FIRSTellerNULLS LAST -
LIMITochOFFSET -
UNION ALLochUNION DISTINCT -
CALL,OPTIONAL CALLochEXISTS -
CASTmed 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- ochEXCEPT DISTINCT-satser -
INTERSECT ALL- ochINTERSECT DISTINCT-satser -
OTHERWISEuttalande
Vägsökning och mönsterigenkänning
-
ALL SHORTESTVägsökning (ej stödd) -
ANYVägsökning - Predikat för icke-lokaliserade mönster
- Avslappnad topologisk konsekvens
- Jokertecken
Predicates
- Etiketttestpredikat (
IS LABELED) -
IS DIRECTEDpredikat - Normaliserat predikat
- Käll-/målpredikat
-
ALL_DIFFERENTpredikat -
IS DISTINCTpredikat -
SAMEpredikat -
REGEXP_CONTAINSpredikat
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, ochINT32värdetyper (INT64stöds) -
FLOAT16ochFLOAT32värdetyper (FLOAT64stöds) -
UINT8,UINT16, ochUINT32värdetyper (UINT64stöds) -
ZONED TIMEVärdetyp -
DATEVärdetyp som en fristående typ. Inskrivna datum mappar till zoninerad DatumTid. -
LOCAL DATETIMEVärdetyp -
LOCAL TIMEVärdetyp -
DURATION(YEAR TO MONTH)Värdetyp -
BYTESVärdetyp. Intagning stöds, men typen kan inte frågas som en lagrad egenskap. -
VECTORVärdetyp
Funktioner och uttryck
- funktion
PROPERTIES -
NORMALIZEmed ochNFKDformernaNFKC - funktion
DURATION_BETWEEN - Sökta
CASE WHENuttryck - Skalära underfrågor
- Sammanfogning av sökvägsvärde
- Bytesträngssammansättning,
TRIM, och längdfunktioner - Enkel
TRIMfunktion med enTRIMspecifikation - Multiteckensfunktion
TRIM CARDINALITY
Aggregation
-
PERCENTILE_CONTaggregatfunktion -
PERCENTILE_DISCaggregatfunktion -
PRODUCTaggregatfunktion -
STDDEV_POPaggregatfunktion -
STDDEV_SAMPaggregatfunktion
Other
- Parameteröverföring (
$paramdynamisk parameterspecifikation) - Sessionsanvändare (
SESSION_USER) -
CALLNamngiven procedursats -
CALLdelfrå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 |