Microsoft Fabric 中圖形的現行限制

Microsoft Fabric 中的圖形有某些功能限制。 本文強調了一些關鍵限制，但並非完整清單。 請定期回來查看最新消息。

如需常見問題的協助，請參閱 故障排除圖表。

建立圖形模型

數據源

OneLake 和 Mirrored Databases 是圖形支援的資料來源。

數據類型

圖模型支援以下屬性值類型。

GQL 值型別 Description
BOOLEAN 值為 true 和 false。
INT (或 INT64) 值為 64 位元有號整數。
DOUBLE (或 FLOAT64) 數值為 64 位元 IEEE-754 浮點數。
FLOAT (或 FLOAT32) 數值為 32 位元浮點數。
STRING 數值為 UTF-8 編碼的 Unicode 字串。 最大屬性大小為 65,535 位元組。
ZONED DATETIME 數值是時間戳加上時區偏移，精度為毫秒級。

以下 OneLake 與 Delta Lake 欄位類型支援匯入圖表。

OneLake 類型 映射到 GQL 屬性值類型
BooleanType BOOLEAN
ByteType INT (或 INT64)
IntegerType INT (或 INT64)
LongType INT (或 INT64)
FloatType DOUBLE (或 FLOAT64)
DoubleType DOUBLE (或 FLOAT64)
StringType STRING
DateType ZONED DATETIME
TimestampType ZONED DATETIME
TimestampNtzType ZONED DATETIME

Note

複雜或巢狀的三角洲湖類型（MapType 和 StructType）不被支援。 你可以在查詢時用 PARSE_JSON_STRING。

圖處理與尺度

圖載入與刷新操作可能需要延長處理時間，視圖大小、圖元素（節點與邊）數量，以及與這些元素相關的屬性有效載荷大小而定。 大型圖表可能需要數小時處理。 若圖表載入或刷新操作在 24 小時內仍未完成，請 提交支援請求 以進一步調查。

目前的圖處理能力支援包含約 20 億個圖形元素（節點與邊）的圖。 有效容量可能因圖表結構及屬性有效載荷大小而異。 如果您的工作量預期會超過這些限制，請聯絡 Microsoft 支援服務 尋求指導。

分割欄位

三角洲湖分割欄位作為圖屬性的支援有限：

  • 唯一作為主鍵的分割欄總是被拒絕。
  • 不支援產生的分割區欄位。
  • 複雜且十進位的分割欄位類型（Decimal， ， BinaryArray， Map， Struct， 和 ）會被刪除並附帶警告。

結構變更

架構變更會觸發圖的重新載入。

查詢

可變長度路徑

Explore UI 路徑建構器支援最多八跳的可變長度模式。 此使用者介面限制不適用於在程式碼編輯器中輸入的 GQL 查詢。

Graph 支援 ALL 和 ANY SHORTEST 路徑搜尋前綴。 不支援ALL SHORTEST 和 ANY 。

下表總結了可變長度的 GQL 支援：

路徑搜尋與路徑模式 固定量詞或有界量詞 無界量詞
ALL WALK (預設值) Supported 不支援，因為重複元素可能產生無限多條路徑。
ALL TRAIL、 ALL SIMPLE或 ALL ACYCLIC Supported 雖然有支援，但路徑數量仍然可能很大。
ANY SHORTEST WALK Supported 支援簡單的端點可達性，兩個節點間有一個匿名量化邊。 由此無界形式所界定的路徑只能與 PATH_LENGTH(path) 且 並行 path IS NULL使用;完整路徑不會被具體化。 參見 無界可變長度模式。
ANY SHORTEST TRAIL、 ANY SHORTEST SIMPLE或 ANY SHORTEST ACYCLIC Supported 支援。

固定量詞與有界量詞分別為 {n}、 {m,n}、 {,n}和 。 無界量詞為 {m,}、 、 *+和 。 欲了解更多資訊，請參閱 GQL 圖形模式。

路徑謂詞的擺放

GQL 區分約束合格路徑的謂詞與在路徑搜尋前綴選擇路徑後過濾路徑的謂詞。 對於某些 ANY SHORTEST 查詢形狀，Graph 目前可以在路徑選擇前套用語句層 MATCH ... WHERE 級條件。

