共用方式為

部署管線程序

  • 發行項

部署程序可讓您將部署管線中某個階段的內容複製到另一個階段，通常是從開發到測試，以及從測試到實際執行環境。

在部署期間，Microsoft Fabric 會將內容從來源階段複製到目標階段。 在複製的過程中，複製前後的項目會保持連結。 Fabric 也會將設定的部署規則套用到目標階段中更新的內容。 部署內容可能需要一些時間，依部署的項目多寡而定。 在這段期間，您可以瀏覽至入口網站中的其他頁面，但不能使用目標階段中的內容。

您也可以使用部署管線 REST API，以程式設計方式部署內容。 您可以在使用 API 和 DevOps 將部署管線自動化深入了解此程序。

重要

Microsoft Fabric 部署管線的新使用者介面已暫時停用。 我們正努力解決此問題，並在新的UI再次可用時更新此頁面。 同時，您可以繼續使用原始 UI。

部署管線程序有兩個主要部分：

定義部署管線結構

建立管線時，您可以定義您想要的階段數量，以及這些階段的名稱。 您也可以公開一或多個階段。 階段數量及其名稱是永久性的，在建立管線後就無法變更。 不過，您可以隨時變更階段的公用狀態。

若要定義管線，請遵循建立部署管線中的指示。

將內容新增至階段

您可以透過兩種方式將內容新增至管線階段：

將工作區指派至空白階段

當您將內容指派到空白階段時，會在您要部署的階段的容量上建立新的工作區。 原始工作區的報表、儀表板和語意模型中的所有中繼資料都會複製到您要部署的階段中的新工作區。

部署完成之後，重新整理語意模型，如此便可使用新複製的內容。 您必須重新整理語意模型，因為資料不會從某個階段複製到另一個階段。 若要了解部署程序期間複製了哪些項目屬性，以及未複製哪些項目屬性，請檢閱部署期間複製的項目屬性一節。

如需如何將工作區指派和取消指派給部署管線階段的指示，請參閱將工作區指派給 Microsoft Fabric 部署管線。

建立工作區

第一次部署內容時，部署管線會檢查您是否具有權限。

如果您具有權限，可將工作區的內容複製到您要部署的目標階段，並在容量上建立該階段的新工作區。

如果您沒有權限，就會建立工作區，但不會複製內容。 您可以要求容量管理員將您的工作區新增至容量，或要求容量的指派權限。 稍後將工作區指派給容量時，您可以將內容部署到此工作區。

如果您使用的是 Premium Per User (PPU)，您的工作區即會與您的 PPU 自動關聯。 在該情況下，不需要權限。 不過，如果您使用 PPU 建立工作區，則只有其他 PPU 使用者才能存取。 此外，只有 PPU 使用者才能取用在此類工作區中建立的內容。

工作區與內容所有權

部署使用者會自動成為複製語意模型的擁有者，以及新工作區的唯一管理員。

將內容從一個階段部署至另一個

有幾種方式可將內容從一個階段部署到另一個階段。 您可以部署所有內容，也可以選取要部署的項目。

您可以將內容部署到任何相鄰的階段，方向不限。

將內容從工作中的生產管線部署到具有現有工作區的階段，包括下列步驟：

  • 將新內容部署為已存在內容的新增項目。

  • 部署更新的內容來取代已存在的部分內容。

部署程序

將來源階段的內容複製到目標階段時，Fabric 會識別目標階段中的現有內容並加以覆寫。 為了識別需要覆寫的內容項目，部署管線會使用父項目與其複製項之間的連線。 建立新內容時會保留此連線。 覆寫作業只會覆寫項目的內容。 項目的識別碼、URL 與權限會保持不變。

在目標階段中，未複製的項目屬性會維持其部署之前的樣子。 新內容與新項目會從來源階段複製到目標階段。

自動繫結

在 Fabric 中，項目連線時，其中一個項目會相依於另一個項目。 例如，報告一律取決於其所連接的語意模型。 語意模型可以相依於另一個語意模型，也可以連線到相依於它的數個報表。 如果兩個項目之間有連線，部署管線將一律嘗試維護此連線。

相同工作區中的自動繫結

