Batasan grafik saat ini dalam Microsoft Fabric

Grafik di Microsoft Fabric memiliki keterbatasan fungsional tertentu. Artikel ini menyoroti beberapa batasan utama tetapi bukan daftar lengkap. Periksa kembali secara teratur untuk pembaruan.

Untuk bantuan terkait masalah umum, lihat Grafik pemecahan masalah.

Membuat model grafik

Sumber data

OneLake dan Mirrored Database adalah sumber data yang didukung untuk grafik.

Jenis data

Model grafik mendukung tipe nilai properti berikut.

Tipe nilai GQL	Deskripsi
`BOOLEAN`	Nilai adalah `true` dan `false`.
`INT` (atau `INT64`)	Nilainya adalah bilangan bulat bertanda 64-bit.
`DOUBLE` (atau `FLOAT64`)	Nilainya adalah angka floating point IEEE-754 64-bit.
`FLOAT` (atau `FLOAT32`)	Nilainya adalah angka floating point 32-bit.
`STRING`	Nilainya adalah string karakter Unicode yang dikodekan UTF-8. Ukuran properti maksimum adalah 65.535 byte.
`ZONED DATETIME`	Nilai adalah timestamp bersama dengan offset zona waktu, dengan presisi milidetik.

Jenis kolom OneLake dan Delta Lake berikut didukung untuk dimasukkan ke dalam grafik.

Tipe OneLake	Memetakan ke tipe nilai properti GQL
`BooleanType`	`BOOLEAN`
`ByteType`	`INT` (atau `INT64`)
`IntegerType`	`INT` (atau `INT64`)
`LongType`	`INT` (atau `INT64`)
`FloatType`	`DOUBLE` (atau `FLOAT64`)
`DoubleType`	`DOUBLE` (atau `FLOAT64`)
`StringType`	`STRING`
`DateType`	`ZONED DATETIME`
`TimestampType`	`ZONED DATETIME`
`TimestampNtzType`	`ZONED DATETIME`

Note

Tipe Delta Lake yang kompleks atau bersarang (MapType dan StructType) tidak didukung. Anda dapat mengurai kolom string yang dikodekan JSON saat kueri dengan menggunakan PARSE_JSON_STRING.

Pemrosesan graf dan skala

Operasi pemuatan dan penyegaran graf mungkin memerlukan waktu pemrosesan yang diperpanjang tergantung pada ukuran graf, jumlah elemen graf (node dan edge), serta ukuran payload properti yang terkait dengan elemen-elemen tersebut. Grafik besar mungkin memakan waktu beberapa jam untuk diproses. Jika operasi pemuatan atau penyegaran grafik belum selesai setelah 24 jam, ajukan permintaan dukungan untuk investigasi lebih lanjut.

Kemampuan pemrosesan graf saat ini mendukung graf yang berisi hingga sekitar 2 miliar elemen graf (node dan edge). Kapasitas efektif dapat bervariasi berdasarkan struktur grafik dan ukuran muatan properti. Jika beban kerja Anda diperkirakan melebihi batas ini, hubungi Microsoft Support untuk panduan.

Kolom partisi

Kolom partisi Delta Lake memiliki dukungan terbatas sebagai properti grafik:

Kolom partisi yang digunakan sebagai satu-satunya kunci utama selalu ditolak.
Kolom partisi yang dihasilkan tidak didukung.
Jenis kolom partisi kompleks dan desimal (Decimal, Binary, Array, Map, dan Struct) dihapus dengan peringatan.

Perubahan skema

Perubahan skema memicu pemuatan ulang grafik.

Mengajukan Permintaan

Jalur panjang variabel

Pembangun jalur Explore UI mendukung hingga delapan hop untuk pola panjang variabel. Batas antarmuka pengguna ini tidak berlaku untuk kueri GQL yang dimasukkan di editor kode.

Grafik mendukung ALL awalan pencarian jalur dan ANY SHORTEST (path search). ALL SHORTEST dan ANY tidak didukung.

Tabel berikut merangkum dukungan GQL dengan panjang variabel:

Pencarian jalur dan mode jalur	Kuantor tetap atau terbatas	Kuantor tak terbatas
`ALL WALK` (standar)	Dukungan	Tidak didukung karena elemen yang diulang dapat menghasilkan jalur yang tak terhingga.
`ALL TRAIL`, `ALL SIMPLE`, atau `ALL ACYCLIC`	Dukungan	Didukung, tapi jumlah jalur tetap bisa besar.
`ANY SHORTEST WALK`	Dukungan	Didukung untuk jangkauan endpoint yang sederhana dengan satu edge kuantifikasi anonim antara dua node. Jalur yang dibatasi oleh bentuk tak terbatas ini hanya dapat digunakan dengan `PATH_LENGTH(path)` dan, di sampingnya, `path IS NULL`; jalur lengkap tidak termaterialisasi. Lihat Pola panjang variabel tak terbatas.
`ANY SHORTEST TRAIL`, `ANY SHORTEST SIMPLE`, atau `ANY SHORTEST ACYCLIC`	Dukungan	Supported.

Kuantor tetap dan terbatas adalah {n}, {m,n}, dan {,n}. Kuantor tak terbatas adalah {m,}, *, dan +. Untuk informasi lebih lanjut, lihat pola grafik GQL.

Penempatan predikat jalur

GQL membedakan predikat yang membatasi jalur yang memenuhi syarat dari predikat yang memfilter jalur setelah awalan pencarian jalur memilihnya. Untuk beberapa ANY SHORTEST bentuk kueri, Graph saat ini dapat menerapkan kondisi tingkat MATCH ... WHERE pernyataan sebelum pemilihan jalur.

Untuk membuat tahap yang dimaksud menjadi eksplisit, tempatkan predikat kelayakan secara inline dalam pola node atau tepi. Untuk penyaringan pasca-seleksi, gunakan pernyataan terpisah FILTER setelah MATCH. Sebagai contoh, lihat Tempatkan predikat sebelum atau sesudah pemilihan jalur.

Filter daftar predikat

Filter predikat daftar saat ini tidak mendukung:

EXISTS subquery.
Fungsi agregat di atas elemen yang terikat secara lokal. Agregasi horizontal di atas daftar grup yang tertutup didukung.

Untuk sintaks yang didukung dan semantik hasil, lihat Daftar fungsi predikat.

Ukuran hasil

Grafik memotong respons kueri ketika representasi biner internalnya melebihi 64 MB. Grafik mengembalikan baris yang sesuai dan melaporkan peringatan tambahan dengan kode 01000 status publik dan GQLSTATUS 01M11kanonik. Hasil intermediate dibatasi hingga 128 MB.

Respons tidak menyertakan token kelanjutan untuk baris yang dihilangkan karena pemotongan. Persempit hasil dengan filter, proyeksi spesifik, atau LIMIT, lalu jalankan kueri lagi.

Jeda Waktu

Eksekusi Query API memiliki total waktu habis selama 20 menit, termasuk permintaan kelanjutan. Jika eksekusi melebihi batas ini, API mengembalikan HTTP 408 dengan kode QueryTimeouterror .

Subqueries

CALL, OPTIONAL CALL, dan subkueri bentuk EXISTS prosedur didukung. Subquery inline CALL dapat disusun dan secara implisit mengimpor variabel dari cakupan yang melampirkan. Pemanggilan prosedur bernama, daftar impor variabel eksplisit seperti CALL (p) { ... }, graph-pattern-only EXISTS, dan subquery skalar (VALUE { ... }) tidak didukung.

Fungsi agregasi

Fungsi agregasi berikut didukung:

COUNT, COUNT(*), SUM, AVG, MIN, dan MAX
COLLECT_LIST, COLLECT_ONE, dan COLLECT_ELEMENTS
DISTINCT varian dari semua fungsi sebelumnya
Varian horizontal (baris demi baris, di atas variabel/daftar grup) dari semua hal di atas

Fungsi agregasi berikut belum didukung:

PERCENTILE_CONT dan PERCENTILE_DISC
STDDEV_POP dan STDDEV_SAMP
PRODUCT

Mengatur operasi

UNION ALL dan UNION DISTINCT didukung. INTERSECT, EXCEPT, dan OTHERWISE belum didukung.

Pernyataan dan klausa GQL yang didukung

Pernyataan dan klausul inti GQL berikut didukung:

MATCH dan OPTIONAL MATCH
WHERE filter
LET ikatan variabel
FOR ... INMembuka daftar dengan pengindeksan opsional ORDINALITY
NEXT, termasuk tahapan kueri yang mengandung UNION, UNION DISTINCT, atau UNION ALL
RETURN dan RETURN DISTINCT
GROUP BY
ORDER BY dengan NULLS FIRST atau NULLS LAST
LIMIT dan OFFSET
UNION ALL dan UNION DISTINCT
CALL, OPTIONAL CALL, dan EXISTS
CAST dengan matriks konversi tipe yang luas
Fungsi skalar dan agregat yang didukung tercantum dalam ekspresi, predikat, dan fungsi GQL

