Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
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, ogStruct) 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:
-
EXISTSunderforespø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,MINogMAX -
COLLECT_LIST,COLLECT_ONEogCOLLECT_ELEMENTS -
DISTINCTvarianter av alle de foregående funksjonene - Horisontale (radvis, over gruppevariabler/lister) varianter av alle de ovennevnte
Følgende aggregeringsfunksjoner støttes ennå ikke:
-
PERCENTILE_CONTOgPERCENTILE_DISC -
STDDEV_POPOgSTDDEV_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:
-
MATCHOgOPTIONAL MATCH -
WHEREFiltre -
LETVariable bindinger -
FOR ... INlisteutrulling med valgfriORDINALITYindeksering -
NEXT, inkludert spørringsstadier som inneholderUNION,UNION DISTINCT, ellerUNION ALL -
RETURNOgRETURN DISTINCT GROUP BY-
ORDER BYmedNULLS FIRSTellerNULLS LAST -
LIMITOgOFFSET -
UNION ALLOgUNION DISTINCT -
CALL,OPTIONAL CALLogEXISTS -
CASTmed 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 ALLogEXCEPT DISTINCTsetninger -
INTERSECT ALLogINTERSECT DISTINCTsetninger -
OTHERWISEuttalelse
Stisøk og mønstergjenkjenning
-
ALL SHORTESTStisøk (ikke støttet) -
ANYStisøk - Predikater for ikke-lokal mønster
- Avslappet topologisk konsistens
- Jokertegn
Predikater
- Etikettetestpredikat (
IS LABELED) -
IS DIRECTEDPredikat - Normalisert predikat
- Kilde/målpredikat
-
ALL_DIFFERENTPredikat -
IS DISTINCTPredikat -
SAMEPredikat -
REGEXP_CONTAINSPredikat
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, ogINT32verdityper (INT64støttes) -
FLOAT16ogFLOAT32verdityper (FLOAT64støttes) -
UINT8,UINT16, ogUINT32verdityper (UINT64støttes) -
ZONED TIMEVerditype -
DATEVerditype som en frittstående type. Inntastede datoer kartlegger til SoneDatoTid. -
LOCAL DATETIMEVerditype -
LOCAL TIMEVerditype -
DURATION(YEAR TO MONTH)Verditype -
BYTESVerditype. Inntak støttes, men typen kan ikke spørres som en lagret egenskap. -
VECTORVerditype
Funksjoner og uttrykk
-
PROPERTIES(funksjon) -
NORMALIZEmed ogNFKDdannerNFKC -
DURATION_BETWEEN(funksjon) - Søkte
CASE WHENuttrykk - Skalarunderspørringer
- Sammenkobling av baneverdi
- Byte-streng-sammenkobling,
TRIM, og lengdefunksjoner - Enkel
TRIMfunksjon med enTRIMspesifikasjon - Flertegnsfunksjon
TRIM CARDINALITY
Aggregasjon
-
PERCENTILE_CONTAggregert funksjon -
PERCENTILE_DISCAggregert funksjon -
PRODUCTAggregert funksjon -
STDDEV_POPAggregert funksjon -
STDDEV_SAMPAggregert funksjon
Annet
- Parameteroverføring (
$paramdynamisk parameterspesifikasjon) - Sesjonsbruker (
SESSION_USER) -
CALLNavngitt prosedyreutsagn -
CALLUnderspø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 |