Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Microsoft Fabric'teki grafiğin belirli işlevsel sınırlamaları vardır. Bu makalede bazı önemli sınırlamalar vurgulanır ancak kapsamlı bir liste değildir. Güncelleştirmeleri düzenli olarak kontrol edin.
Yaygın sorunlarla ilgili yardım için bkz . Graf sorunlarını giderme.
Grafik modelleri oluşturma
Veri kaynakları
OneLake ve Mirrored Databases grafik için desteklenen veri kaynaklarıdır.
Veri türleri
Grafik modelleri aşağıdaki özellik değer türlerini destekler.
| GQL değer tipi | Açıklama |
|---|---|
BOOLEAN |
Değerler true ve false. |
INT (veya INT64) |
Değerler 64 bitlik imzalı tam sayılardır. |
DOUBLE (veya FLOAT64) |
Değerler 64 bitlik IEEE-754 kayan nokta sayılarıdır. |
FLOAT (veya FLOAT32) |
Değerler 32 bitlik kayan nokta sayılarıdır. |
STRING |
Değerler UTF-8 kodlanmış Unicode karakter dizileridir. Maksimum mülk boyutu 65.535 bayttır. |
ZONED DATETIME |
Değerler, milisaniye hassasiyetiyle bir zaman kuşağı ofseti ile birlikte zaman damgalarıdır. |
Aşağıdaki OneLake ve Delta Lake sütun türleri grafiklere alınmak için desteklenmektedir.
| OneLake tipi | GQL özellik değer tipine eşlemeler |
|---|---|
BooleanType |
BOOLEAN |
ByteType |
INT (veya INT64) |
IntegerType |
INT (veya INT64) |
LongType |
INT (veya INT64) |
FloatType |
DOUBLE (veya FLOAT64) |
DoubleType |
DOUBLE (veya FLOAT64) |
StringType |
STRING |
DateType |
ZONED DATETIME |
TimestampType |
ZONED DATETIME |
TimestampNtzType |
ZONED DATETIME |
Note
Karmaşık veya iç içe Delta Gölü türleri (MapType ve StructType) desteklenmez. JSON kodlu dizi sütunlarını sorgu zamanında .PARSE_JSON_STRING
Grafik işleme ve ölçeklendirme
Grafik yükleme ve yenileme işlemleri, grafik boyutuna, grafik elemanlarının (düğümler ve kenarlar) sayısına ve bu elemanlarla ilişkili özellik yüklerinin boyutuna bağlı olarak uzun işlem süresi gerektirebilir. Büyük grafiklerin işlenmesi birkaç saat sürebilir. Grafik yükleme veya yenileme işlemi 24 saat içinde tamamlanmadıysa, daha fazla araştırma için destek talebi gönderin .
Mevcut grafik işleme yetenekleri, yaklaşık 2 milyar grafik elemanı (düğümler ve kenarlar) içeren grafikleri destekler. Etkili kapasite, grafik yapısına ve özellik yük boyutuna göre değişebilir. İş yükünüzün bu sınırları aşması bekleniyorsa, rehberlik için Microsoft Desteği ile iletişime geçin.
Bölümlendirme sütunları
Delta Lake bölüm sütunları grafik özellikleri olarak sınırlı destek sunar:
- Tek birincil anahtar olarak kullanılan bölüm sütunları her zaman reddedilir.
- Oluşturulan bölüm sütunları desteklenmiyor.
- Karmaşık ve ondalık bölüm sütun türleri (
Decimal,Binary,MapArray, , veStruct) uyarı ile düşürülür.
Şema değişiklikleri
Şema değişiklikleri bir grafik yeniden yüklemesini tetikler.
Sorgulama İşlemi
Değişken uzunluklu yollar
Explore UI yol oluşturucu, değişken uzunlukta desenler için sekiz atlamaya kadar destek sağlar. Bu kullanıcı arayüzü sınırı, kod düzenleyiciye girilen GQL sorguları için geçerli değildir.
Graph, ve ANY SHORTEST yol arama öneklerini desteklerALL.
ALL SHORTEST ve ANY desteklenmez.
Aşağıdaki tablo değişken uzunluklu GQL desteğini özetlemektedir:
| Yol arama ve yol modu | Sabit veya sınırlı nicelikçi | Sınırsız niceleyici |
|---|---|---|
ALL WALK (varsayılan) |
Destekleniyor | Desteklenmiyor çünkü tekrarlanan elemanlar sonsuz sayıda yol üretebiliyor. |
ALL TRAIL, ALL SIMPLE veya ALL ACYCLIC |
Destekleniyor | Destekleniyor, ancak yol sayısı hâlâ büyük olabilir. |
ANY SHORTEST WALK |
Destekleniyor | İki düğüm arasında anonim bir nicelenmiş kenar ile basit uç nokta erişilebilirliği için desteklenir. Bu sınırsız biçimle sınırlı bir yol yalnızca ve PATH_LENGTH(path) yanında, path IS NULL; tam yol maddileşmez olarak kullanılabilir.
Bkz. Sınırsız değişken uzunluklu desenler. |
ANY SHORTEST TRAIL, ANY SHORTEST SIMPLE veya ANY SHORTEST ACYCLIC |
Destekleniyor | Supported. |
Sabit ve sınırlı niceleyiciler {n}, {m,n}, ve {,n}'dir. Sınırsız niceleyiciler {m,}, *, ve +. Daha fazla bilgi için GQL grafik desenlerine bakınız.
Yol önlem yerleşimi
GQL, uygun yolları kısıtlayan önlemleri, bir yol arama öneki onları seçtikten sonra yolları filtreleyen önlemlerden ayırır. Bazı ANY SHORTEST sorgu şekilleri için, Graph şu anda yol seçiminden önce ifade düzeyinde MATCH ... WHERE bir koşul uygulayabilir.
Amaçlanan aşamayı net kılmak için, uygunluk öncüllerini düğüm veya kenar desenlerinde diline yerleştirin. Seçim sonrası filtreleme için, sonra ayrı FILTER bir ifade kullanın MATCH. Örneğin, yol seçiminden önce veya sonra Place predicate'lerine bakınız.
List predicate filtreleri
List predicate filtreleri şu anda şunları desteklemiyor:
-
EXISTSAlt sorgular. - Yerel olarak bağlı eleman üzerinde toplam fonksiyonlar. Çevreleyen grup listesi üzerinde yatay toplama desteklenir.
Desteklenen sözdizimi ve sonuç semantiği için bkz. Belirti fonksiyonlarını listele.
Sonuçların boyutu
Graph, iç ikili temsili 64 MB'yi aştığında sorgu yanıtını kestirir. Graph, uyan satırları döndürür ve ek bir uyarı bildirir ve kamu durum kodu 01000 ile kanonik GQLSTATUS 01M11ile bildirir. Ara sonuçlar 128 MB ile sınırlandırılmıştır.
Yanıt, kesme nedeniyle çıkarılan satırlar için bir devam belirteci içermiyor. Sonucu filtreler, belirli projeksiyonlar veya LIMITile daraltın ve sorguyu tekrar çalıştırın.
Zaman Aşımı
Sorgu API'si yürütme toplam zaman aşımına sahiptir, devam talepleri dahil. Yürütme bu sınırı aşarsa, API hata kodu QueryTimeoutile HTTP 408 döner.
Subqueries
CALL, OPTIONAL CALL, ve prosedür formu EXISTS alt sorguları desteklenir.
Hat CALL içi alt sorgular iç içe geçirilebilir ve örtük olarak değişkenleri kapalı kapsamlardan itebilir. Adlandırılmış prosedür çağrıları, yalnızca grafik desenleri EXISTSgibi açık değişken içe aktarma listeleri CALL (p) { ... }ve skaler alt sorgular (VALUE { ... }) desteklenmez.
Toplama işlevleri
Aşağıdaki toplama işlevleri desteklenir:
-
COUNT,COUNT(*),SUM,AVG,MINveMAX -
COLLECT_LIST,COLLECT_ONEveCOLLECT_ELEMENTS -
DISTINCTönceki tüm fonksiyonların varyantları - Yukarıdakilerin yatay (satır bazında, grup değişkenleri/listeleri üzeri) varyantları
Aşağıdaki toplama fonksiyonları henüz desteklenmemektedir:
-
PERCENTILE_CONTvePERCENTILE_DISC -
STDDEV_POPveSTDDEV_SAMP PRODUCT
İşlemleri ayarlama
UNION ALL ve UNION DISTINCT desteklenir.
INTERSECT, EXCEPT, ve OTHERWISE henüz desteklenmiyor.
Desteklenen GQL ifadeleri ve maddeleri
Aşağıdaki temel GQL ifadeleri ve maddeleri desteklenmektedir:
-
MATCHveOPTIONAL MATCH -
WHEREFiltreler -
LETdeğişken bağlamalar -
FOR ... INisteğeORDINALITYbağlı indeksleme ile liste açılması -
NEXT, , veya içerenUNIONUNION DISTINCTsorgu aşamaları da dahil olmak üzereUNION ALL -
RETURNveRETURN DISTINCT GROUP BY-
ORDER BYileNULLS FIRSTveyaNULLS LAST -
LIMITveOFFSET -
UNION ALLveUNION DISTINCT -
CALL,OPTIONAL CALLveEXISTS -
CASTgeniş bir tip dönüşüm matrisi ile - GQL ifadeleri, önlemleri ve fonksiyonlarında listelenen skaler ve agregat fonksiyonları desteklendi
DML ve DDL operasyonları
Veri İşleme Dili (DML) işlemleri, , INSERTUPDATEve DELETE GQL aracılığıyla desteklenmez. Şema mutasyonu için Veri Tanım Dili (DDL) işlemleri desteklenmemektedir.
Veri dışarı aktarma ve görselleştirme
Graf sorgu sonuçlarını veya grafik yapılarını dışarı aktarma şu anda desteklenmiyor.
Görselleştirme senaryoları için Power BI doğrudan bir grafiğe bağlanma şu anda desteklenmemektedir.
GQL uyumluluğu
Desteklenen GQL özelliklerinin ISO/IEC 39075:2024 standardına (minimum uyumluluk, gruba göre isteğe bağlı özellikler ve henüz desteklenmeyen özellikler dahil) ayrıntılı eşlemesi için bkz. GQL standart uyumluluğu.
Aşağıdaki özellikler için GQL standartlarına uyum devam etmektedir.
Kontrol akışı ve set işlemleri
-
EXCEPT ALLveEXCEPT DISTINCTdeyimleri -
INTERSECT ALLveINTERSECT DISTINCTdeyimleri -
OTHERWISEaçıklama
Yol arama ve desen eşleştirme
-
ALL SHORTESTYol Arama (desteklenmiyor) -
ANYYol Arama - Konumsal olmayan desen önkoşulları
- Gevşek topolojik tutarlılık
- Joker karakterler
Predicates
- Etiket testi önlemi (
IS LABELED) -
IS DIRECTEDpredikat - Normalleştirilmiş koşul
- Kaynak/hedef koşulu
-
ALL_DIFFERENTpredikat -
IS DISTINCTpredikat -
SAMEpredikat -
REGEXP_CONTAINSpredikat
Desteklenen çalışma zamanı değer türleri
| Çalışma zamanı değer tipi | Temsil/Aralık | Limit |
|---|---|---|
BOOLEAN |
true ve false |
|
INT (veya INT64) |
İmzalı 64 bit tamsayı | |
UINT (veya UINT64) |
İşaretsiz 64 bit tamsayı | |
DOUBLE (veya FLOAT64) |
IEEE-754 binary64 |
Sonlu olmayan bir kontrol yoktur; sonsuz değerler kabul edilir |
STRING |
Unicode dizesi | 65.534 bayt (uint16 disk içi uzunluk) |
ZONED DATETIME |
Unix epoch'undan bu yana milisaniyeler artı int32 UTC ofset | int64 milisaniye aralığı |
DURATION(DAY TO SECOND) |
Milisaniye hassasiyeti | |
NODE |
uint64 raw | |
EDGE |
uint64 raw | |
LIST |
Homojen tipli liste | 65.534 eleman (uint16 disk içi uzunluk) |
RECORD |
Tiplenen alanların yapısı | |
PATH |
Her zaman bir düğüm ile başlayan ve biten dönüşümlü düğüm ve kenar listesi | 65.534 eleman (uint16 disk içi uzunluk) |
Henüz desteklenmeyen çalışma zamanı değer türleri
-
INT8,INT16, veINT32değer türleri (INT64desteklenir) -
FLOAT16veFLOAT32değer türleri (FLOAT64desteklenir) -
UINT8,UINT16, veUINT32değer türleri (UINT64desteklenir) -
ZONED TIMEDeğer türü -
DATEdeğer tipi bağımsız bir tip olarak kullanılır. Alınan tarihler, Bölgeli Tarih Saati ile eşleştirilir. -
LOCAL DATETIMEDeğer türü -
LOCAL TIMEDeğer türü -
DURATION(YEAR TO MONTH)Değer türü -
BYTESdeğer türü. Alım destekleniyor, ancak tür saklanan bir özellik olarak sorgulanabilir. -
VECTORDeğer türü
Fonksiyonlar ve ifadeler
-
PROPERTIESfonksiyon -
NORMALIZEveNFKCNFKDile -
DURATION_BETWEENfonksiyon - Aranan
CASE WHENifadeler - Skaler alt sorgular
- Yol değeri birleştirme
- Bayt dize bağlaması,
TRIM, ve uzunluk fonksiyonları - Spesifikasyonlu
TRIMbasitTRIMfonksiyon - Çok karakterli
TRIMfonksiyon CARDINALITY
Aggregation
-
PERCENTILE_CONTtoplama işlevi -
PERCENTILE_DISCtoplama işlevi -
PRODUCTtoplama işlevi -
STDDEV_POPtoplama işlevi -
STDDEV_SAMPtoplama işlevi
Other
- Parametre iletimi (
$paramdinamik parametre spesifikasyonu) - Oturum kullanıcısı (
SESSION_USER) -
CALLIsimlendirilmiş prosedür ifadesi -
CALLAçık değişken içe aktarma listelerine sahip alt sorgular - Katalog yönetimi. Grafik ve kısıtlama isimleri otomatik olarak oluşturulur.
Catalog
Note
Grafik isimleri ve kısıtlama isimleri otomatik olarak oluşturulur ve arayüzde veya JSON şemasında belirtilemez.
| Katalog alanı | Akım sınırı / davranışı | Recommendation |
|---|---|---|
| Grafik şeması | Her katalog için bir grafik türü. | |
| Grafik adı | Boş olmamalıdır; açık bir maksimum uzunluk yok. | 127 karakter |
| Düğüm türleri | Maksimum yaklaşık 2 milyar (int32 ID alanı). | 64K |
| Kenar türleri | Maksimum yaklaşık 2 milyar (int32 ID alanı). | 64K |
| Benzersiz düğüm etiketleri | En fazla yaklaşık 2 milyar; bir tür içindeki kopyalar reddedilir. | Düğüm tiplerinden türetilmiştir |
| Benzersiz kenar etiketleri | En fazla yaklaşık 2 milyar; bir tür içindeki kopyalar reddedilir. | Kenar tiplerinden türetilmiştir |
| Benzersiz mülk isimleri | En fazla yaklaşık 2 milyar; bir tür içindeki boş isimler ve kopyalar reddedilir. | 64K x 10 |
| Düğüm tipine göre özellikler | Açık bir maksimum yoktur; çoğaltılmış özellik isimleri reddedilir. | 256 |
| Kenar türüne göre özellikler | Açık bir maksimum yoktur; çoğaltılmış özellik isimleri reddedilir. | 256 |
| Düğüm tipine göre etiketler | Açık bir maksimum yok; tekrarlanan etiketler reddedilir. | 64 |
| Kenar türüne göre etiketler | Açık bir maksimum yok; tekrarlanan etiketler reddedilir. | 64 |
| Kısıtlama başına anahtar özellikler | Açık maksimum yok; mülk isimleri boş olmamalıdır. | 16 |
| Mülk adı uzunluğu | Boş olmayan ötede açıkça uygulanmıyor. | 127 karakter |
| Etiket adı uzunluğu | Boş olmayan ötede açıkça uygulanmıyor. | 127 karakter |
| Kenar anahtarı kısıtlamaları | Varsayılan olarak devre dışı (allow_edge_key_constraints bayrak). |
≤ kenar türlerinin sayısı |