RDL 交付筆記:用英文佔位文字標示 Dataverse 連線設定

| Power BI | 4 Reads

將連接 Dataverse 的 RDL 報表交付給其他單位時,可以把環境專屬值改成純英文(ASCII)佔位文字,讓接手者一眼看出要修改的位置,也避免留下原環境的主機名稱與個人帳號。

交付用連線字串

Data Source=REPLACE_WITH_DATAVERSE_HOST,5558;Initial Catalog=REPLACE_WITH_DATABASE_NAME;Encrypt=True;TrustServerCertificate=False;Authentication=Active Directory Interactive

搜尋 REPLACE_WITH_ 就能找到兩個待設定值。請將完整的佔位文字替換成實際值,再測試連線;中文或日文說明可另附於交付文件。

需要替換的兩個值

佔位文字填入內容
REPLACE_WITH_DATAVERSE_HOST目標 Dataverse 環境的完整主機名稱,不含 https://、結尾斜線或連接埠。範本已在後面附上 ,5558。
REPLACE_WITH_DATABASE_NAME目標環境的實際資料庫名稱,也就是 Initial Catalog 的值。

這兩處是連線字串中的環境替換點。若要直接沿用原報表查詢,目標環境也必須具有查詢所需的資料表與欄位。

互動式登入設定要保留

Authentication=Active Directory Interactive 指定 Microsoft Entra 互動式登入,支援多重要素驗證(MFA)。若要靠連線字串啟用此登入方式,就應保留這一項。依微軟的 Microsoft.Data.SqlClient 文件,此模式的 User ID 是選填的帳號提示,因此範本不預填個人帳號;實際使用的工具或驅動仍須支援省略此欄位。

在支援此設定的 Power BI Report Builder 中測試連線或預覽報表時,需要驗證便會啟動登入流程,讓接手者使用自己的帳號。已有有效登入狀態時,可能不會每次都要求重新登入。

本範例適用於本機互動式操作。對方仍須確認資料來源類型與驗證設定相容、Dataverse 的 TDS 端點已啟用、網路可連接 5558 埠,且登入帳號具備報表資料的讀取權限。可參考微軟的Dataverse SQL 連線說明及TDS 存取權限說明。

若發布至 Power BI Service,驗證會依服務端支援的 SSO/OAuth2 設定處理;不能只憑這段連線字串,保證每位使用者都會看到相同的登入視窗。詳見分頁報表資料來源文件。

This article was last edited at