Azure Cosmos DB (預覽版) 中的 Microsoft Fabric 鏡像資料庫的限制

本文詳細介紹鏡像至 Microsoft Fabric 的 Azure Cosmos DB 帳戶目前的限制。 此頁面中的限制和配額詳細資料未來可能會變更。

可用性

Fabric 的一組特定區域和 Azure Cosmos DB 的一組特定 API 可支援鏡像。

支援的 API

鏡像僅適用於此處所列的 Azure Cosmos DB 帳戶類型。

支援的區域

以下是支援鏡像的網狀架構區域：

帳戶和資料庫限制

• 只有當 Azure Cosmos DB 帳戶設定為 7 天或 30 天連續備份時，您才能啟用鏡像。
• Azure Cosmos DB 中連續備份功能的所有目前限制也適用於 Fabric 鏡像。
  • 這些限制包括但不限於啟用后無法停用連續備份，且不支援多區域寫入帳戶。 如需詳細資訊，請參閱 Azure Cosmos DB 連續備份限制。
  • 您可以在相同的 Azure Cosmos DB 帳戶上同時啟用分析存放區和連續備份功能。
• 您無法在已啟用連續備份的 Azure Cosmos DB 帳戶上停用分析存放區功能。
• 您無法在先前已停用容器分析存放區功能的 Azure Cosmos DB 帳戶上啟用連續備份。

安全性限制

• Azure Cosmos DB 讀寫帳戶金鑰是唯一支援的連線來源帳戶的機制。 不支援唯讀帳戶金鑰、受控識別和使用角色型存取控制的無密碼驗證。
• 如果輪替帳戶金鑰，您必須更新 Fabric 鏡像的連線認證。 如果未更新金鑰，則鏡像會失敗。 若要解決此失敗，請停止複寫，以新輪替金錀更新認證，然後重新啟動複寫。
• 具有工作區存取權的 Fabric 使用者會自動繼承鏡像資料庫的存取權。 不過，您可以細微控制工作區和租用戶層級的存取權，以管理組織中使用者的存取權。
• 您可以直接共用 Fabric 中的鏡像資料庫。

權限

• 如果您只有 Fabric 中的檢視者權限，則無法在 SQL 分析端點中預覽或查詢資料。
• 如果您想要使用資料總管，Azure Cosmos DB 資料總管不會使用與 Fabric 相同的權限。 使用資料總管檢視和查詢資料的要求會路由傳送至 Azure，而不是 Fabric。

網路安全性

• 來源 Azure Cosmos DB 帳戶必須啟用所有網路的公用網路存取權。
• Azure Cosmos DB 帳戶不支援私人端點。
• Azure Cosmos DB 帳戶不支援使用 IP 位址或服務端點等技術和功能的網路隔離。
• OneLake 中的資料不支援私人端點、客戶自控金鑰或雙重加密。

資料總管限制

• Fabric 資料總管查詢是唯讀的。 您可以檢視現有的容器、檢視項目和查詢項目。
• 您無法使用 Fabric 中的資料總管來建立或刪除容器。
• 您無法使用 Fabric 中的資料總管來插入、修改或刪除項目。
• 您可以藉由只與其他使用者共用 SQL 分析端點來進行分析，以避免共用來源資料庫。
• 您無法關閉鏡像資料庫中的資料總管。

複寫限制

• 鏡像不支援包含以下項目的容器：屬性名稱中包含空格符或通配符。 這項限制會導致特定容器的鏡像失敗。 相同資料庫內的其他容器仍可成功鏡像。 如果更新屬性名稱以移除這些無效的字元，您必須將新的鏡像設定為相同的資料庫和容器，而且您無法使用舊的鏡像。
• 在 Azure Cosmos DB 帳戶有多個讀取區域的情況下，Fabric OneLake 會從地理位置最接近的 Azure 區域鏡像至 Fabric 容量區域。 在災害復原案例中，鏡像會自動掃描並挑選新的讀取區域，因為您的讀取區域可能會進行容錯移轉和變更。
• 來源容器中的刪除作業會立即反映在使用鏡像的 Fabric OneLake 中。 不支援使用存留時間 (TTL) 值的虛刪除作業。
• 鏡像不支援自訂資料分割。
• Fabric 具有 T-SQL 的現有限制。 如需詳細資訊，請參閱 T-SQL 限制。

結構描述和資料變更

• 刪除並新增類似的容器，僅會以新容器的資料取代倉儲資料表中的資料。
• 在多個項目之間變更屬性中的資料類型，會導致複寫器在適用的情況下向上轉型資料。 此行為與原生差異體驗一致。 不符合支援準則的任何資料都會變成 Null 類型。 例如，將陣列屬性變更為字串會向上轉型為 Null 類型。
• 將新屬性新增至項目會導致鏡像順暢地偵測到新屬性，並將對應的資料行新增至倉儲資料表。 如果項目屬性已移除或缺失，則會採用對應記錄的 Null 值。
• 使用鏡像來複寫資料沒有完整無缺或定義完善的結構描述。 鏡像會自動、連續追蹤屬性變更和資料類型（允許時）。

巢狀資料

• Azure Cosmos DB 項目中的巢狀 JSON 物件會在倉儲資料表中表示為 JSON 字串。
• OPENJSON、CROSS APPLY 和 OUTER APPLY 等命令可用來選擇性地展開 JSON 字串資料。
• PowerQuery 包含 ToJson，可選擇性地展開 JSON 字串資料。
• 鏡像在巢狀層級上沒有結構描述條件約束。 如需詳細資訊，請參閱 Azure Cosmos DB 分析存放區結構描述條件約束。

資料倉儲限制

• 倉儲無法處理大小超過 8 KB 的 JSON 字串資料行。 此案例的錯誤訊息是「JSON 文字的格式不正確。在位置上找到非預期字元 '"'」。
• 在 SQL 分析端點和倉儲資料表中表示為 JSON 字串的巢狀資料，通常會導致資料行的大小增加至 8 KB 以上。 如果您收到此錯誤訊息，則監視巢狀層級和資料量。

鏡像項目限制

• 在工作區為 Azure Cosmos DB 帳戶啟用鏡像需要工作區中的系統管理員或成員角色。
• 停止複寫會完全停用鏡像。
• 重新啟動複寫會重新播種所有目標倉儲資料表。 這項作業實際上會從頭開始鏡像。

提供意見反應

如果您想要提供目前限制、功能或問題的意見反應；請透過 fabriccosmosdbmirror@microsoft.com 聯絡我們。

相關內容

• 鏡像 Azure Cosmos DB (預覽版)
• 常見問題：從 Azure Cosmos DB 鏡像的 Microsoft Fabric 資料庫
• 疑難排解：從 Azure Cosmos DB 鏡像的 Microsoft Fabric 資料庫