在部署期間，部署管線會檢查相依性。 部署會成功或失敗，視提供所部署項目相依的資料項目位置而定。

  • 連結的項目存在於目標階段 - 部署管線會自動將已部署的項目連線 (自動繫結) 到所部署階段中相依的項目。 例如，如果您將編頁報告從開發部署到測試，而該報告與先前部署至測試階段的語意模型連線，則該報告會自動與測試階段中的語意模型連線。

  • 連結的項目不存在於目標階段 - 如果某個項目相依於另一個項目，而提供資料的項目尚未部署且不在目標階段中，則部署管線會導致部署失敗。 例如，如果您將報表從開發部署至測試，而測試階段不包含其語意模型，則部署會失敗。 若要避免部署因為未部署相依項目而失敗，請使用 [選取相關項目] 按鈕。 [選取相關項目] 會自動選取提供相依性給即將部署的項目的所有相關項目。

自動繫結僅適用部署管線所支援且位於 Fabric 內的項目。 若要檢視項目的相依性，請從項目的 [更多選項] 功能表選取 [檢視譜系]。

跨工作區自動繫結

如果項目位於相同的管線階段，部署管線會自動繫結跨管線連線的 Power BI 項目。 部署這類項目時，部署管線會嘗試在已部署的項目與其連線至另一個管線中的項目之間建立新的連線。 例如，如果您在管線 A 的測試階段中有報表，且該報表已連線至管線 B 測試階段中的語意模型，則部署管線會辨識此連線。

以下範例以圖例輔助說明跨管線自動繫結如何運作：

  1. 您在管線 A 的開發階段有語意模型。

  2. 您在管線 B 的開發階段也有報表。

  3. 管線 B 中的報表會連線至管線 A 中的語意模型。您的報表相依於此語意模型。

  4. 您會在管線 B 中將報表從開發階段部署到測試階段。

  5. 部署成功或失敗，視您是否有相依於管線 A 的測試階段的語意模型複本：

    • 如果您有相依於管線 A 測試階段報表的語意模型複本：

      部署會成功，而部署管線會將管線 B 測試階段中的報表連線 (自動繫結) 到管線 A 測試階段中的語意模型。

      顯示在管線 B 中成功將報告由開發階段部署到測試階段的圖表。

    • 如果您沒有相依於管線 A 測試階段報表的語意模型複本

      部署會失敗，因為部署管線無法將管線 B 中測試階段中的報表連線 (自動繫結) 到管線 A 測試階段中其相依的語意模型。

      顯示在管線 B 中，報表從開發階段部署到測試階段失敗的圖表。

避免使用自動繫結

在某些情況下，您可能不希望使用自動繫結。 例如，如果您有一個管線來開發組織語意模型，而另一個用於建立報表。 在此情況下，您可能希望所有報表一律連線到其所屬管線生產階段的語意模型。 在此情況下，請避免使用自動繫結功能。

顯示兩個管線的圖表。管線 A 在每個階段都有語意模型，而管線 B 在每個階段都有報表。

您可以使用三種方法來避免使用自動繫結：

  • 請勿將項目連線至對應的階段。 當項目未在相同階段連線時，部署管線會保留原始連線。 例如，如果您在連線至管線 A 生產階段中語意模型的管線 B 的開發階段中有報表。當您將報表部署到管線 B 的測試階段，它會保持連線到管線 A 生產階段中的語意模型。

  • 定義參數規則。 此選項無法用於報表。 您只能將其與語意模型和資料流程搭配使用。

  • 將報表、儀表板和磚連線至未連線至管線的 Proxy 語意模型或資料流程。

自動繫結和參數

參數可用來控制語意模型或資料流程與其相依項目之間的連線。 當參數控制連線時，即使連線包含適用於語意模型或資料流程 ID 或工作區 ID 的參數，部署後的自動繫結也不會發生。 在這種情況下，您必須藉由變更參數值或使用參數規則，在部署之後重新繫結項目。

注意

如果您使用參數規則來重新繫結項目，參數必須是類型 Text。

重新整理資料

會盡可能保留目標項目中的資料，例如語意模型或資料流程。 如果沒有對保留資料的項目的變更，資料會保持與部署之前相同。

