Skip to main content
Version: v1

使用 Power BI Push Dataset

您將了解​

  1. 如何使用 Power BI Push Dataset
  2. 如何設定排程更新
  3. 問題答案集 (FAQ)

Power BI Service 設定​

接下來幾個步驟，要在 Power BI Service 上設定好相關權限，並取得需要的資訊後續可填入到 Canner Enterprise 中．

步驟 1: 應用程式註冊​

  1. 應用程式註冊 > 建立一個應用程式，名字可為 Canner Power BI Push Dataset App．

powerbi-push-step1.png

  1. 點選建立好的 Canner Enterprise Power BI Push Dataset App > 複製好 「應用程式 (用戶端) 識別碼 (Application ID) 」與「 目錄 (租用戶) 識別碼 (Tenant ID)」，接下來的步驟會使用到．

powerbi-push-step2.png · 3. 點選憑證及祕密 > 在用戶端密碼區塊，新增用戶端密碼，可以在建立時設定較長 (24個月為佳)，以避免過期的問題。

powerbi-push-step3.png

  1. 複製 Canner Power BI Push Dataset secret 的值 (Application secret)．

powerbi-push-step4.png

注意

在這個步驟，請務必把 secret 的值複製起來，後面再回來看，會無法複製值．

步驟 2: 建立安全性群組​

  1. 進入 Azure Active Directory > 群組，並點選「新增群組」

powerbi-push-step5.png

在搜尋找 Azure Active Directory

powerbi-push-step6.png

在此頁面點選「新增群組」

  1. 在建立時於「成員」輸入剛剛建立好的應用程式 Canner Power BI Push Dataset App，群組類型選擇「安全性」

powerbi-push-step7.png

  1. 建立完成後如下圖:

powerbi-push-step8.png

步驟 3: 啟用 Power BI 服務系統管理員設定​

  1. 接著為了要讓這個服務主體 Canner Enterprise Power BI Push Dataset App 可以存取 Power BI 的 API，我們需要到 Power BI 的 Service 中開啟服務主體存取 API 的權限，此部分的設定僅能由 Power BI 的管理員開啟（與Azure 的管理員權限不同），如果要開啟 Power BI 的管理員權限請參考該文件: https://docs.microsoft.com/zh-tw/power-bi/admin/service-admin-role
powerbi-push-step9.png
  1. 透過指定「特定的安全性群組」，可以把對 API 的存取權限限縮在該安全群組中，接著後續我們便可以讓特定的工作區，透過添加該安全性群組來被 Power BI API 存取操作。

powerbi-push-step10.png

步驟 4: 將服務主體新增至您的工作區​

  1. 透過「建立工作區」建立一個需要藉由 Power BI API 存取的工作區 > 接著點選新建立好的工作區，並開啟工作區存取 ，如下為 test-power-bi:
powerbi-push-step11.png
注意

工作區存取與建立工作區 需要具有 Power BI Pro 產品的權限，該權限與 Power BI 管理員角色的權限不同，如下圖來自 Azure AD 中使用者 > 授權 (License) 的確認:

powerbi-push-step12.png

若沒有 Power BI Pro 產品權限，可透過這邊做設定，Power BI 服務中透過右上角的「管理入口網站 ( Admin Portal )」 > 使用者 > 前往 Microsoft 365 系統管理中心

powerbi-push-step12-2.png

並在開啟 Microsoft 接著點選已作用中的使用者，編輯使用者的授權與 App 授權，開啟 Power BI Pro（如果開啟並儲存就會進行刷卡）。

powerbi-push-step12-3.png

  1. 輸入在 Azure AD 中建立好的安全性群組:
powerbi-push-step13.png

如此屬於工作區，因為有了這個安全性群組 Canner Enterprise Power BI App ，便能讓隸屬在安全性群組中的 Canner Enterprise Power BI Push Dataset App 服務主體 ( Service Principal ) ，獲得該 Power BI 的 API 存取權限，並且能只作用在添加該群組的工作區中。

Canner Enterprise 設定 Push Dataset​

步驟 1: Create Power BI Service Principal Credential​

