虛擬表格的已知問題和疑難排解

本文說明在 Microsoft Dataverse 虛擬資料表操作時已知的限制與故障排除技巧。

以下列表描述了使用虛擬連接器提供者所建立虛擬資料表的已知限制。

一般限制

  • 你使用的表格或清單必須包含至少一個字串欄位作為主要欄位,以及一個 GUID 欄位。 沒有這些字串欄位,你無法建立虛擬表格,且在資料表資料擷取階段會發生錯誤。
    • SharePoint 使用所有清單中隱藏的數字 ID 欄位。
    • SQL 可以使用 GUID 或整數欄位。
    • Excel 必須有一個 GUID 欄位。
  • Dataverse 只能建立與 Dataverse 相容的資料類型欄位。 此限制包括以下資料類型:
    • 字串
    • 多行文字 (備忘)
    • 整數/Integer
    • 十進位
    • 浮動
    • 日期/時間
    • 是/否 (布林值)
    • 選擇 (多重值選取)
    • 超連結/URL
  • Dataverse 不支援以下虛擬資料表的資料類型:
    • 檔案和附件
    • 影像
  • 虛擬表格中文字欄允許的最大字元長度為 4000 個字元。 如果來源表格的最大字元數限制大於此值,則任何超過最大字元限制的建立或更新作業都將造成驗證錯誤,且該作業將失敗。
  • 虛擬表格查詢限制為回傳 1,000 筆紀錄。 如果你與虛擬資料表有 1:N 或 N 個自訂多態表(多態)關係,任何超過此限制的查詢都會失敗並產生錯誤。 在您的查詢中使用篩選,以縮減記錄集做為解決此限制的方法。
  • 虛擬表格無法使用稽核功能,因為 Dataverse 僅能對本機儲存的資料進行稽核並儲存稽核資料。
  • 無法計算虛擬表格的彙總或導出欄位。 此限制存在於 Dataverse 中,彙整是伺服器端計算,需要資料儲存在本地。
  • 資料編輯列位無法使用虛擬表格。
  • Microsoft提供的 Microsoft Entra ID 虛擬資料表僅允許讀取存取。
  • Dataverse 虛擬表格可顯示欄位中超過 Dataverse 正常最大值的資料。 此行為是因為所呈現的數值未儲存在本地。 例如,Dataverse 的整數最大值是 100,000,000,000,但它可以從 SharePoint 檢索並顯示 9,000,000,000。 然而,如果使用者嘗試將該數字編輯到超過Dataverse中最大可接受大小的大小,就會跳出錯誤提示該紀錄無法儲存,因為它超過了最大大小。
  • 不支援在虛擬表格中使用表格資料的匯入和匯出功能。
  • 對於使用否定篩選運算子 (例如「不等於」或「不包含」) 的虛擬表格進行的查詢可能會在第一頁之後產生不正確的分頁行為。 目前沒有支援的變通方法。 避免使用負面濾鏡。
  • 虛擬資料表不能位於 1:N(一對多)關聯中的 1 端。 這是因為虛擬資料表是來源資料表的元資料表示。 當您建立關聯時,系統會在 1:N 關聯的 1 端新增額外的支援資料行。 Dataverse 無法在來源系統中建立新的欄位。

各資料來源的限制

以下限制適用於每個資料來源。

  • 為了功能性,SQL 虛擬表格使用 GUID 或整數欄位作為主鍵。
  • 沒有主鍵的 SQL Server 資料表:你可以選擇任何非字串欄位作為主鍵。 你可以成功建立虛擬表格。 RetrieveMultiple 但其他操作會失敗,並出現以下錯誤訊息(來自 SQL 連接器):「APIM 請求未成功:BadRequest:資料表中沒有主鍵存在。」為了功能性,你必須使用 GUID 或整數欄位作為主鍵。
  • 使用字串主鍵的 SQL Server 表格:虛擬資料表主鍵僅可用 SQL 字串主鍵。 SQL Server 字串主鍵僅在可解析為 GUID 時才被支援。 若無法解析為 GUID,虛擬資料表建立會成功,但在執行時會因以下錯誤而失敗:
    • Power Apps (make.powerapps.com) :「我們無法開啟您的資料表。 請嘗試重新載入或重新開啟。」
    • 網路追蹤:「只有在字串主索引鍵可以剖析為 GUID 時,才支援字串主索引鍵。」
  • SQL Server 表格中沒有非主鍵字串欄位作為主要名稱:如果 SQL 資料表沒有可用字串欄位作為主名稱,設定步驟會顯示以下錯誤:「該資料表沒有主欄位。」
  • 你可以用 SQL 視圖建立虛擬資料表,但它們只提供讀取操作。
  • 關於SQL Server連接器的限制,請參考SQL Server連接器參考。
  • 來源資料表中的 SQL 資料型態( bigint 欄位)在 Dataverse 虛擬資料表中會被映射為十進位資料型態。 當平台支援將 bigint 映射到整數時,你需要刪除虛擬表格中先前建立的欄位,並建立新的欄位。
  • 目前虛擬表格中無法包含以下欄位類型:
    • 時間
    • Datetime2
    • 影像
    • Geometry
    • 地理位置
    • RowVersion
    • 選擇
  • 以下資料行類型包含在虛擬表格中,但僅顯示為文字欄位:
    • HierarchyID
    • XML
    • Sqlvariant