在許多情況下，當您有少量變更，例如新增或移除資料表時，Fabric 會保留原始資料。 對於會破壞結構描述的變更，或是資料來源連線的變更，則必須執行完整重新整理。

使用現有工作區部署到階段的需求

任何同時是目標和來源部署工作區之參與者的授權使用者，都可以將儲存在容量上的內容部署到具有現有工作區的階段。 如需詳細資訊，請檢閱權限一節。

部署管線中的資料夾 (預覽)

資料夾可讓使用者以熟悉的方式有效率地組織和管理工作區項目。 當您將包含資料夾的內容部署到不同的階段時，會自動套用已套用項目的資料夾階層。

資料夾表示法

工作區內容會顯示為工作區中的結構化內容。 系統會列出資料夾，若要查看其項目，您需要選取資料夾。 項目的完整路徑會顯示在項目清單頂端。 由於部署只包含項目，因此您只能選取包含支援項目的資料夾。 選取要部署的資料夾表示選取其所有項目和子資料夾及其部署項目。

此圖片顯示工作區內資料夾的內容。 資料夾的完整路徑名稱會顯示在清單頂端。

此螢幕擷取畫面顯示具有資料夾完整路徑名稱的資料夾內容。名稱包含資料夾的名稱。

在部署管線中，資料夾會被視為項目名稱的一部分 (項目名稱包含其完整路徑)。 部署項目時，在其路徑變更後 (例如，從資料夾 A 移至資料夾 B)，然後部署管線會將此變更套用至其部署期間的配對項目 - 配對項目也會移至資料夾 B。如果資料夾 B 不存在於我們要部署的階段，則會先在其工作區中建立該資料夾。 只能在工作區頁面上看到和管理資料夾。

從該資料夾部署資料夾中的項目。 您無法同時部署來自不同階層的項目。

識別已移至不同資料夾的項目

由於資料夾會被視為項目名稱的一部分，因此在 [部署管線] 頁面上，項目在比較時會識別為 [不同] 工作區中的不同資料夾。 此項目不會出現在比較視窗中，因其並非結構描述變更，而是設定變更。

顯示比較變更畫面的螢幕擷取畫面，其中一個階段中的項目在新 UI 中被移到不同的資料夾。

  • 無法在部署管線中手動部署個別資料夾。 至少部署其中一個項目時，系統會自動觸發其部署。

  • 配對項目的資料夾階層只會在部署期間更新。 在指派期間，在配對程序之後，尚未更新配對項目的階層。

  • 因為只有在部署其中一個項目時才會部署資料夾，因此無法部署空的資料夾。

  • 從資料夾中的多個項目中部署一個項目，也會更新目標階段中未部署的項目的結構，即使這些項目本身並未部署亦然。

父子項目表示法

這些表示法只會出現在新 UI 中。 看起來與工作區中的相同。 子系未部署，但在目標階段重新建立

顯示新 UI 中父子關聯性描述的螢幕擷取畫面。

在部署期間複製的項目屬性

如需支援的項目清單，請參閱部署管線支援的項目。

在部署期間，會複製下列項目屬性，並覆寫目標階段上的項目屬性：

  • 資料來源 (支援部署規則)

  • 參數(支援部署規則)

  • 報表視覺效果

  • 報表頁面

  • 儀表板磚

  • 模型中繼資料

  • 項目關聯性

  • 只有在符合下列其中一個條件時，才會複製敏感度標籤。 如果不符合這些條件，則不會在部署期間複製敏感度標籤。

    • 部署新項目，或將現有項目部署至空白階段。

      注意

      如果在租用戶上啟用預設標籤，且預設標籤有效，如果部署的項目是語意模型或資料流程，則只有在標籤具有保護時，才會從來源項目複製標籤。 如果未保護標籤，則會將預設標籤套用至新建立的目標語意模型或資料流程。

    • 來源項目有具有保護的標籤，且目標項目沒有。 在此情況下，會出現快顯視窗，要求同意覆寫目標敏感度標籤。

未複製的項目屬性

下列項目屬性不會在部署期間複製：

  • 資料 - 不會複製資料。 只會複製中繼資料

  • URL

  • 識別碼

  • 權限：適用於工作區或特定項目

  • 工作區設定：每個階段都有自己的工作區

  • 應用程式內容和設定 - 若要更新您的應用程式，請參閱將內容更新至 Power BI 應用程式

  • 個人書籤