為了明確化預期階段，將資格謂詞置於節點或邊的模式中。 對於後選篩選，請在 後使用獨立FILTER的陳述句。MATCH 例如，請參見「 路徑選擇前或後置謂詞」。

列表謂詞過濾器

列表謂詞篩選器目前不支援：

  • EXISTS 子查詢。
  • 聚合函數對局部束縛元素。 支援在包圍群組列表上的水平聚合。

關於支援的語法與結果語意，請參見 List 謂詞函數。

結果大小

當查詢回應的內部二進位表示超過 64 MB 時，圖會截斷其回應。 Graph 會回傳符合的列，並回報帶有公開狀態代碼 01000 及典型 GQLSTATUS 01M11的額外警告。 中級結果限制為 128 MB。

回應中沒有包含因截斷而遺漏的列的續寫令牌。 用篩選條件、特定投影 LIMIT或 來縮小結果範圍，然後再執行一次查詢。

暫停

查詢 API 執行總逾時時間為 20 分鐘，包含持續請求。 若執行超過此限制，API 會回傳帶有錯誤碼 QueryTimeout的 HTTP 408 。

Subqueries

CALL OPTIONAL CALL支援程序形式EXISTS子查詢。 內嵌 CALL 子查詢可以巢狀，並隱含地從包圍作用域匯入變數。 不支援命名的程序呼叫、明確的變數匯入清單（如 CALL (p) { ... }、 僅圖 EXISTS模式 、 以及純量子查詢VALUE { ... }）。

彙總函數

支援下列聚合函數：

  • COUNT、COUNT(*)、SUM、AVG、MIN 和 MAX
  • COLLECT_LIST、COLLECT_ONE 和 COLLECT_ELEMENTS
  • DISTINCT 上述所有函數的變體
  • 上述所有變體的水平（列、群組變數/列表）變體

以下聚合函數尚未支援：

  • PERCENTILE_CONT 與 PERCENTILE_DISC
  • STDDEV_POP 與 STDDEV_SAMP
  • PRODUCT

設定作業

支援 UNION ALL 和 UNION DISTINCT。 INTERSECT， EXCEPT， 尚未 OTHERWISE 獲得支援。

支援的 GQL 語句與條款

以下核心 GQL 語句與條款皆為支援：

  • MATCH 與 OPTIONAL MATCH
  • WHERE 濾波器
  • LET 變數綁定
  • FOR ... IN 列表展開及可選 ORDINALITY 索引
  • NEXT，包含包含 UNION、 UNION DISTINCT或 的查詢階段 UNION ALL
  • RETURN 與 RETURN DISTINCT
  • GROUP BY
  • ORDER BY 搭配 NULLS FIRST 或 NULLS LAST
  • LIMIT 與 OFFSET
  • UNION ALL 與 UNION DISTINCT
  • CALL、OPTIONAL CALL 和 EXISTS
  • CAST 具有廣義型態轉換矩陣
  • GQL 表達式、謂詞與函數中列出的標量與聚合函數

DML 與 DDL 營運

資料操作語言（DML）如 、 UPDATE、 DELETE 等操作INSERT不支援 GQL。 不支援用於結構變異的資料定義語言（DDL）操作。

資料匯出與視覺化

目前不支援匯出圖查詢結果或圖結構。

目前不支援直接將 Power BI 連接到圖形以進行視覺化情境。

GQL 一致性

如需詳細對應 GQL 特徵與 ISO/IEC 39075：2024 標準的對應，包括最低符合性、按群組分類的可選功能，以及尚未支援的功能，請參見 GQL 標準符合性。

以下功能仍在進行符合 GQL 標準的過程中。

控制流程與集合操作

  • EXCEPT ALL 和 EXCEPT DISTINCT 語句
  • INTERSECT ALL 和 INTERSECT DISTINCT 語句
  • OTHERWISE 陳述

路徑搜尋與模式匹配

  • ALL SHORTEST 路徑搜尋（不支援）
  • ANY 路徑搜尋
  • 非局域模式謂詞
  • 寬鬆的拓撲一致性
  • 通配符