故障排除

  • 即使來源資料表中有更多的記錄,虛擬表格中也只有一個 (1) 記錄。
    解決方法:請檢查來源資料表並確保已定義主索引鍵。

  • 當 Power Apps (make.powerapps.com) 在取得資料表清單時,或選擇 Finish 建立資料表時,會發生以下其中一種錯誤:

    • 「找不到 msdyn_get_required_fields 區段的資源」
    • 「錯誤呼叫......請確認那個連結......存在於環境中」
    • 「序列不符合 msdyn_get_required_fields 的元素」
      解決方法:某些情況下,您可能未使用虛擬連接器提供者的最新解決方案。 若要判斷虛擬連接器提供者解決方案是否需要更新:
    1. 選取左導覽窗格中的解決方案。 如果此項目不在側邊面板窗格中,請選取 ...其他 ,然後選取您想要的項目。
    2. 選擇 歷史 標籤。
    3. 搜尋ConnectorProvider。
    4. 檢視資訊以了解是否需要更新解決方案。
    5. 如果歷史紀錄顯示需要更新,請前往 the Microsoft 商業市集,搜尋 Virtual Connector Provider,然後選擇 立即取得將解決方案匯入你的環境。
    6. 依照步驟重新建立虛擬表格。
  • 在取得連線清單時,會顯示「連線 'xyz' 在目前環境中找不到。」的訊息。
    解決方法:這種情況發生在使用者 Dataverse 環境中存在大量連線時。 此問題已於連接器提供者解決方案版本 1029 獲得修正。 若要判斷虛擬連接器提供者解決方案是否需要更新:

    1. 選取左導覽窗格中的解決方案。 如果此項目不在側邊面板窗格中,請選取 ...其他 ,然後選取您想要的項目。
    2. 選擇 歷史 標籤。
    3. 搜尋ConnectorProvider。
    4. 檢視資訊以了解是否需要更新解決方案。
    5. 如果歷史紀錄顯示需要更新,請前往 the Microsoft 商業市集,搜尋 Virtual Connector Provider,然後選擇 立即取得將解決方案匯入你的環境。
    6. 依照步驟重新建立虛擬表格。
  • 您會收到通知指出在虛擬表格建立期間發生超時。
    解決方法:這可能是因為其他現有的工作導致虛擬表格建立延遲。 稍候幾分鐘,然後再試一次。

  • 您會收到通知表示「發生預期之外的錯誤」
    解決方法:當虛擬表格資料來源建立時使用了無效值時會發生此狀況。 若要解決此問題,您需要找到導致錯誤的虛擬表格資料來源,將其刪除,然後重新建立虛擬表格。

    1. 從Power Apps選擇>(齒輪圖示)進階設定。
    2. 在頂端功能表中,選取設定。
    3. 前往解決方案。 如果此項目不在側邊面板窗格中,請選取 ...其他 ,然後選取您想要的項目。
    4. 前往包含虛擬表格的解決方案 (如果未使用解決方案,請前往 Common Data Services 預設解決方案)。
    5. 在左側面板中,選取虛擬表格資料來源。
    6. 對每個資料來源點擊兩下 (它們的開頭都是 VCP_DS_..."),當您找到發生錯誤的資料來源時,請刪除該資料來源。
    7. 重新建立您的虛擬表格。
  • 顯示一則訊息「此資料表已經存在,您即將重新建立資料表。 主要欄位和結構描述的名稱不能變更。」
    解決方法:該資料表已經被建立過。 繼續建立會重新建立表格,這會導致在資料來源上所做的任何表格變更都將在虛擬表格中更新 (這包括新增或移除欄位)。 自訂名稱和主要欄位值將無法編輯。

  • 錯誤訊息:「primary_key_name不可能是空的」
    解決方法:您選擇的資料表或清單未包含作為主索引鍵的 GUID 值。 您需要在來源表格中新增其他 GUID 資料行才能建立虛擬表格。

  • 你建立了一個 Excel 虛擬表格,但在 Power Apps 的 Tables 區域裡看不到它。
    解決方法:由於虛擬表格建立為非同步作業,您可以在系統工作中檢查處理狀態。 請尋找名稱以 Microsoft.Wrm.DataProvider.Connector.Plugins.ConnectorGenerateVEPlugin 開頭且 Regarding 欄的值等於新虛擬資料表名稱的系統工作。 如果狀態仍為進行中,請等待工作完成。 如果有錯誤,您可以選取系統、工作名稱超連結來取得詳細資訊。 在此範例中,表格建立仍處於擱置狀態:

    表格建立擱置

    在此,因為 429「要求過多」錯誤,表格建立失敗:

    由於 429 錯誤,表格建立失敗

  • 表格建立的系統作業成功,但您收到與無效行或遺漏行相關的執行階段錯誤。
    解決方法:如果在建立資料表欄位時發生失敗,資料表建立程序不會中止,而是會嘗試繼續處理剩餘欄位。 這是因為系統不希望在某些資料行類型不受支援時,阻止虛擬表格的建立。 如需錯誤詳細資訊,請於系統管理>系統設定>自訂>啟用外掛程式追蹤記錄中啟用記錄,然後刪除虛擬表格並重新建立。

  • 如果您刪除連線至虛擬資料表的連線並重新建立它,則「虛擬連接器提供者」應用程式會失去存取新連線的權限,從而阻止資料擷取。
    解決方案:使用連線的共用功能,手動與「虛擬連接器提供者」應用程式共用重新建立的連線,以還原存取權。

  • 當虛擬表的自訂資料提供者更新以支援新作業 (例如建立、更新、刪除) 時,平台不會自動將對應的權限新增至現有的虛擬表實體。
    解決方案:若要啟用新的權限,使用者必須在更新資料提供者之後重新建立虛擬資料表實體。

後續步驟

使用虛擬連接器提供者建立虛擬表格 (預覽)

設定虛擬表格關聯