在部署期間也不會複製下列語意模型屬性：

  • 角色指派

  • 重新整理排程

  • 資料來源認證

  • 查詢快取設定 (可繼承自容量)

  • 簽署設定

支援的語意模型功能

部署管線支援許多語意模型功能。 此章節列出兩個可增強部署管線體驗的 Power BI 語意模型功能：

累加式重新整理

部署管線支援累加式重新整理，此功能可讓大型語意模型的重新整理速度更快、更可靠、耗用量更低。

透過部署管線，您可以採用累加式重新整理的語意模型進行更新，同時保留資料和分割區。 當您部署語意模型時，會一併複製該原則。

若要了解累加式重新整理如何搭配資料流程運作，請參閱為何在使用資料流程規則之後會看到兩個連線至資料流程的資料來源？

注意

累加式重新整理設定不會複製到 Gen 1 中。

在管線中啟用累加式重新整理

若要啟用累加式重新整理，請在 Power BI Desktop 中設定，然後發佈您的語意模型。 發佈之後，管線中的累加式重新整理原則會類似，且只能在 Power BI Desktop 中撰寫。

使用累加式重新整理設定您的管線之後，建議使用以下流程：

  1. 在 Power BI Desktop 中對 .pbix 檔案進行變更。 若要避免漫長的等待時間，建議使用資料的樣本進行變更。

  2. 將 .pbix 檔案上傳至第一個 (通常是開發) 階段。

  3. 將內容部署到下一個階段。 部署之後，您所做的變更將會套用到您使用的整個語意模型。

  4. 檢閱您在每個階段中所做的變更，並在驗證後部署到下一個階段，直到您進入最後階段為止。

使用範例

以下幾個範例會說明如何將累加式重新整理與部署管線整合。

  • 建立新的管線，並將其連線到具有的語意模型已啟用累加式重新整理的工作區。

  • 對已在開發工作區中的語意模型啟用累加式重新整理。

  • 從具有使用累加式重新整理之語意模型的生產工作區建立管線。 例如，將工作區指派到新管線的生產階段，並使用向後部署的方式部署到測試階段，然後再部署到開發階段。

  • 將使用累加式重新整理的語意模型發佈至屬於現有管線的工作區。

累加式重新整理限制

對於累加式重新整理，部署管線僅支援使用增強型語意模型中繼資料的語意模型。 使用 Power BI Desktop 建立或修改的所有語意模型都會自動實作增強的語意模型中繼資料。

將語意模型重新發佈至啟用累加式重新整理的作用中管線時，以下變更可能會由於資料遺失而導致部署失敗：

  • 重新發佈未使用累加式重新整理的語意模型，以取代已啟用累加式重新整理的語意模型。

  • 重新命名已啟用累加式重新整理的資料表。

  • 在已啟用累加式重新整理的資料表中，重新命名非導出資料行。

允許其他變更，例如新增資料行、移除資料行，以及重新命名導出資料行。 不過如果變更會影響顯示，則必須先重新整理才會顯示變更。

複合模型

使用複合模型，您可以設定具有多個資料連線的報表。

您可以使用複合模型功能，將 Fabric 語意模型連線到外部語意模型，例如 Azure Analysis Services。 如需詳細資訊，請參閱使用適用於 Fabric 語意模型和 Analysis Services 的 DirectQuery。

在部署管線中，您可以使用複合模型，將語意模型連線到管線外部的另一個 Fabric 語意模型。

自動彙總

自動彙總以使用者定義的彙總為建置基礎，並使用機器學習持續最佳化 DirectQuery 語意模型，以達到報表查詢效能上限。

每個語意模型都會在部署後保持其自動彙總。 部署管線不會變更語意模型的自動彙總。 這表示，如果您使用自動彙總部署語意模型，目標階段中的自動彙總會維持原狀，而且不會由從來源階段部署的自動彙總覆寫。

若要啟用自動彙總，請遵循設定自動彙總中的指示。

混合式資料表

混合式資料表是具有可同時匯入和直接查詢分割區的累加式重新整理資料表。 在全新部署期間，會複製重新整理原則和混合式資料表分割區。 當您部署到已具有混合式資料表分割區的管線階段時，只會複製重新整理原則。 若要更新分割區，請重新整理資料表。