Predicates

  • 標籤測試謂詞（IS LABELED）
  • IS DIRECTED 述詞
  • 正規化述詞
  • 來源/目的地述詞
  • ALL_DIFFERENT 述詞
  • IS DISTINCT 述詞
  • SAME 述詞
  • REGEXP_CONTAINS 述詞

支援的執行時值類型

執行時值類型 表示/範圍 Limit
BOOLEAN true 與 false
INT (或 INT64) 帶正負號的64位整數
UINT (或 UINT64) 不帶正負號的64位整數
DOUBLE (或 FLOAT64) IEEE-754 binary64 不允許有限檢查;非有限值被接受
STRING Unicode 字串 65,534 位元組（uint16 磁碟長度）
ZONED DATETIME 自 Unix 時代起的毫秒加上 int32 UTC 偏移 INT64毫秒範圍
DURATION(DAY TO SECOND) 毫秒精度
NODE UINT64 原始版
EDGE UINT64 原始版
LIST 同質型別列表 65,534 個元素（uint16 於磁碟長度）
RECORD 類型欄位的結構
PATH 交替排列的節點與邊列表，始終以節點開始和結束 65,534 個元素（uint16 於磁碟長度）

尚未支援的執行時值類型

  • INT8、 INT16，以及 INT32 值型別（INT64 支援）
  • FLOAT16 以及 FLOAT32 值型別（FLOAT64 支援）
  • UINT8、 UINT16，以及 UINT32 值型別（UINT64 支援）
  • ZONED TIME 價值類型
  • DATE 值型別作為獨立型別。 輸入的日期會對應到分區日期時間。
  • LOCAL DATETIME 價值類型
  • LOCAL TIME 價值類型
  • DURATION(YEAR TO MONTH) 價值類型
  • BYTES 價值類型。 支援擷取，但該型別無法作為儲存屬性查詢。
  • VECTOR 價值類型

函數與表達式

  • PROPERTIES 函數
  • NORMALIZE 其中 和 NFKCNFKD 形式
  • DURATION_BETWEEN 函數
  • 搜尋表達 CASE WHEN 式
  • 純量子查詢
  • 路徑值串連
  • 位元組串接 TRIM、 、 與長度函數
  • 帶有TRIM規範的簡單TRIM函數
  • 多字元 TRIM 功能
  • CARDINALITY

Aggregation

  • PERCENTILE_CONT 聚合函數
  • PERCENTILE_DISC 聚合函數
  • PRODUCT 聚合函數
  • STDDEV_POP 聚合函數
  • STDDEV_SAMP 聚合函數

Other

  • 參數傳遞（$param 動態參數規範）
  • 會話使用者（SESSION_USERSession user）
  • CALL 命名程序語句
  • CALL 具有明確變數匯入清單的子查詢
  • 目錄管理。 圖名與約束名稱會自動產生。

Catalog

Note

圖名和限制名稱是自動產生的，無法在 UI 或 JSON 架構中指定。

目錄區域 電流極限/行為 Recommendation
圖形結構描述 每個目錄只有一種圖形類型。
圖名稱 必須非空;沒有明確的最大長度。 127 個字元
節點類型 最大約 20 億（int32 ID 空間）。 64K
邊型 最大約 20 億（int32 ID 空間）。 64K
唯一節點標籤 最多約20億個;同一類型內的重複品會被拒絕。 源自節點類型
唯一邊標籤 最多約20億個;同一類型內的重複品會被拒絕。 由邊型推導
獨特的房產名稱 最多約20億個;同一類型內的空名與重複名稱會被拒絕。 64K x 10
各節點類型的屬性 沒有明確的上限;重複的屬性名稱會被拒絕。 256
各邊類型的性質 沒有明確的上限;重複的屬性名稱會被拒絕。 256
各節點類型的標籤 沒有明確的上限;重複標籤會被拒絕。 64
每邊類型的標籤 沒有明確的上限;重複標籤會被拒絕。 64
每個約束的關鍵屬性 沒有明確的最大值;屬性名稱必須非空。 16
物業名稱長度 沒有明確執行超過非空的範圍。 127 個字元
標籤名稱長度 沒有明確執行超過非空的範圍。 127 個字元
邊鍵限制 預設為停用（allow_edge_key_constraints 旗標）。 ≤ 邊型的數量

相關內容

  • 上次更新時間：