針對生命週期管理問題進行疑難解答
使用本文針對生命週期管理程序中的問題進行疑難解答。
若要瞭解各種生命週期管理問題的考慮和限制,請檢閱下表中的連結:
主題 | Git 整合 | 部署管線 |
---|---|---|
一般限制 | 一般 Git 限制 | 部署管線限制 |
需要的許可權 | permissions | permissions |
工作區限制 | 工作區 | 工作區 |
支援的網狀架構專案 | 支援的專案 | 支援的專案 |
語意模型 | 語意模型限制 |
Git 整合
存取問題
我無法存取 Azure DevOps 存放庫
問題的描述:當我移至 [Git 整合] 索引標籤時,我會收到錯誤訊息,而且無法存取 Azure DevOps。
原因:如果 Power BI 中的驗證方法比 Azure DevOps 中的驗證方法弱,它們之間的功能將無法運作。
因應措施:系統管理員必須對齊 Power BI 和 Azure DevOps 中的驗證方法。 Microsoft Entra ID 的驗證原則(先前稱為 Azure Active Directory)定義於管理驗證方法中。
連線問題
連線 失敗:無法連線到存放庫
問題的描述:當我嘗試連線到 Git 存放庫時,我會收到一則訊息,指出它無法連線,因為工作區位於不同的區域。
原因:如果工作區和存放庫位於不同的區域,則必須啟用跨區域交換器。
解決方案: 在位於其他地理位置的工作區上啟用 Git 動作。
連線 失敗:當我嘗試連線時發生錯誤
問題的描述:在 [Git 整合] 索引標籤中選取 連線 之後,會出現 [發生錯誤] 對話方塊。 此外,當您選取原始檔控制按鈕時,窗格會指出您需要與 Git 分支同步。
原因:如果您嘗試連線的資料夾具有子目錄,但沒有 Fabric 項目,連線就會失敗。
解決方案:在 Azure DevOps 中開啟 Git 存放庫,並瀏覽至連線中定義的 Git 資料夾。 如果 Git 資料夾包含子目錄,請檢查其中至少有一個代表項目目錄。 如果目錄包含item.config.json和item.metadata.json檔案,則為項目目錄。 如果目錄不包含這些檔案,則為子目錄。 如果 Git 資料夾未包含任何項目目錄,則無法連線到該資料夾。 請移除子目錄,或連線到不包含子目錄的不同資料夾。
連線 失敗:當我嘗試連線到 Git 分支時,我是否想要建立新的資料夾
問題的描述:在 [Git 整合] 索引標籤中選取 連線 之後,會出現一個對話框,指出無效的資料夾路徑。
原因:您嘗試連線的資料夾不存在、已刪除,或與存放庫中現有的資料夾區分大小寫不同。 如果您要連線到新的分支,或從分支中刪除資料夾,就會出現此訊息。
解決方案:
- 若要建立新的資料夾並將它連線到工作區,請選取 [建立並同步]。
- 若要將工作區連線到不同的資料夾,請選取 [取消 ],然後在 [Git 整合] 索引標籤的工作區設定中選擇另一個資料夾。
原始檔控制圖示沒有數位
問題的描述:原始檔控制圖示上的數位表示自上次認可后對工作區所做的變更數目。 如果圖示沒有數位,則可能有連線到分支時發生問題。
解決方案:中斷連線並重新連線。
連線 失敗:它指出我需要 進階版 授權才能連線到 git
問題的描述:我的工作區先前已連線到 Git 存放庫,但現在它表示我需要進階授權才能連線。
原因:如果您擁有有效的 進階版 授權,您只能連線到 Git 存放庫。 如果您的授權已過期,或將授權變更為不包含 Git 整合的授權,您將無法再連線到該存放庫。 這也適用於試用版授權。
解決方案:中斷 Git 的連線,在沒有原始檔控制的情況下運作,或購買 進階版 授權。
認可問題
[認可] 按鈕已停用
問題的描述:如果 Git 分支有更新,則會停用認可,直到您更新工作區為止。
解決方案:若要啟用認可,請更新您的工作區。
更新問題
[認可] 和 [更新] 按鈕都已停用
問題的描述:變更工作區中的相同專案和 Git 分支可能會導致可能的衝突。 如果在工作區和相同專案的 Git 分支中進行變更,則會停用更新,直到衝突解決為止。
解決方案: 解決衝突 ,然後再試一次。
更新失敗:更新未完成,因為它會中斷相依性連結
問題的描述:選取 [ 全部 更新] 或 [復原] 之後,對話框隨即出現,指出失敗,因為動作會中斷相依性連結。
解決方案:開啟歷程檢視以尋找將在更新中從工作區中刪除的專案或專案,並連結到不會從工作區中刪除的專案。
若要解決此問題,請刪除有問題的專案(s):
選取 [ 全部更新]。
如需詳細資訊,請參閱 從 Git 手動更新。
更新後失敗:相依性未指向正確的專案
問題的描述:從 Git 更新之後,查看譜系檢視時,某些專案的相依性不會如預期般。 例如,Proxy 模型不再指向正確的模型。
原因:Git 整合目前不支援直接查詢和 Proxy 模型。
解決方案:若要修正相依性,請執行下列其中一個動作:
- 編輯 Git 存放庫中 ProxyDataset 的 bim 檔案,使其指向正確的數據集,然後在工作區中從 Git 更新以接收變更。
- 使用更新數據源 API 來更新工作區中 Proxy 模型的連線詳細數據。
解決錯誤問題
復原問題
復原失敗:選取 [復原] 之後,對話框隨即出現,指出失敗,因為找不到相依性
問題的描述:如果在 [復原] 動作中未選取的 [變更] 索引標籤中有未認可的相依性,下列錯誤會出現在復原動作之後。
解決方案:選取所選資料庫的所有相依性,然後再試一次。
相依性錯誤:選取 [復原]、[更新] 或 [切換分支] 之後,對話框隨即出現,指出失敗,因為動作會中斷相依性連結
問題的描述:下列錯誤會出現在復原、更新或切換分支動作之後:
原因:工作區中不支援的專案相依於工作區中不再造成相依性問題的專案。
解決方案:開啟 歷程檢視 以尋找選取為「復原」的專案或專案,並連結到未選取的專案。
若要解決此問題,請刪除有問題的專案(s):
- 如果 Git 也支援未選取的專案(例如報表),請選取它來刪除。
- 如果 Git 不支援未選取的專案(例如儀錶板), 請從工作區手動 刪除它。
若要深入瞭解相依性,請參閱 瞭解相依性。
部署管線
我看不到 [部署管線] 按鈕
如果不符合下列條件,則看不到 [部署管線] 按鈕。
我在工作區中看不到管線階段標記
部署管線會在指派給管線的工作區中顯示管線階段標記。 若要查看這些標籤,您必須是管線管理員。開發與測試階段的標籤會顯示。 不過,如果您具有管線的存取權,則只會看到生產卷標。
部署後遺失連線
問題的描述:在完整管線中,從階段取消指派工作區,然後部署至該工作區之後,部署管線會重新建立您從 部署來源階段和目標階段中的專案之間的連線。 不過,有時候部署管線無法重新建立來源和目標階段中專案之間的連線。 例如,當您不小心刪除專案時,可能會發生這種情況。
解決方案:若要重新建立這些連線,請在目標階段取消指派並重新指派相同的工作區。
我無法將工作區指派給階段
原因:當您將工作區指派給部署管線階段時,部署管線會檢查工作區中的專案(例如報表和儀錶板)。 如果相鄰階段中具有相同名稱的兩個專案,則部署管線無法判斷其中哪一個項目應該符合指派工作區中的專案,且 [無法指派工作區 ] 錯誤訊息隨即出現。 例如,如果您嘗試將工作區指派給測試階段,且其中一個報表稱為「區域銷售」,如果在開發或生產階段中有多個具有相同名稱的報表,則指派會失敗。 如果您指派的工作區有兩個標題為「區域銷售語意模型」的語意模型,且開發或生產階段中具有相同名稱的語意模型,指派工作區也會失敗。
解決方案:若要解決此錯誤,請變更不符合您嘗試指派階段中專案的項目名稱。 您可以選取錯誤訊息中的連結,以在 Fabric 中開啟專案。
在指派了具有類似相鄰階段語意模型的工作區之後,我會看到「不同」符號
原因:大部分的語意模型都使用增強的 語意模型元數據 功能,也稱為 模型 v3。 不過,較舊的報表可能會使用舊類型的語意模型元數據,有時稱為 model v1。 如果您要指派使用舊語意模型元數據模型 (v1) 的工作區,部署管線無法評估語意模型在相鄰階段是否類似。 在這種情況下, 即使語意模型相同,也會顯示不同的 UI符號。
解決方案:若要解決此問題,請部署顯示不同符號的語意模型。
當我嘗試將工作區指派給管線時,我看不到所有工作區
原因:在您可以指派給管線的工作區清單中看不到工作區的原因有很多。
解決方案:若要將工作區指派給管線,必須符合下列條件:
不符合這些條件的工作區不會顯示在您可以選取的工作區清單中。
我的第一個部署失敗
原因:您的第一個部署可能因為數個原因而失敗。
解決方案:下表列出解決方案失敗的一些可能原因。
錯誤 | 動作 |
---|---|
您沒有 容量許可權。 | 如果您在具有 Fabric 容量的組織工作,請要求容量管理員將工作區新增至容量,或要求容量指派許可權。 在工作區處於容量之後,請重新部署。如果您無法在具有 Fabric 容量的組織工作,請考慮購買 進階版 每位使用者 (PPU) 。 |
您沒有工作區許可權。 | 若要部署,您必須是工作區成員。 要求您的工作區管理員授與您適當的許可權。 |
您的網狀架構系統管理員已停用工作區的建立。 | 請連絡網狀架構管理員以取得支援。 |
您使用的是 選擇性部署 ,且未選取所有連結的專案。 | 執行下列其中一項: 取消選取連結至語意模型或數據流的內容。 您的未選取內容(例如語意模型、報表或儀錶板)將不會複製到下一個階段。 選取語意模型或連結至所選項目的數據流。 您選取的專案將會複製到下一個階段。 |
當我嘗試部署時,我的工作區中有「不支援的專案」
原因:部署管線不支援所有專案。
解決方案:如需部署管線中支持專案的完整清單,請參閱下列各節:
不支援的項目清單中未列出的任何專案都不會複製到下一個階段。
我想要變更管線階段中的數據源
原因:您無法在 Power BI 服務 中變更數據源連線。
解決方案:如果您想要變更測試或生產階段中的數據源,您可以使用 部署規則 或 API。 部署規則只會在下一個部署之後生效。
我修正了生產環境中的錯誤,但現在已停用 [部署至上一個階段] 按鈕
原因:您只能向後部署至空白階段。 如果您在測試階段有內容,則無法從生產環境向後部署。
解決方案:建立管線之後,請使用開發階段來開發內容,以及檢閱和測試階段。 您可以修正這些階段中的 Bug,然後將固定的環境部署到生產階段。
錯誤訊息:「繼續部署」
原因:來源階段架構中斷性變更,例如,將數據行類型從整數取代為字串,會在部署后造成目標語意模型中的數據遺失。
在部署期間,會針對目標元數據檢查來源語意模型中的元數據。 架構中斷性變更會導致部署停止。 發生這種情況時,您會收到 繼續部署 訊息。
解決方案:如果您繼續部署,則會遺失目標階段中的數據。 如果您對語意模型所做的變更是刻意的,您可以使用此選項。 部署完成之後,您必須重新整理目標語意模型。
如果變更不是刻意的,請關閉訊息視窗,將固定 的 .pbix 檔案上傳至來源工作區並重新部署。
部署因架構變更而失敗之後,目標階段會顯示 [部署失敗 ] 訊息,後面接著 [顯示詳細數據 ] 連結。 鏈接會開啟與失敗部署期間所顯示的部署訊息相同。
錯誤訊息:「無法啟動部署」
原因:當您使用累加式重新整理時,只允許對您要部署的語意模型進行某些變更。 如果您進行不允許的語意模型變更,您的部署會失敗,而且您會收到此訊息:
解決方案:如果您刻意變更語意模型,請使用下列其中一個因應措施:
Using.pbix - 將您的變更直接發佈至目標語意模型。 所有分割區和數據都會遺失,因此您必須重新整理語意模型。
使用 XMLA 工具 - 直接在目標階段的語意模型上進行變更。
我的視覺效果在部署語意模型或數據流之後中斷
原因:語意模型和數據流是網狀架構專案,可儲存數據並同時包含數據和元數據。 在部署期間,只有在數據不是時,才會複製元數據。 因此,在部署之後,語意模型或數據流可能沒有任何數據,而且依賴此數據的報表視覺效果將會顯示中斷。
解決方案:若要解決此問題,請重新整理數據流,然後在目標階段重新整理語意模型。
如何刪除沒有擁有者(孤立管線)的管線?
原因:使用部署管線時,最後可能會有沒有擁有者的管線。 例如,當擁有管線的用戶離開公司而不需要轉移擁有權時,管線可以保留沒有擁有者。 當管線沒有擁有者時,其他使用者就無法存取它。 由於工作區只能指派給一個管線,如果指派給沒有擁有者的管線,則沒有人能夠取消指派它,而且您無法在另一個管線中使用工作區。
解決方案:當管線沒有擁有者時,網狀架構管理員可以將新的擁有者新增至管線,或刪除它。 若要將擁有者新增至管線,請使用 管理員 - Pipelines UpdateUserAs 管理員 API。
您也可以檢閱我們的 PowerShell 腳本 AddUserToWorkspacePipeline (可從 PowerBI-Developer-Samples GitHub 存放庫取得),這可讓您執行下列動作:
管理管線存取 - 將任何使用者新增至管線中的工作區。
回收工作區擁有權 - 將任何使用者新增至沒有擁有者之管線中的工作區,讓您解除封鎖。
若要使用此腳本,您必須提供工作區名稱和用戶主體名稱(UPN)。 腳本會尋找指派工作區的管線,並將系統管理員許可權新增至您指定的使用者。
不符錯誤:來源和目標語意模型格式版本不符錯誤
問題的描述: 無法啟動部署 錯誤,指出 來源和目標語意模型具有不同的數據模型化格式,當目標階段中的語意模型版本高於來源階段中的語意模型時發生。 在這種情況下,部署管線無法從來源階段部署到目標階段。 若要避免此錯誤,請使用在來源階段中具有相同(或更高)模型版本的語意模型。
解決方案:使用 XMLA 讀寫端點 或 Power BI Desktop 升級來源階段中的語意模型。 升級語意模型之後,請將它重新發佈至來源階段。
不符錯誤:數據源連線模式不符錯誤
問題的描述:在部署期間,如果部署管線發現目標階段中數據源的連線模式與來源階段中的數據源不同,它會嘗試轉換目標階段中數據源的連線模式。 如果您使用數據源搭配 即時連線 或 即時 連線模式,部署管線就無法轉換目標的數據源連線模式。
解決方案:使用 XMLA 讀寫端點 或 Power BI Desktop 變更來源階段數據源的連接模式,或刪除目標階段中的數據源,讓部署覆寫它。
我的語意模型部署失敗
原因:您的語意模型部署可能會失敗幾個可能的原因。 以下是失敗的可能原因:
- 大型語意模型未設定 大型語意模型格式。
- 語意模型包含迴圈或自我相依性(例如,專案 A 參考專案 B 和專案 B 參考專案 A)。 在此情況下,您會看到下列錯誤訊息: 一或多個項目無法部署,因為它會導致專案之間的雙向相依性。
解決方案:
- 如果您的語意模型大於 4 GB 且未使用大型語意模型格式,則可能無法部署。 請嘗試將您的語意模型設定為使用大型語意模型格式,然後重新部署。
- 如果您的語意模型包含迴圈或自我相依性,請移除相依性並重新部署。
我有具有 DirectQuery 或複合連線模式的語意模型,其使用變化或自動日期/時間數據表
原因:部署管線中不支援使用 DirectQuery 或複合連線模式且具有變化或 自動日期/時間 數據表的語意模型。
解決方案:如果您的部署失敗,而且您認為這是因為您有具有變化數據表的語意模型,您可以在數據表的數據行中尋找 變化 屬性。 您可以使用下列其中一種方法來編輯語意模型,讓它在部署管線中運作。
在您的語意模型中,使用 匯入 模式, 而不是 DirectQuery 或 複合 模式。
從語意模型中移除自動日期/時間數據表。 如有必要,請從數據表中的所有數據行中刪除任何剩餘的變化。 刪除變化可能會使用戶撰寫的量值、計算結果列和匯出數據表失效。 只有在您了解語意模型模型的運作方式時,才使用這個方法,因為它可能會導致視覺效果中的數據損毀。
分頁報表
我無法部署編頁報表
解決方案:若要部署編頁報表,您必須是您要從部署工作區的工作區成員(來源階段工作區)。 如果您不是來源階段中的工作區成員,就無法部署編頁報表。
數據源不符:目標階段編頁報表會在來源階段顯示來自網狀架構語意模型的數據
問題的描述:目前,語意模型會被視為外部 Analysis Services 數據源,且在部署之後不會自動切換語意模型的連線。
當您部署已連線至 Fabric 語意模型的編頁報表時,它會繼續指向原本連接的語意模型。 使用 部署規則 將編頁報表指向您想要的任何語意模型,例如目標階段語意模型。
解決方案:如果您使用編頁報表搭配 Fabric 語意模型,請參閱 如何? 使用 Fabric 語意模型建立編頁報表的部署規則?
部署失敗:大量編頁報表失敗
問題的描述:大量具有規則的編頁報表部署可能會因為容量上的多載而失敗。
解決方案:購買較高的 SKU 或使用選擇性部署。
資料流程
譜系檢視:我刪除了屬於數據流的數據源,但我仍可在譜系檢視中看到該數據源
原因:在數據流中,不會從數據流數據源頁面移除舊的數據源。 為了支持數據流歷程檢視,不會刪除連線的專案。
解決方案:此行為不會影響部署管線。 您仍然可以在管線中重新整理、編輯和部署數據流。
我在使用數據流規則之後看到兩個連接到數據流的數據源
問題的描述:使用規則變更數據流數據源之後,數據流的譜系檢視會顯示數據流源數據源與規則中設定的數據源之間的連線。
解決方案:此行為不會影響部署管線。
資料超市
部署問題:我無法在管線中部署 Datamart
解決方案:若要部署 Datamart,您必須是 Datamart 的擁有者。
部署問題:我的 Datamart 部署因為迴圈相依性而失敗
解決方案:有一個項目參考本身,或一個以上的專案涉及迴圈參考鏈結(例如,專案 A 參考專案 B 和專案 B 參考專案 A)。 若要部署 Datamart,請移除迴圈相依性並重新部署。
權限
神秘 可以在階段之間部署內容嗎?
內容可以部署到空白階段或包含內容的階段。 內容必須位於網狀架構容量上。
部署到空白階段 - 來源工作區中成員或系統管理員的任何 授權網狀架構 使用者。
部署至具有內容的 階段 - 來源和目標部署階段中屬於這兩個工作區成員或系統管理員的任何 授權網狀架構 使用者。
覆寫語意模型 - 部署會覆寫目標階段中包含的每個語意模型,即使語意模型未變更也一樣。 屬於這兩個工作區成員或系統管理員的任何使用者,但租用戶系統管理員只能將此限制為目標語意模型擁有者。
我在管線中看不到工作區
原因:管線和工作區許可權會分開管理。 您可能具有管線許可權,但沒有工作區許可權。
解決方案:如需詳細資訊,請檢閱許可權一節。
錯誤訊息:「需要工作區成員許可權」
解決方案:若要指派工作區,您至少 需要工作區成員 許可權,才能在工作區的相鄰階段。 相鄰階段需要工作區成員(或更高許可權)才能讓部署管線在鄰近管線階段的項目之間建立連線。
規則
部署失敗,因為規則中斷
解決方案:如果您在設定部署規則時遇到問題,請流覽 部署規則,並確定您遵循 部署規則限制。
如果您的部署先前成功,且突然因規則中斷而失敗,可能是因為重新發佈語意模型。 下列來源語意模型變更會導致部署失敗:
參數規則
已移除的參數
已變更的參數名稱
資料來源規則
您的部署規則遺漏值。 如果您的語意模型已變更,就可能發生這種情況。
當先前成功的部署因連結中斷而失敗時,會顯示警告。 您可以選取 [ 設定規則] 以瀏覽至部署規則 窗格,其中已標示失敗的語意模型。 當您選取語意模型時,會標示中斷的規則。
若要成功部署,請修正或移除中斷的規則,然後重新部署。
部署問題:我已設定規則,但未部署
原因:部署規則設定後不會立即套用。
解決方案:若要套用部署規則,您必須將語意模型從來源階段部署到包含已建立的部署規則的目標階段。 設定部署規則之後,以及部署之前, 語意模型旁邊會顯示具有已設定規則的不同 指標。 這表示您需要將該語意模型從來源階段部署到目標階段。 部署之後,如果沒有進行其他變更,不同的指標就會消失,表示規則已成功套用。
部署規則呈現灰色
解決方案:若要建立 部署規則,您必須是您要為其建立部署規則之專案的擁有者。 如果您不是項目的擁有者,部署規則會呈現灰色。
如果其中一個規則選項呈現灰色,可能是因為下列原因:
數據源規則 - 沒有可以設定規則的數據來源。
參數規則 - 沒有可以設定規則的參數。
語意模型的數據源規則失敗
解決方案:儲存資料來源規則可能會因為下列其中一個原因而失敗:
您的語意模型包含連線至數據源的函式。 在這種情況下,不支持數據源規則。
您的數據源使用參數。 您無法為使用參數的語意模型建立資料源規則。 請改為建立參數規則。
建立新的語意模型規則時,我無法連線到語意模型
原因:使用 Power BI Desktop 建構語意模型時,可以設定 連接字串。 稍後,部署管線可以在 Power BI 服務 中發佈及使用語意模型。 在 Power BI Desktop 中建立連線時,您可以指定其他參數。 指定參數時,語意模型來源必須是列出的第一個參數。 如果您在語意模型來源之前列出任何其他參數,就會在 Power BI 服務 中遇到錯誤。 在這種情況下,當您設定新的語意模型規則時,如果您指向Power BI Desktop 中未正確設定的語意模型,部署管線就無法建立規則。
解決方案:在Power BI Desktop 中格式化語意模型連接,使語意模型來源出現在第一個數據列中。 然後,重新發佈語意模型。
疑難排解錯誤
使用本節來針對您所建立的管線 規則 進行疑難解答。 如果您沒有看到規則錯誤訊息名稱,請檢閱 部署規則限制 和 數據流和語意模型規則支持的數據源,並嘗試重新設定規則。
錯誤訊息 | 解決方案 |
---|---|
數據源規則不能包含參數 | 無法套用您的規則,因為規則中所參考的伺服器名稱或資料庫名稱是由參數所控制。 若要變更伺服器或資料庫名稱,請使用參數規則,或從設定的專案中移除控制參數。 |
數據源執行失敗 | 無法套用規則,因為無法從數據源擷取數據。 拿掉規則,並確定語意模型具有有效的查詢。 然後再次嘗試建立規則。 |
規則屬性已不存在 | 規則中設定的部分規則屬性已不存在。 重新整理頁面,然後再次設定規則。 |
不合法的值 | 在設定的規則中使用的值無效。 驗證規則的值,然後再次嘗試設定規則。 |
不支援多個數據源 | 由於其數據源組態,無法套用語意模型規則。 請移除規則,或使用標準 Power BI Desktop 工具重寫語意模型查詢。 |
目標語意模型只能由其擁有者變更 | 您的規則將會覆寫目的地工作區中的一些語意模型。 您必須是將覆寫之任何語意模型的擁有者。 |
相關內容
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應