輸入前面步驟取得的

  1. Application ID (應用程式 (用戶端) 識別碼, 於應用程式註冊成功後，在資訊中取得)
  2. Application Secret (於應用程式註冊成功後，在憑證與秘密中取得)
  3. Tenant ID (目錄 (租用戶) 識別碼 (Tenant ID), 於應用程式註冊成功後，在資訊中取得)
powerbi-push-step14.png

步驟 2: Create Push Dataset​

  1. 點擊 create Create a Push Dataset

powerbi-push-step15.png

  1. 接著，會跳出表單，需填寫以下資訊
    1. Credential Name: 選擇上個步驟創建的 Power BI Service Principal Credential
    2. Power BI Workspace Name: 選擇推送到哪個 Power BI 上 workspace 中
    3. Materialized View: 選擇推送的 Materialized View
    4. Rebind Report: 一般狀況下，請勾選 此欄位，我們會一併更新報表綁定的資料集．
powerbi-push-step16.png

在選擇 Power BI Workspace Name 時，會跳出視窗讓使用者選擇 workspace．

powerbi-push-choose-ws-found.png

我的 Workspace 沒出現在列表中 ?

您可能會注意到，當你在 Power BI 新增群組工作區 ( Group Workspace ) 後，會無法馬上在 Canner Enterprise 上看見，這使因為 Power BI Rest API 不會得到最新的資料，如下圖，當你建立了一個 workspace，並按照前面的步驟授權給 Canner Power BI App．

當下看到的列表可能是空的 powerbi-push-choose-ws-not-found-1.png

需等待一段時間後才能生效，等待時間可能落在 20 - 40 分鐘左右． powerbi-push-choose-ws-not-found-2.png

  1. 步驟 3: 觀察 Power BI Push Dataset 的狀態，待 Status 變為 Synced 就代表資料推送成功

powerbi-push-step17.png

資料也會出現在 Power BI Service 上供使用 powerbi-push-step18.png

如何設定排程更新​

在產生 Materialized View 時，您若有選擇[排程更新](/v1/product/workspaces/sql/materialized_view# 1. 排程管理：)，在每次自動更新時，或是您在 Materialized View 頁面，點選 Refresh 做手動更新時，都會讓 Power BI Push Dataset 進入 Preparing 的狀態，代表 Materialized View 正在更新，且資料正在準備被推送到 Power BI Service．

狀態的意義

Power BI Push Dataset 一共有三種狀態

  1. Preparing: 代表 Materialized View 正在更新
  2. Syncing: 代表資料正在被傳送到 Power BI Service 上
  3. Synced: 代表資料完成傳送

問題答案集 (FAQ)​

1. 請問相關限制 ?​

  1. 一個資料集最多 75 個欄位
  2. 一個資料集最大容納 1,000,000 筆資料

2. 請問有時會看到 Power BI Push Dataset 失敗，出現 Failed 的提示，該如何處理 ?​

請您檢查以下幾個點:

  1. Power BI Service 上，Credential 上是否有刪掉，或是權限設定上有沒有做變更
  2. Power BI Service 上，Storage 是否達到 Workspace 的限制

若以上幾點都沒問題，且之前排程也都成功，那代表 Power BI Service API 因不穩定，丟錯誤回來，我們發現 Power BI Service API 服務並不是 100% 穩定，有時候會失敗，但請不用擔心，Canner Enterprise 會自動重新排程把資料再次推送過去．

3. 創建 Power BI Push Dataset -> 選擇 workspace 時，我的 Workspace 沒出現在選擇列表中 ? / 我的 Workspace 列表是空的 ?​

您可能會注意到，當你在 Power BI 新增群組工作區 ( Group Workspace ) 後，會無法馬上在 Canner Enterprise 上看見，這使因為 Power BI Rest API 不會得到最新的資料，如下圖，當你建立了一個 workspace，並按照前面的步驟授權給 Canner Power BI App．

當下看到的列表可能是空的 powerbi-push-choose-ws-not-found-1.png

需等待一段時間後才能生效，等待時間可能落在 20 - 40 分鐘左右． powerbi-push-choose-ws-not-found-2.png