將內容更新至 Power BI 應用程式

Power BI 應用程式是將內容發佈給免費 Fabric 取用者的建議方式。 您可以使用部署管線來更新 Power BI 應用程式的內容，讓您在應用程式生命週期方面擁有更多控制權和彈性。

建立適用於每個部署管線階段的應用程式，讓您可以從使用者的觀點測試每個更新。 使用工作區卡片中的發佈或檢視按鈕，在特定管線階段中發佈或檢視應用程式。

在生產階段中，您也可以更新 Fabric 中的應用程式頁面，讓應用程式使用者能夠使用任何內容更新。

重要

部署程序不包含更新應用程式內容或設定。 若要將變更套用到內容或設定，您必須在必要的管線階段手動更新應用程式。

權限

管線和指派給管線的工作區都需要權限。 管線權限和工作區權限是分開授與和管控的。

  • 管線只有一個權限：管理員，這是共用、編輯和刪除管線所需的權限。

  • 工作區具有不同的權限，也稱為角色。 工作區角色會決定管線中工作區的存取層級。

  • 部署管線不支援 Microsoft 365 群組作為管線管理員。

若要從管線中的某個階段部署到另一個階段，您必須是管線管理員，以及指派給相關階段之工作區的參與者、成員或管理員。 例如，未獲指派工作區角色的管線管理員可以檢視管線，並與其他人共用。 不過，此使用者無法在管線或服務中檢視工作區的內容，而且無法執行部署。

權限資料表

本節描述部署管線權限。 此節所列的權限在其他 Fabric 功能中可能會有不同的應用。

最低部署管線權限是管線管理員，且所有部署管線作業都需要此權限。

User 管線權限 註解
管線管理員
  • 檢視管線
  • 與其他人共用管線
  • 編輯及刪除管線
  • 從階段取消指派工作區
  • 可以查看標記為已指派給 Power BI 服務中管線的工作區
 管線存取權不會授與權限來檢視工作區內容或對其採取動作。
工作區檢視者
(和管線管理員)
  • 取用內容
  • 從階段取消指派工作區
 獲指派檢視者角色但無建置權限的工作區成員，無法存取語意模型或編輯工作區內容。
工作區參與者
(和管線管理員)
  • 取用內容
  • 比較階段
  • 檢視語意模型
  • 從階段取消指派工作區
  • 部署項目 (必須至少是來源工作區和目標工作區的參與者)
工作區成員
(和管線管理員)
  • 檢視工作區內容
  • 比較階段
  • 部署項目 (必須至少是來源工作區和目標工作區的參與者)
  • 更新語意模型
  • 從階段取消指派工作區
  • 設定語意模型規則 (您必須是語意模型擁有者)
 如果已啟用位於租用戶 [語意模型安全性] 區段中的 [禁止重新發佈並停用套件重新整理] 設定，則只有語意模型擁有者能夠更新語意模型。
工作區管理員
(和管線管理員)
  • 檢視工作區內容
  • 比較階段
  • 部署項目
  • 將工作區指派給階段
  • 更新語意模型
  • 從階段取消指派工作區
  • 設定語意模型規則 (您必須是語意模型擁有者)

授與的權限

您在部署 Power BI 項目時，已部署項目的擁有權可能會變更。 請檢閱下表，了解可以部署每個項目的是哪些人，以及部署如何影響項目的擁有權。

Fabric 項目 需要部署現有項目的權限 第一次部署之後的項目擁有權 部署至具有項目的階段後的項目擁有權
語意模型 工作區成員 建立部署的使用者會成為擁有者 Unchanged
資料流程 資料流程擁有者 建立部署的使用者會成為擁有者 Unchanged
資料超市 資料超市擁有者 建立部署的使用者會成為擁有者 Unchanged
編頁報表 工作區成員 建立部署的使用者會成為擁有者 建立部署的使用者會成為擁有者

下表列出熱門部署管線動作的必要權限。 除非另有指定，否則針對每個動作，您需要所有列出的權限。