Operasi DML dan DDL

Operasi Data Manipulation Language (DML) seperti INSERT, UPDATE, dan DELETE tidak didukung melalui GQL. Operasi Data Definition Language (DDL) untuk mutasi skema tidak didukung.

Ekspor dan visualisasi data

Mengekspor hasil kueri grafik atau struktur grafik saat ini tidak didukung.

Menyambungkan Power BI langsung ke grafik untuk skenario visualisasi saat ini tidak didukung.

Kesuaian GQL

Untuk pemetaan terperinci fitur GQL yang didukung terhadap standar ISO/IEC 39075:2024, termasuk kesesuaian minimum, fitur opsional menurut grup, dan fitur yang belum didukung, lihat Kesesuaian standar GQL.

Kesesuaian dengan standar GQL masih berlangsung untuk fitur-fitur berikut.

Operasi alur kontrol dan set

EXCEPT ALL dan EXCEPT DISTINCT pernyataan
INTERSECT ALL dan INTERSECT DISTINCT pernyataan
OTHERWISE pernyataan

Pencarian jalur dan pencocokan pola

ALL SHORTEST pencarian jalur (tidak didukung)
ANY pencarian jalur
Predikat pola nonlokal
Konsistensi topologis yang dilonggarkan
Karakter pengganti

Predicates

Predikat uji label (IS LABELED)
predikat IS DIRECTED
Predikat yang dinormalisasi
Predikat sumber/tujuan
predikat ALL_DIFFERENT
predikat IS DISTINCT
predikat SAME
predikat REGEXP_CONTAINS

Jenis nilai runtime yang didukung

Jenis nilai runtime	Representasi/rentang	Limit
`BOOLEAN`	`true` dan `false`
`INT` (atau `INT64`)	Bilangan bulat 64-bit yang ditandatangani
`UINT` (atau `UINT64`)	Bilangan bulat 64-bit yang tidak ditandatangani
`DOUBLE` (atau `FLOAT64`)	IEEE-754 `binary64`	Tidak ada pemeriksaan hanya hingga; nilai tidak terbatas diterima
`STRING`	String Unicode	65.534 byte (panjang di disk uint16)
`ZONED DATETIME`	Milidetik sejak epoch Unix ditambah offset int32 UTC	Rentang int64 milidetik
`DURATION(DAY TO SECOND)`	Presisi milidetik
`NODE`		uint64 raw
`EDGE`		uint64 raw
`LIST`	Daftar bertipe homogen	65.534 elemen (panjang di disk uint16)
`RECORD`	Struktur bidang yang diketik
`PATH`	Daftar node dan edge bergantian yang selalu dimulai dan diakhiri dengan node	65.534 elemen (panjang di disk uint16)

Jenis nilai runtime belum didukung

INT8, INT16, dan tipe INT32 nilai (INT64 didukung)
FLOAT16 dan FLOAT32 tipe nilai (FLOAT64 didukung)
UINT8, UINT16, dan tipe UINT32 nilai (UINT64 didukung)
ZONED TIME jenis nilai
DATE Tipe nilai sebagai tipe mandiri. Tanggal yang dimasukkan dipetakan ke Tanggal Waktu yang Dizonasi.
LOCAL DATETIME jenis nilai
LOCAL TIME jenis nilai
DURATION(YEAR TO MONTH) jenis nilai
BYTES Tipe nilai. Ingestion didukung, tetapi tipe ini tidak dapat dikueri sebagai properti tersimpan.
VECTOR jenis nilai

Fungsi dan ekspresi

fungsi PROPERTIES
NORMALIZEdengan bentuk dan NFKCNFKD
fungsi DURATION_BETWEEN
Ekspresi yang dicari CASE WHEN
Subkueri skalar
Perangkaian nilai jalur
Fungsi penggabungan string byte, TRIM, dan panjang
Fungsi sederhana TRIM dengan TRIM spesifikasi
Fungsi multikarakter TRIM
CARDINALITY

Aggregation

PERCENTILE_CONTFungsi agregasi
PERCENTILE_DISCFungsi agregasi
PRODUCTFungsi agregasi
STDDEV_POPFungsi agregasi
STDDEV_SAMPFungsi agregasi

Other

Passing parameter ($param spesifikasi parameter dinamis)
Pengguna sesi (SESSION_USER)
CALL pernyataan prosedur bernama
CALL subkueri dengan daftar impor variabel eksplisit
Manajemen katalog. Nama grafik dan kendala akan dihasilkan secara otomatis.

Catalog