動作 所需的權限
檢視組織中的管線清單 不需要授權 (免費使用者)
建立管線 具有下列其中一個授權的使用者：
  • Pro
  • PPU
  • 高級
刪除管線 管線管理員
新增或移除管線使用者 管線管理員
將工作區指派給階段
  • 管線管理員
  • 工作區管理員 (要指派的工作區)
對階段取消指派工作區 下列角色之一：
部署至空白階段
  • 管線管理員
  • 來源工作區參與者
將項目部署到下一個階段
  • 管線管理員
  • 來源和目標階段的工作區參與者
  • 若要部署資料超市或資料流程，您必須是已部署項目的擁有者
  • 如果語意模型租用戶管理員切換已開啟，而且您要部署語意模型，則您必須是語意模型的擁有者
檢視或設定規則
  • 管線管理員
  • 目標工作區參與者、成員或管理員
  • 您要為其設定規則的項目的擁有者
管理管線設定 管線管理員
檢視管線階段
  • 管線管理員
  • 工作區讀者、參與者、成員或管理員。您會看到授與工作區權限存取權的項目。
檢視階段中的項目清單 管線管理員
比較兩個階段
  • 管線管理員
  • 這兩個階段的工作區參與者、成員或管理員
檢視部署歷程記錄 管線管理員

考量與限制

此節列出部署管線中大部分的限制。

  • 該工作區必須位於 Fabric 容量上。
  • 可在單一部署中部署的項目數目上限為 300 個。
  • 不支援在部署後下載 .pbix 檔案。
  • 不支援 Microsoft 365 群組作為管線管理員。
  • 當您第一次部署 Power BI 項目時，如果目標階段中的另一個項目具有相同的名稱和類型 (例如，如果兩個檔案都是報表)，則部署會失敗。
  • 如需工作區限制的清單，請參閱工作區指派限制。
  • 如需支援的項目清單，請參閱支援的項目。 不支援任何不在清單上的項目。
  • 如果任何項目都有循環或自我相依性，則部署會失敗 (例如，項目 A 參考項目 B 且項目 B 參考項目 A)。
  • 只有 Power BI 項目可以部署到不同容量區域中的工作區。 其他 Fabric 項目無法部署到不同容量區域中的工作區。

語意模型限制

  • 無法部署使用即時資料連線能力的資料集。

  • 不支援使用變化或自動日期/時間資料表的 DirectQuery 或複合連線模式語意模型。 如需詳細資訊，請參則＜如果我的語意模型使用變化或自動日期/時間資料表且為 DirectQuery 或複合連線模式，該怎麼辦？＞。

  • 在部署期間，如果目標語意模型使用即時連線，則來源語意模型也必須使用此連線模式。

  • 部署之後，即不支援 (從其部署到的階段) 下載語意模型。

  • 如需部署規則限制的清單，請參閱部署規則限制。

  • 使用原生查詢和 DirectQuery 的語意模型不支援部署，而且 DirectQuery 資料來源上會參與自動繫結。

  • 部署 Direct Lake 語意模型時，它不會自動繫結至目標階段中的項目。 例如，如果 LakeHouse 是 DirectLake 語意模型的來源，而且兩者都部署至下一個階段，則目標階段中的 DirectLake 語意模型將會繫結至來源階段中的 LakeHouse。 使用資料來源規則將它繫結至目標階段中的項目。 其他類型的語意模型會自動繫結至目標階段中的配對項目。

資料流程限制

  • 累加式重新整理設定不會複製到 Gen 1 中。

  • 當您將資料流程部署至空白階段時，部署管線會建立新的工作區，並將資料流程儲存體設定為 Fabric Blob 儲存體。 即使來源工作區已設定為使用 Azure Data Lake Storage Gen2 (ADLS Gen2)，仍會使用 Blob 儲存體。

  • 資料流程不支援服務主體。

  • 不支援部署 Common Data Model (CDM)。

  • 如需會影響資料流程的部署管線規則限制，請參閱部署規則限制。

  • 如果在部署期間重新整理資料流程，部署會失敗。

  • 在資料流程重新整理期間比較階段時，結果無法預測。

資料超市限制

  • 您無法使用敏感度標籤來部署資料超市。

  • 您必須是資料超市擁有者，才能部署資料超市。

相關內容

開始部署管線。